Admin Panel · 참고 자료

Admin Portal 사용자 가이드

SmartphoneKey Admin Portal의 전체 문서 참고 자료 — 모든 섹션, 버튼, 워크플로를 다룹니다. 목차로 원하는 주제로 이동하거나 인터랙티브 둘러보기와 함께 활용하세요.

인터랙티브 둘러보기 열기
섹션 1

이 가이드에 대하여

이 가이드는 등록 단계부터 시작하여 SmartphoneKey Admin Portal을 사용하는 방법을 설명합니다. 내부 시스템 프로세스는 다루지 않고 포털 인터페이스에서 수행할 수 있는 작업만 다룹니다.

계정에 표시되는 섹션과 버튼은 역할과 권한에 따라 다릅니다. 아래에 설명된 기능의 일부만 보일 수도 있습니다.

섹션 2

계정 등록 및 첫 도어락 등록

관리자 또는 설치 기사가 제공한 등록 링크를 사용하세요.

단계별 안내

  1. registration page를 엽니다.
  2. 이메일 주소를 입력합니다.
  3. 비밀번호를 만듭니다.
  4. 도어락 일련번호를 입력합니다.
  5. 도어락과 함께 제공된 Matter 코드 또는 페어링 코드를 입력합니다.
  6. 주소 필드가 표시되면 주소를 입력합니다.
  7. Register 또는 Create Account를 클릭합니다.
  8. 등록이 완료된 후 포털이 자동으로 열리지 않으면 로그인합니다.

이제 계정이 첫 번째 시설(Entity)과 도어락에 연결되었습니다.

등록에 실패한 경우

다음 사항을 확인하세요:

  • 일련번호가 정확합니다.
  • Matter 코드 또는 페어링 코드가 정확합니다.
  • 도어락이 아직 다른 계정에 등록되어 있지 않습니다.
  • 비밀번호가 최소 요구 사항을 충족합니다.

문제가 계속되면 관리자에게 문의하세요.

섹션 3

Admin Portal에 로그인

  1. SmartphoneKey Portal 로그인 페이지를 엽니다.
  2. 이메일 주소와 비밀번호를 입력합니다.
  3. Sign In을 클릭합니다.
  4. 로그인한 후 SPK Portal을 엽니다.

Sign in with Google 또는 Sign in with Apple 버튼으로 한 번의 클릭만으로 로그인할 수도 있습니다. 이때 포털 계정과 동일한 이메일 주소를 사용하세요.

포털이 열려 있는 동안 세션이 만료되면 포털에서 다시 로그인하라는 메시지가 표시됩니다.

섹션 4

현재 시설 선택

Entity(시설)는 작업 대상이 되는 장치와 사용자가 속한 조직, 건물, 현장 또는 관리 구역입니다.

둘 이상의 시설에 접근할 수 있는 경우:

  1. 포털 헤더에서 시설 선택기를 찾습니다(오른쪽 상단에 현재 시설 이름과 도어락 수가 표시됨).
  2. 드롭다운 목록을 엽니다.
  3. 원하는 시설을 선택합니다.
  4. 페이지 데이터가 새로고침될 때까지 기다립니다.

시설 하나에만 접근할 수 있는 경우 헤더에 해당 시설 이름은 표시되지만 전환할 드롭다운은 없습니다.

사용자를 만들거나, 키를 할당하거나, 장치를 추가하거나, 로그를 검토하기 전에 항상 선택된 시설을 확인하세요.

섹션 5

기본 탐색

왼쪽 메뉴에는 고정된 최상위 섹션 세트가 있습니다. 권한에 따라 전체 또는 일부만 표시될 수 있습니다:

섹션용도
Dashboard요약 지표와 최근 활동을 확인합니다.
Entities시설과 해당 Local Admin을 만들고 관리합니다.
Users포털 사용자를 만들고 관리합니다.
Keys디지털 키, 실물 키, Wallet Key를 관리합니다.
Devices도어락, 허브, Matter 장치를 관리합니다.
Cameras카메라와 카메라 역할을 추가하고 관리합니다.
Logs활동 이벤트와 감사 기록을 검토합니다.
Settings프로필, 구독, 알림, 접근 요청, 결제를 관리합니다.

일부 섹션은 별도의 메뉴 항목 대신 페이지 상단의 탭으로 열립니다:

  • Keys → 키, 실물 키, Wallet Keys
  • Devices → 도어락, 허브, Matter
  • Cameras → 카메라, 카메라 역할
  • Logs → 활동, 감사
  • Settings → 프로필, 구독, 알림, 접근 요청, 결제

일부 계정에는 모든 섹션이나 탭이 표시되지 않을 수 있습니다.

구독에 포함되지 않은 섹션과 버튼은 자물쇠 아이콘과 함께 잠긴 상태로 표시됩니다. 잠긴 항목을 클릭하면 Settings → Subscription 페이지에서 누락된 패키지를 구매하도록 안내하는 창이 열립니다(23.2 참조). Matter 장치 탭, 카메라 및 로그 페이지, 게스트 키, 모바일 앱 또는 인터콤 접근 권한 부여가 이 방식으로 잠금 해제됩니다.

포털 헤더의 오른쪽 상단, 시설 선택기 옆에서 SPK Portal 인터페이스 언어를 변경할 수 있습니다. 언어 선택기를 열고 영어, 우크라이나어, 스페인어, 그리스어, 독일어, 프랑스어, 한국어, 일본어, 폴란드어 또는 포르투갈어를 선택하면 포털이 선택한 언어로 다시 로드됩니다. 그 옆의 Welcome Page 링크는 SmartphoneKey Portal 카드가 있는 포털 홈페이지로 돌아갑니다. 선택한 언어는 계정에 저장되므로 세션과 장치가 바뀌어도 인터페이스가 해당 언어로 유지됩니다. 라이트/다크 테마 스위치와 Admin Panel 버전은 왼쪽 메뉴 하단에 표시됩니다. 휴대폰에서는 언어 선택기가 사이드 메뉴 하단에도 표시되며, 하단 탐색 모음을 통해 가장 자주 사용하는 섹션에 한 번의 탭으로 접근할 수 있습니다. Menu 탭은 전체 메뉴를 열며, 이 메뉴는 왼쪽으로 스와이프하거나 장치의 뒤로 가기 제스처로 닫을 수도 있습니다.

섹션 6

대시보드

Dashboard는 선택한 시설의 현황을 한눈에 보여 줍니다.

대시보드에서 할 수 있는 작업:

  • 상단의 게이지 타일을 확인합니다: Total Locks(온라인, 오프라인, 아직 보고되지 않은 도어락), Matter Devices(볼 수 있는 모든 시설에 걸쳐 허브를 통해 커미셔닝된 모든 장치: 온라인, 오프라인, 아직 보고되지 않음), Total Keys(사용자가 보유한 키를 종류별로: Wallet Key, 실물 키, 게스트 키, 인터콤 접근) 및 Total Users(전체 접근 권한이 있는 사용자, 전화번호만으로 제한된 접근 권한이 있는 사용자, 비활성화된 사용자). 각 반원 링 가운데의 숫자는 합계이고, 색상 세그먼트마다 고유한 수치가 표시되며, 링 아래의 범례가 세그먼트의 이름을 나타내고, 타일 모서리의 화살표는 해당 페이지를 엽니다.
  • 탭 전환기(둘 이상의 보기를 사용할 수 있을 때 표시됨)를 사용하여 게이지 아래의 도어락, 카메라, Matter 패널 간에 전환합니다. Matter 패널은 연결된 허브 패널에 허브 합계를 표시합니다.
  • 최근 활동을 확인합니다.
  • 올바른 시설에서 작업 중인지 확인합니다(대시보드에 시설 이름과 코드가 표시됨).
  • 역할에 따라 사용할 수 있는 경우 빠른 작업 버튼(접근 권한 부여, 게스트 키, 접근 권한 제거)과 빠른 접근 바로 가기를 사용합니다.

시설을 전환하면 대시보드가 자동으로 새로고침됩니다.

섹션 7

시설 관리

Entities를 열어 조직, 건물, 현장 또는 기타 관리 구역을 만들고 관리합니다. 시설은 카드(그리드 보기) 또는 행(목록 보기)으로 표시되며 필터링, 검색, 정렬할 수 있습니다.

7.1 시설 만들기

  1. Entities를 엽니다.
  2. Create Entity를 클릭합니다.
  3. 시설 이름을 입력합니다.
  4. 필요한 경우 설명을 추가합니다.
  5. 필요에 따라 Add Local Admin 아래에 초기 Local Admin의 이메일 주소를 입력합니다.
  6. 필요에 따라 해당 Local Admin에게 이전할 Wallet Key 수를 입력합니다.
  7. Create를 클릭합니다.

시설 코드

시설 카드와 행에 표시되는 시설 코드는 시설 이름에서 자동으로 생성됩니다(대문자와 숫자로 구성되며 고유하게 만들어짐). 만든 후에는 변경할 수 없습니다.

7.2 시설 편집

  1. Entities를 엽니다.
  2. 원하는 시설을 찾습니다.
  3. 설정(톱니바퀴) 아이콘을 클릭하거나 카드 메뉴를 열고 Edit details를 선택합니다.
  4. 이름 또는 설명을 업데이트합니다.
  5. Save Changes를 클릭합니다.

7.3 시설 삭제

  1. Entities를 엽니다.
  2. 원하는 시설을 찾습니다.
  3. 카드 메뉴를 열고 Delete entity를 선택합니다.
  4. 확인 메시지를 주의 깊게 읽습니다.
  5. 삭제를 확인합니다.

시설에 도어락이 남아 있는 동안에는 삭제할 수 없습니다. 먼저 도어락을 제거하거나 다른 곳으로 재할당하세요.

7.4 시설 정보 창

시설 이름을 더블 클릭(휴대폰에서는 두 번 탭)하면 Entity Information 창이 열립니다. 이 창은 해당 시설에 관한 모든 정보를 읽기 전용으로 요약해 보여 줍니다. 같은 창은 시설 행이나 카드의 정보 아이콘, 행 또는 카드 메뉴(Entity Information), 요약 표의 정보 아이콘(7.5 참조)에서도 열립니다.

  • 헤더 — 시설의 모노그램, 이름과 코드, 활성 또는 비활성 상태, 선택된 시설인 경우 CURRENT 표시, 하위 시설인 경우 상위 시설, 그리고 설명.
  • 요약 타일 — 사용자, 발급된 키, 도어락, Matter 장치, 카메라를 한눈에 보여 주며, 각각 가장 유용한 세부 정보(여유 키, 온라인 도어락 등)를 함께 표시합니다.
  • 키 — 사용자가 현재 보유한 키를 유형별(Wallet, 실물, 게스트, QR 인터콤)로 색상 막대에 나누어 표시하고, 여유 풀, 30일 이내에 만료되는 키, 만료 및 취소된 키, 공유(여러 도어락) 게스트 키도 표시합니다. 회사에서 Expiring Wallet Keys를 켠 경우(Odoo: Configuration > Settings > Portal Interface, 기본값은 꺼짐) 이 섹션에는 곧 만료되는 Wallet Key도 보유자 이름, 이메일, 도어락, 만료일과 함께 나열됩니다.
  • 사용자 — 전체 접근, 제한된 접근(전화번호만), 비활성화된 사용자로, 사용자 페이지와 동일하게 구분됩니다.
  • 관리자 — 소유자, 모든 Local Admin(Wallet Key 잔액 포함), 이 시설 범위의 관리 역할을 보유한 모든 사용자를 연락처 및 역할 칩과 함께 표시합니다. 카드의 ID 카드 아이콘은 사용자 페이지에서 해당 사용자의 사용자 정보 창을 엽니다. 이름은 관리하는 시설에 대해서만 표시되며, 그 외의 시설에서는 이 섹션에 수만 표시됩니다.
  • 도어락 — 각 도어락의 온라인, 오프라인 또는 연결 안 됨 상태, 발급된 키 수, 프로그래머 리더 및 Matter 연결 표시.
  • 장치 및 카메라 — Matter 허브와 장치(온라인, 오프라인, 아직 보고되지 않음), 카메라(활성, 비활성화됨), 카메라 역할. 해당 페이지를 열 수 있는 경우에만 표시됩니다.
  • 최근 활동 — 최근 14일 동안 시설 도어락에서 발생한 이벤트를 하루에 막대 하나씩 표시하는 차트(막대를 가리키면 날짜와 수가 표시됨)와 그 뒤에 최신순으로 정렬된 최근 이벤트 5개를 관련 사용자와 함께 표시합니다.
  • 세부 정보 — 코드, 상위 시설, 하위 시설, 시설을 만든 시각과 만든 사람.

섹션 제목을 클릭하면 해당 섹션이 접히며, 이 선택은 브라우저에 저장되어 다음에 여는 시설에도 적용됩니다. 하단의 Download PDF는 창 전체를 사용 언어의 PDF 보고서로 저장하므로 건물 소유자에게 바로 보낼 수 있습니다. 이 창 자체는 아무것도 변경하지 않습니다. 하단의 Add user, Edit, Open은 행 버튼과 동일한 작업으로 이어집니다.

7.5 시설 요약 표

검색 상자 옆의 보기 전환(목록 아이콘/표 아이콘)을 사용하면 시설 행 대신 볼 수 있는 모든 시설을 하나의 표로 표시할 수 있습니다. 각 줄에는 시설의 상태, 사용자(전체/제한 구분 포함), 발급된 키(유형 막대 포함)와 여유 키, 도어락(온라인 수 포함), Matter 장치와 카메라(해당 페이지를 열 수 있는 경우), 관리자, 최근 14일 동안 도어락에서 발생한 이벤트 수가 표시되며, 마지막 줄은 열의 합계를 보여 줍니다.

열 제목을 클릭하면 해당 열을 기준으로 정렬되고, 다시 클릭하면 순서가 반대로 바뀝니다. 필터 칩과 검색 상자는 행을 좁히는 것과 같은 방식으로 표를 좁힙니다. 줄을 더블 클릭하거나 정보 아이콘을 클릭하면 시설 정보 창이 열립니다. 포털은 마지막으로 사용한 보기를 기억합니다.

섹션 8

Local Admin 관리

Local Admin은 특정 시설 내에서 사용자를 관리하고 할당된 Wallet Key를 배포할 수 있습니다.

Local Admins는 별도의 페이지가 아닌 시설 편집 창에서 관리합니다.

이 섹션은 시설 소유자뿐 아니라 해당 시설을 관리할 수 있는 모든 관리자가 사용할 수 있습니다. Local Admin은 다른 Local Admin을 추가할 수 없습니다.

Local Admin이 할 수 있는 일은 회사 관리자가 백오피스의 Configuration → Role Configurator → Local Admin → Company settings에서 회사별로 좁힐 수 있습니다: Local Admin이 허브와 Matter 기기를 추가·관리할 수 있는지, 카메라를 다른 사람과 공유할 수 있는지, 그리고 각 Local Admin이 시설에서 몇 명의 사용자를 생성할 수 있는지를 정합니다. 이런 설정이 없으면 Local Admin은 다른 시설 관리자와 마찬가지로 허브, Matter 기기, 카메라 접근을 관리하고 제한 없이 사용자를 생성합니다. 이 설정은 해당 회사의 시설에만 적용되며, 다른 관리 역할도 함께 가진 계정은 그 역할의 권한을 그대로 유지합니다.

8.1 Local Admin 추가

  1. Entities를 엽니다.
  2. 원하는 시설을 편집용으로 엽니다(톱니바퀴 아이콘 또는 Edit details).
  3. Manage Local Admins 섹션으로 스크롤합니다.
  4. Add Local Admin에서 기존 시설 구성원을 선택하거나 새 이메일 주소를 입력합니다.
  5. 필요에 따라 이전할 Wallet Key 수를 입력합니다.
  6. Add를 클릭합니다.

이메일 주소가 기존 사용자의 것이 아니면 해당 사용자는 초대를 받습니다. 시설을 만드는 동안 초기 Local Admin을 추가할 수도 있습니다(7.1 참조).

8.2 Local Admin에게 Wallet Key 추가 이전

여유 잔액에서 Local Admin에게 Wallet Key를 이전(Transfer Wallet Keys)하려면 이 기능을 사용합니다.

  1. 시설을 편집용으로 엽니다.
  2. Manage Local Admins에서 원하는 Local Admin을 찾습니다.
  3. 해당 Local Admin 옆의 Wallet Keys 필드에 수량을 입력합니다.
  4. Transfer를 클릭합니다.

8.3 Local Admin 권한 제거

  1. 시설을 편집용으로 엽니다.
  2. Manage Local Admins에서 원하는 Local Admin을 찾습니다.
  3. 제거 버튼을 클릭합니다.
  4. 작업을 확인합니다.

Local Admin 권한을 제거해도 사용자 계정은 삭제되지 않습니다.

섹션 9

사용자 관리

Users를 열어 시설 내의 포털 사용자를 관리합니다. 사용자는 검색 가능한 표에 표시되며, 검색 상자는 사용자의 이름, 이메일, 전화번호, 주소, 차량 번호판과 일치하는 항목을 찾습니다. All / Active / Deactivated 칩으로 상태별로 필터링하고(페이지는 Active가 선택된 상태로 열림), 정렬 선택기로 목록을 이름, 주소, 도어락 접근, 최신 계정 순으로 정렬합니다. 도어락 접근 순으로 정렬하면 선택기 옆에 화살표가 나타나는데, 이 화살표는 목록이 도어락이 많은 순인지 적은 순인지 보여 주며, 클릭하면 순서가 반대로 바뀝니다. 사용자 행을 더블 클릭(두 번 탭)하면 읽기 전용 User Information 창이 열립니다(9.8 참조). Address 및 License Plates 열은 나열된 사용자 중 한 명 이상에게 주소나 차량 번호판이 있는 경우에만 표시됩니다. 휴대폰에서는 표에 필수 열(이름, 기본 연락처, 도어락 접근, 작업)만 표시되며, 나머지 세부 정보는 사용자 정보 창이나 사용자 편집 시 확인할 수 있습니다.

시설에 추가된 내부 팀 구성원(회사 직원 계정)은 같은 표에 Internal 배지와 함께 표시됩니다. 다른 사용자와 마찬가지로 도어락 접근과 키를 관리할 수 있지만, 계정 자체(편집, 비활성화, 다시 활성화)는 SmartphoneKey 관리자만 변경할 수 있으며 다른 관리자에게는 해당 작업이 숨겨집니다.

본인의 계정도 목록에 표시되므로 자신의 도어락 접근과 키를 확인하고 관리할 수 있습니다. 이 페이지에서 본인의 계정을 편집하거나 비활성화할 수는 없으며, 본인의 행에서는 해당 작업이 숨겨집니다.

9.1 사용자 만들기

  1. Users를 엽니다.
  2. New User를 클릭합니다.
  3. 필요한 경우 프로필 사진을 추가합니다(PNG 또는 JPG, 최대 6 MB).
  4. 사용자의 전체 이름을 입력합니다.
  5. 사용자의 이메일 주소를 입력합니다(로그인 이메일이 됨).
  6. 필요한 경우 전화번호를 입력합니다. 번호 앞의 드롭다운에서 국가를 선택한 다음 국내 번호를 입력합니다. 국가는 두 글자 코드와 국가 번호로 나열되며(`UA (+380)`, `DE (+49)`, 하나의 코드를 공유하는 미국과 캐나다는 `US/CA (+1)`), 인터페이스 언어에 해당하는 국가가 먼저 표시되고 그 뒤에 나머지 국가가 코드의 알파벳 순으로 표시됩니다. 번호 필드는 숫자만 허용하며 선택한 국가에서 사용하는 번호 길이에서 입력이 멈춥니다. 자릿수가 부족한 동안에는 필드 아래에 필요한 자릿수를 알려 주는 메시지가 표시됩니다.
  7. 필요한 경우 주소/세대를 입력합니다.
  8. 필요한 경우 차량 번호판을 하나 이상 추가합니다.
  9. 시설을 선택합니다.
  10. Create User를 클릭합니다.

이메일 주소가 이미 다른 시설이나 다른 회사의 사용자에게 속해 있으면 두 번째 계정을 만들지 않고 그 사람을 선택한 시설(및 해당 회사)에 추가하며, 창에 그 내용이 표시됩니다.

새 사용자가 환영 이메일을 받을지 여부는 Settings의 Defaults 탭("Email on user welcome" 동작)에서 제어하며, 이 대화 상자에는 확인란이 없습니다.

Enterprise 및 Community Manager 구독에서는 이 창에 CSV 또는 Excel 파일에서 여러 사용자를 한 번에 만들 수 있는 Import Users 버튼도 표시됩니다(9.7 참조).

9.2 사용자 편집

  1. Users를 엽니다.
  2. 원하는 사용자를 찾습니다.
  3. 편집(연필) 작업을 클릭하거나 사용자 정보 창의 Edit User 버튼을 클릭합니다(9.8 참조).
  4. 필요한 필드를 업데이트합니다.
  5. Entities 드롭다운에서 시설 구성원 자격을 검토합니다(시설을 하나 이상 선택). 시설을 하나만 관리하는 경우 드롭다운은 숨겨집니다.
  6. 필요한 경우 주소, 차량 번호판 또는 프로필 사진을 업데이트합니다.
  7. Save Changes를 클릭합니다.

사용자는 하나 이상의 시설에 연결되어 있어야 합니다.

9.3 사용자 검색

검색 필드를 사용하여 다음 기준으로 검색합니다:

  • 이름
  • 이메일
  • 전화번호
  • 차량 번호판

긴 목록은 페이지당 50명씩 표시되며 페이지 링크는 표 아래에 있습니다. 검색, 상태 칩, 정렬은 화면에 표시된 페이지뿐 아니라 선택한 시설의 모든 사용자를 항상 대상으로 하며, 새로 검색하면 결과의 첫 페이지로 돌아갑니다.

검색어에 숫자가 포함되면 정확히 그 호수에 거주하는 사용자가 먼저 나열되고, 그다음에 주소에 그 숫자가 포함된 사용자(7을 검색하면 17호, 37호, 75호보다 7호가 먼저 표시됨), 마지막으로 전화번호나 차량 번호판으로만 일치한 사용자가 나열됩니다. 건물에서는 보통 호수가 찾고자 하는 대상이기 때문입니다. 정렬 선택기에서 선택한 순서는 각 그룹 내에서 계속 적용됩니다.

Physical Keys 열은 사용자가 보유한 서로 다른 카드 수를 셉니다. 세 개의 도어락에 추가된 카드 하나는 한 번으로 계산되고, 같은 문에 대한 별도의 카드 두 개는 두 번으로 계산됩니다. 이 열은 Settings → Defaults에서 Show the Physical Keys column on the Users page를 켠 경우에만 표시되며(23.5 참조), 기본값은 꺼짐입니다.

9.4 사용자 비활성화

사용자가 더 이상 활성 접근 권한을 가져서는 안 될 때 이 작업을 사용합니다.

  1. Users를 엽니다.
  2. 원하는 사용자를 찾습니다.
  3. 비활성화 작업을 클릭합니다.
  4. 확인 메시지를 읽습니다(비활성화하면 도어락 접근 권한이 제거되고, 포털 로그인이 비활성화되며, SmartKey 사용자가 일시 중지됨).
  5. 필요에 따라 사유를 입력합니다.
  6. 작업을 확인합니다.

9.5 사용자 다시 활성화

  1. Users를 엽니다.
  2. 비활성화된 사용자를 찾습니다.
  3. Reactivate User를 클릭합니다.
  4. 작업을 확인합니다.

9.6 제한 사용자 만들기(전화번호만, 로그인 없음)

Limited User(제한 사용자)는 포털 로그인이 없는 전화번호 기반의 간소화된 신원으로, 전체 계정을 제공하지 않고 키만 발급하면 되는 사용자에게 사용합니다. 사용자 표에는 이러한 항목의 이메일 열에 Limited access가 표시됩니다.

  1. Users를 열고 New User를 클릭합니다.
  2. 사용자의 전체 이름을 입력합니다.
  3. 전화번호 필드 옆의 Just phone number를 켭니다.
  4. 전화번호를 입력합니다(필수 — 이 번호가 사용자의 식별자임). 국가 번호는 번호 앞의 드롭다운에서 선택하며, 일반 사용자와 동일한 국가별 길이 확인이 적용됩니다(9.1 참조).
  5. 필요에 따라 이메일 주소를 입력합니다.
  6. 필요에 따라 주소/세대를 입력합니다.
  7. 시설을 하나 이상 선택합니다(시설을 하나만 관리하는 경우 자동으로 선택되고 필드는 숨겨짐).
  8. Create Limited User를 클릭합니다.

제한 사용자에게도 일반 사용자와 동일한 Edit, Give Access, Deactivate/Reactivate 작업이 있으며(9.2, 9.4, 9.5, 10 섹션 참조), 해당 행의 Lock Access 버튼은 동일한 도어락별 접근 팝업(10 섹션)을 엽니다. 다만 포털 로그인이 없으므로 Wallet Key 버튼은 없습니다. 마법사를 통해 접근 권한을 부여할 때는 Physical Key와 QR Intercom이 제공됩니다. 전화번호는 같은 방식(편집 작업)으로 편집하지만, 영구적인 식별자이므로 변경할 수는 없습니다.

제한 사용자를 전체 사용자로 전환하기. 편집 작업을 열고 이메일 주소를 부여합니다. 저장하면 제한 사용자가 아니라 해당 주소로 로그인할 수 있는 일반 포털 사용자가 됩니다. 신원은 그대로 유지되며(이미 발급된 모든 키, 차량 번호판, 도어락 권한이 계속 유효함) 전화번호도 그대로 남습니다. 해당 이메일 주소는 다른 사용자나 연락처가 이미 사용 중이어서는 안 되며, 이제 로그인이 생기므로 전환은 구독의 사용자 한도에 포함됩니다. 다른 새 포털 사용자와 마찬가지로 아직 비밀번호가 없으므로 로그인 페이지의 Reset Password로 직접 비밀번호를 설정합니다. 해당 안내가 담긴 환영 이메일을 받을지 여부는 Settings의 Defaults 탭에서 제어합니다.

9.7 파일(CSV 또는 Excel)에서 사용자 일괄 만들기

Enterprise 및 Community Manager 구독에서는 사용자 만들기 창에 여러 사용자를 한 번에 만들 수 있는 Import Users 버튼이 표시됩니다. 일반 CSV 파일과 Excel 통합 문서(`.xlsx`, 첫 번째 워크시트)를 모두 사용할 수 있습니다.

  1. Users를 열고 New User를 클릭합니다.
  2. Import Users를 클릭합니다.
  3. 대상 시설을 선택합니다.
  4. Example CSV 또는 Example Excel을 클릭하여 지원되는 모든 열이 나열된 파일을 다운로드합니다.
  5. 사용자당 한 행씩 채운 다음 Choose CSV or Excel file로 파일을 업로드합니다.
  6. 필요에 따라 이메일이 이미 존재하는 경우 기존 사용자를 업데이트하는 옵션을 켭니다.
  7. Import Users를 클릭하고 행별 결과를 검토합니다.

가져오기가 완료되면, 추가되지 않은 행이 하나라도 있으면 Import report 창이 자동으로 열립니다. 결과 개수 옆의 Import report 버튼으로도 열 수 있습니다. 보고서에는 각 행의 파일 내 번호, 사람 이름, 이메일 또는 전화번호, 결과(Created, Updated, Skipped 또는 Failed), 그리고 행이 건너뛰어졌거나(사용자가 이미 존재함) 실패한 전체 사유가 표시됩니다. Only rows that were not added를 끄면 생성 및 업데이트된 행도 볼 수 있으며, Download the report (CSV)로 사본을 보관할 수 있습니다.

만들어진 포털 사용자는 Settings의 Defaults 탭("Email on user welcome" 동작)에 따라 환영 이메일을 받습니다.

파일 열:

  • name — 모든 행에 필수입니다.
  • email — 전체 포털 사용자를 만듭니다(로그인 이메일이 됨). 전화번호가 없는 행도 괜찮으며, 사용자는 전화번호 없이 만들어집니다.
  • phone — 포털 사용자에게는 선택 사항입니다. 전화번호가 있고 이메일이 없는 행은 제한 사용자를 만듭니다(9.6 참조). 모든 번호는 국가 코드와 앞의 `+`를 포함한 국제 형식으로 적으세요(예: `+380501234567`). 국가 코드가 없는 번호는 거부됩니다. Excel에서는 `+`가 유지되도록 전화번호 열을 텍스트 형식으로 지정하세요.
  • address — 선택 사항으로, 사용자 카드에 표시되는 주소/세대 메모입니다(9.1 참조).
  • license_plate — 선택 사항이며 포털 사용자 전용입니다. 여러 번호판은 `;`로 구분합니다.

가져오기당 최대 500행이 처리됩니다. 실패한 행(예: 잘못된 이메일 또는 전화번호)은 개별적으로 보고되며 파일의 나머지 부분 처리를 중단하지 않습니다.

이름에는 모든 문자(예: 키릴 문자)를 사용할 수 있습니다. Excel에서 파일을 편집하는 경우 가장 안전한 방법은 Excel 예제 파일을 기반으로 작업하고 `.xlsx`로 업로드하는 것입니다. Excel의 일반 CSV 형식은 라틴 문자가 아닌 글자를 물음표로 바꾸며, 이러한 행은 가져오는 동안 거부됩니다. CSV를 사용하려면 CSV UTF-8로 저장하세요.

9.8 사용자 정보 창

사용자 행을 더블 클릭(휴대폰에서는 두 번 탭)하면 User Information 창이 열립니다. 이 창은 해당 사용자에 관한 모든 정보를 읽기 전용으로 요약해 보여 줍니다:

  • 헤더 — 프로필 사진, 이름, 이메일과 전화번호(탭 가능), 상태 칩: 활성 또는 비활성화됨, 제한된 접근, 내부, 일반 사용자 이상의 역할(예: Local Manager와 적용되는 시설), 사용자에게 구독 패키지가 있는 경우 해당 패키지, 그리고 Local Admin의 경우 본인의 Wallet Key 잔액. 이름 옆의 봉투 아이콘은 이 사용자에게 초대 이메일이 발송되었는지 보여줍니다. 아직 발송되지 않았으면 흐리게, 발송되었으면 진하게 표시되며(마우스를 올리면 발송 시각이 보입니다), 클릭하면 초대를 다시 보냅니다. 이메일이 없는 사용자에게는 아이콘이 표시되지 않습니다.
  • 프로필 — 주소/세대, 시설 구성원 자격, 계정을 만든 시각과 만든 사람, 마지막 포털 로그인, 차량 번호판, SmartKey 상태.
  • Wallet Key — 키의 상태와 만료일, 발급 시각과 발급자, 키로 열 수 있는 모든 도어락과 각 접근 권한이 부여된 날짜 및 부여자.
  • 실물 키 — 각 카드의 번호, 일련번호, 기술, 발급 시각과 발급자, 해당 도어락. 제목에는 해당 사용자가 보유한 서로 다른 카드의 수가 표시됩니다. 카드 한 장은 여러 도어락을 열더라도 한 번만 계산됩니다.
  • 앱 및 인터콤 접근 — 모바일 앱 또는 QR 인터콤 접근이 켜져 있는 도어락과 각각의 부여자 및 부여 시각.
  • 카메라 — 사용자가 소유한 카메라와 사용자가 속한 카메라 역할(실시간 스트리밍 권한은 카메라 자체에서 관리되며 여기에는 나열되지 않음).
  • Matter 장치 — 사용자에게 연결된 스마트 장치와 허브 및 연결 날짜.
  • 최근 활동 — 사용자의 최근 도어락 이벤트 5개를 최신순으로 표시합니다. View all activity는 이 사용자로 이미 필터링된 활동 페이지를 엽니다(이메일이 있는 사용자에게 제공됨).

섹션 제목을 클릭하면 해당 섹션이 접혀 제목만 남고, 다시 클릭하면 펼쳐집니다. 창은 접은 내용을 기억하므로 다음 사용자를 열면 같은 섹션이 이미 접혀 있어, 실제로 작업하는 부분만 남길 수 있습니다. 이 선택은 본인에게만 적용되고 브라우저에 저장되며, 다른 사람이 보는 내용에는 영향을 주지 않습니다.

이 창은 순수하게 정보 제공용이며 창 안의 어떤 것도 접근 권한을 변경하지 않습니다. 하단의 Edit User로 편집 대화 상자로 이동하거나(편집할 수 있는 계정에만 표시됨), 이전처럼 Lock Access 팝업에서 도어락별 접근을 관리합니다(10 참조). 이 창은 편집 대화 상자가 열리지 않는 비활성화된 사용자와 내부 사용자에 대해서도 열립니다.

섹션 10

사용자의 도어락 접근 관리

Users 섹션에서는 사용자의 도어락별 접근 권한을 모두 하나의 팝업에서 관리합니다.

  1. Users를 엽니다.
  2. 원하는 사용자를 찾습니다.
  3. Lock Access 열의 버튼을 클릭합니다. 이 버튼에는 해당 사용자가 현재 열 수 있는 도어락 수가 표시됩니다(예: 3 locks).

시설의 모든 도어락이 나열된 팝업이 열리므로(휴대폰에서는 전체 화면), 사용자가 아직 접근 권한이 없는 도어락에도 권한을 부여할 수 있습니다. 각 도어락 행에는 네 개의 버튼이 있습니다:

  • Card — Wallet Key(휴대폰 지갑에 저장되는 디지털 키).
  • Key — 실물 NFC 키.
  • Phone — 모바일 앱 접근.
  • Camera — QR 인터콤 접근.

눌린 상태로 표시된 버튼은 사용자가 현재 해당 도어락에 그 종류의 접근 권한을 보유하고 있음을 뜻합니다. 눌리지 않은 버튼을 클릭하면 해당 접근 권한이 부여되고, 눌린 버튼을 클릭하면 권한이 제거됩니다.

10.1 Wallet Key(카드 버튼)

  • 사용자에게 아직 키가 없으면 새 Wallet Key를 할당하고 이메일로 보내겠다는 대화 상자가 표시됩니다.
  • 사용자에게 이미 다른 도어락에 활성 Wallet Key가 있으면 같은 키가 이 도어락에 추가됩니다.
  • 눌린 카드 버튼을 클릭하면 해당 도어락에서 Wallet Key가 취소됩니다.

제한(전화번호만) 사용자에게는 Wallet Key를 사용할 수 없으므로 카드 버튼이 표시되지 않습니다.

10.2 실물 키(키 버튼)

  • 사용자에게 이미 활성 실물 키가 있으면 같은 키를 이 도어락에 추가할지, 아니면 새 키를 프로그래밍할지 묻는 대화 상자가 표시됩니다. 사용자가 실물 키를 여러 개 보유한 경우 대화 상자에 각 키의 짧은 번호, 카드 유형, 이미 열 수 있는 도어락이 함께 나열되며, 하나 이상의 키를 선택하거나 Select all을 누른 다음 Add Existing Key를 클릭합니다. 선택한 키가 모두 이 도어락에 추가됩니다.
  • 새 키를 프로그래밍하면 도어락과 사용자가 이미 선택된 상태로 Physical Key Wizard가 열립니다(14 섹션 참조).
  • 눌린 키 버튼을 클릭하면 해당 도어락의 실물 키에 대한 취소 대화 상자가 열립니다. 도어락에 사용자의 실물 키가 여러 개 있으면 한 번에 하나씩 취소되며, 대화 상자에 취소될 키의 UUID가 표시됩니다.

10.3 모바일 앱 접근(전화 버튼)

  • 전화 버튼을 클릭하면 모바일 앱 접근 권한이 부여되고, 눌린 버튼을 클릭하면 확인 후 권한이 취소됩니다.
  • Professional 및 Enterprise 구독에서는 사용자에게 아직 해당 도어락의 키가 없어도 권한을 부여할 수 있습니다. 다른 요금제에서는 키가 할당될 때까지 버튼이 비활성화된 상태로 유지됩니다.

10.4 QR 인터콤 접근(카메라 버튼)

  • 카메라 버튼을 클릭하면 QR 인터콤 접근 권한이 부여되고, 눌린 버튼을 클릭하면 확인 후 권한이 취소됩니다.
  • 인터콤 통화는 앱에서 응답하므로, QR 인터콤 접근 권한을 부여하면 사용자에게 모바일 앱 접근 권한이 없는 경우 함께 부여됩니다. 나중에 인터콤 권한을 제거해도 모바일 앱 접근 권한은 그대로 유지됩니다.
  • Professional 및 Enterprise 구독에서는 사용자에게 아직 해당 도어락의 키가 없어도 권한을 부여할 수 있습니다. 다른 요금제에서는 키가 할당될 때까지 버튼이 비활성화된 상태로 유지됩니다.

Managed Access Control Service(파트너) 요금제에서는 QR 인터콤 접근 권한을 부여하려면 활성 Resident Digital Access Package 추가 기능이 필요합니다. 구매하기 전까지는 부여 버튼이 숨겨집니다. 추가 기능 구매 방법은 23.2를 참조하세요. 기존 접근 권한 취소는 항상 가능합니다.

SmartKey 기록이 포털과 일치하지 않아 모바일 앱 또는 QR 인터콤 접근 권한 부여나 취소에 실패하면 포털이 자동으로 다시 동기화하고 재시도합니다. 그래도 실패하면 "Oops, something went wrong — please contact your administrator" 메시지가 표시되고 실패 내용이 감사 기록에 남습니다.

섹션 11

디지털 키 관리

Keys(키 탭)를 열어 디지털 키를 할당, 업데이트, 공유 또는 취소합니다. 키는 카드로 표시됩니다.

각 키는 카드로 표시됩니다. 앞면에는 도어락, 키 종류, 번호, 카드 소지자, 유효 기간이 표시되며, 카드를 탭하면 뒤집힙니다. 뒷면에는 키 상태, 보유자의 이메일 또는 전화번호와 그 아래에 연락처에 주소가 있는 경우 보유자의 주소, 모바일 및 인터콤 접근 칩, Apple / Google wallet 링크, Lock Details 및 User Details 버튼(각각 Devices → Locks의 Lock Details(15.14)와 Users의 사용자 정보 창(9.8)과 완전히 동일한 창을 엶), 그리고 작업(메뉴, 게스트 키의 경우 Update / Delete, 인터콤 접근의 경우 Revoke)이 표시됩니다. 뒷면이나 모서리의 작은 화살표를 탭하면 카드가 다시 앞면으로 돌아갑니다. 앞면 왼쪽 상단의 확인란은 카드를 뒤집지 않고 일괄 작업을 위해 키를 선택합니다. 앞면에서 도어락 이름이 잘려 표시되면 마우스를 올려 전체 이름을 확인할 수 있습니다.

11.1 키 목록 필터링

필터를 사용하여 다음 기준으로 목록을 좁힙니다:

  • 도어락
  • 상태(활성, 만료됨, 취소됨, 사용 가능)
  • 유형(Wallet Key, 실물 키, 인터콤, 게스트 키)

검색 필드를 사용하여 키 UUID, 사용자 이름, 이메일, 전화번호 또는 주소로 검색합니다.

검색어에 숫자가 포함되면 정확히 그 호수에 거주하는 사용자의 키가 먼저 나열되고, 그다음에 주소에 그 숫자가 포함된 키(7을 검색하면 17호, 37호, 75호보다 7호가 먼저 표시됨), 마지막으로 다른 필드로만 일치한 키가 나열됩니다. 건물에서는 보통 호수가 찾고자 하는 대상이기 때문입니다.

11.2 키 할당(연결)

  1. Keys를 엽니다.
  2. Bind Key를 클릭합니다. 키 할당 마법사가 열립니다.
  3. 1단계 — 키로 열어야 하는 모든 도어락을 선택합니다. 목록이 길면 Select all 또는 Clear를 사용합니다.
  4. 2단계 — 기존 사용자를 선택하거나 Create User를 클릭하여 사용자를 추가합니다. 사용자 필드는 검색 상자입니다. 이름, 이메일 또는 전화번호를 입력하기 시작하면 아래 목록이 입력에 따라 좁혀지며, 마우스 또는 화살표 키와 Enter로 사람을 선택합니다. Show address를 선택하면 목록에서 각 사람의 주소가 이름 위에 표시되고 주소로도 검색할 수 있으며, 이때 주소 일치 항목이 이름 일치 항목보다 먼저 표시됩니다. Show address의 초기 상태는 Settings → Defaults를 따릅니다(23.5 참조).
  5. 3단계 — 키 유형을 선택합니다:
    • Wallet Key
    • Physical Key
    • QR Intercom
  6. 선택한 키 유형에 표시되는 옵션을 완료합니다.
  7. 마지막 버튼을 클릭합니다(키 유형에 따라 Assign Key, Grant Access 또는 Continue to Programming).

Limited User(제한 사용자, 9.6 참조)의 경우 2단계에서 일반적으로 이메일이 표시되는 자리에 전화번호가 표시되고, 3단계에서는 Physical Key와 QR Intercom만 제공됩니다. 제한 사용자에게는 포털 로그인이 없으므로 Wallet Key는 사용할 수 없습니다.

여러 도어락을 한 번에 선택

둘 이상의 도어락을 선택하면 모든 도어락을 열 수 있는 Wallet Key 하나가 발급되므로, 사용자는 문마다 하나씩이 아니라 패스 하나만 받습니다. 이 방식으로는 Wallet Key만 발급할 수 있으며, Physical Key와 QR Intercom은 도어락별 옵션이므로 여러 도어락을 선택한 동안에는 숨겨집니다.

한 도어락에서 완료할 수 없어도 나머지는 계속 진행됩니다. 마법사는 열린 채로 도어락별 결과(추가됨, 이미 이 키가 있음, 사유와 함께 실패)를 표시하므로 조용히 실패하는 일은 없습니다. 키 이메일은 도어락마다 하나씩이 아니라 전체 배치에 대해 한 번만 전송됩니다.

11.3 Wallet Key 할당

모바일 Wallet 접근에 이 옵션을 사용합니다.

  1. 마법사에서 Wallet Key를 선택합니다.
  2. 포털이 Wallet 링크를 자동으로 이메일로 보내도록 하려면 Send email with key를 켭니다.
  3. Assign Key를 클릭합니다.

해당 도어락에 대한 모바일 앱 및 QR 인터콤 접근 권한이 자동으로 부여됩니다. 사용자에게 이미 재사용 가능한 키 신원이 있으면 포털이 이를 재사용할 수 있습니다. Send email with key의 초기 상태와 부여되는 접근 권한은 계정에 구성된 기본 동작을 따르므로 이러한 옵션이 미리 설정되어 있을 수 있습니다.

11.4 QR 인터콤 접근 할당

사용자에게 Wallet Key 없이 QR 인터콤 접근이 필요할 때 이 옵션을 사용합니다.

  1. 마법사에서 QR Intercom을 선택합니다.
  2. 사용자와 도어락을 확인합니다.
  3. Grant Access를 클릭합니다.

11.5 키 업데이트

키 카드의 작업 메뉴를 엽니다. 키 유형에 따라 다음 작업을 사용할 수 있습니다:

  • Set Validity(유효 시작/유효 종료 날짜 변경)
  • Send Wallet Email
  • Add to Another Lock(다른 도어락에서 키 UUID 재사용)
  • Revoke Key

Add to Another Lock은 키의 성격을 유지합니다. 실물 키를 다른 도어락에 추가하면 그 도어락에도 같은 카드가 실물 키로 추가되며, Wallet Key의 기능인 모바일 앱이나 QR 인터콤 접근 권한은 부여되지 않습니다. 실물 카드는 수명 중 언제든지 다른 도어락에 추가할 수 있으며, 취소된 카드만 거부됩니다.

여러 대상 도어락을 한 번에 선택할 수 있습니다. 같은 키가 각 도어락에 추가되며, 완료할 수 없는 도어락이 있으면 도어락별 결과가 표시됩니다.

모바일 및 인터콤 권한 칩을 전환하고 카드에서 바로 Apple Wallet 또는 Google Wallet 링크를 복사할 수도 있습니다.

11.6 키 취소

  1. Keys를 엽니다.
  2. 키를 찾습니다.
  3. 작업 메뉴를 열고 Revoke Key를 선택합니다(인터콤 카드에서는 Revoke 버튼 사용).
  4. 작업을 확인합니다.

Wallet Key를 취소해도 키가 영구적으로 폐기되지는 않습니다. 사용자는 시스템에 있는 동안 Wallet Key 하나를 계속 보유하므로, 같은 도어락이든 다른 도어락이든 다시 접근 권한을 부여하면 새 키를 발급하지 않고 완전히 동일한 키가 다시 돌아옵니다. 휴대폰에 이미 저장된 패스가 다시 작동하며 사용자가 다시 추가할 것은 없습니다. 실물 카드는 다릅니다. 취소된 카드는 절대 복원되지 않으며 새 카드를 프로그래밍해야 합니다.

11.7 일괄 작업 사용

확인란으로 키를 선택하면 일괄 작업 모음이 표시됩니다.

  1. Keys를 엽니다.
  2. 원하는 키를 선택합니다(또는 전체 선택 / 필터된 항목 선택 사용).
  3. 일괄 작업을 선택합니다:
    • Bind(사용 가능한 키의 경우)
    • Add to Lock(키 UUID 재사용)
    • Send Emails(Wallet 이메일)
    • Revoke
  4. 확인하고 완료될 때까지 진행 상황을 모니터링합니다.

Bind는 Assign Key 마법사와 같은 검색 필드에서 사용자를 묻습니다. 이름, 이메일 또는 전화번호를 입력하기 시작하면 목록이 좁혀지고, 아래의 Show address를 선택하면 주소를 보고 검색할 수 있습니다(11.2 참조).

Add to Lock에서는 단일 키 대화 상자와 마찬가지로 여러 대상 도어락을 선택할 수 있습니다. 선택한 모든 키가 선택한 모든 도어락에 추가되며, 각 키는 고유한 UUID, 접근 수준, 유효 기간을 유지합니다. 도어락에 이미 있는 키는 해당 도어락에 대해서만 보고되며 나머지 실행을 중단하지 않습니다.

11.8 오프라인 도어락과 대기 중인 변경 사항

키는 도어락에 연결할 수 있는 동안에만 실제로 도어락에 추가하거나 제거할 수 있습니다. 현재 Offline 상태이거나 아직 연결 상태를 보고하지 않아 Not connected 상태인 도어락에서 키를 할당, 업데이트 또는 취소하면 포털은 도어락과 연결되지 않았음을 알리고 실패 대신 변경 사항을 보류합니다:

  • 키 카드가 Pending 배지와 함께 회색으로 바뀌고 대기 중인 작업(추가, 제거 또는 업데이트)을 표시합니다.
  • 대기 중인 카드에서 사용할 수 있는 유일한 작업은 Cancel로, 보류된 변경 사항을 철회하고 키를 이전 상태로 되돌립니다.
  • 도어락이 다시 온라인 상태가 되면 보류된 변경 사항이 변경한 순서대로 자동으로 적용됩니다. 각 변경 사항은 감사 로그에 두 번 표시됩니다. 한 번은 대기열에 추가되었을 때, 다른 한 번은 실제로 실행되었을 때입니다.
  • 변경 사항이 적용되면 "Lock 999 came back online at 12:45 21/08/2026"과 같은 일회성 팝업이 추가, 제거 또는 업데이트된 키 수와 함께 표시됩니다. 도어락이 오프라인인 동안 대기열에 추가된 것이 없으면 팝업이 표시되지 않습니다.

연결 상태가 아직 Not connected인 도어락은 오프라인 도어락과 완전히 동일하게 처리됩니다. 변경 사항은 Pending 상태로 대기하다가 도어락이 처음으로 온라인 상태를 보고하면 적용됩니다. Online으로 표시된 도어락만 명령을 즉시 받습니다.

물리 NFC 카드도 같은 규칙을 따릅니다. 오프라인 도어락용으로 플래시한 카드는 평소처럼 리더기에서 기록됩니다. 도어락에 등록되는 것만 대기하며, Physical Keys 목록의 Delivered 열에는 도어락이 다시 온라인 상태가 될 때까지 Delivered 대신 Pending이 표시됩니다. 대기 중인 등록을 취소하면 카드가 취소됩니다. 도어락이 알지 못하는 기록된 카드로는 문을 열 수 없기 때문입니다.

게스트 키는 예외입니다. SmartKey는 게스트 키를 도어락이 아닌 클라우드에서 관리하므로, 게스트 키의 생성, 업데이트, 삭제는 도어락의 연결 상태와 관계없이 즉시 적용됩니다(12 참조).

섹션 12

임시 게스트 키 만들기 및 관리

방문자에게 기간 제한 접근 권한을 부여하려면 임시 게스트 키를 사용합니다.

게스트 키는 도어락을 기다리지 않습니다(11.8 참조). SmartKey가 게스트 키를 클라우드에서 관리하므로, 도어락이 Offline 또는 Not connected 상태여도 게스트 키의 생성, 업데이트, 삭제는 즉시 적용됩니다.

12.1 게스트 키 만들기

  1. Devices → Locks를 열고 원하는 도어락의 Guest Key 버튼을 클릭합니다(대시보드의 게스트 키 빠른 작업도 같은 방식으로 작동함).
  2. 창 상단의 두 개의 큰 버튼으로 키 유형을 선택합니다. Link Key(기본 선택)는 공유할 링크로 키를 발급합니다. Wallet Key는 설정한 기간 동안 유효한 Wallet Key를 발급합니다. 이 키는 다른 Wallet Key와 마찬가지로 도어락에 전송되고 아래에서 선택한 수신자에게 이메일로 발송되며(Max uses와 Authorization 옵션은 적용되지 않음), 기간이 끝나면 도어락에서 제거됩니다. Keys 페이지에서는 게스트 키 중에 Guest Wallet Key로 표시되며 카드 뒷면에 수신자의 이메일이 표시됩니다.
  3. 도어락을 확인하거나 선택합니다. 현재 시설에 활성 도어락이 하나뿐이면 자동으로 선택됩니다.
  4. 키 하나로 여러 도어락에 접근 권한을 부여하려면 도어락 선택기 옆의 Multiple locks를 켜고 포함할 모든 도어락을 선택합니다. 공유 키는 밀어서 여는 링크로 작동하므로 이 모드에서는 아래의 단일 도어락 옵션이 숨겨집니다.
  5. Valid From과 Valid Until을 설정합니다. 만들기 버튼을 누를 때 시작 시각이 이미 지났다면 키는 그 순간부터 유효합니다.
  6. *(단일 도어락만)* 필요에 따라 Max uses를 설정합니다.
  7. *(단일 도어락 및 Link Key만)* 필요에 따라 Authorization을 켜서 특정 사용자에게만 키를 제한한 다음, 키 사용이 허용된 Authorized emails를 입력합니다. 이 옵션이 꺼져 있으면 링크가 있는 사람은 누구나 유효 기간 내에 키를 사용할 수 있습니다.
  8. Link Key(단일 도어락만)의 경우 필요에 따라 링크를 자동으로 이메일로 보낼 수신자 이메일을 입력합니다. Wallet Key(단일 도어락 또는 Multiple locks)의 경우 수신자를 선택합니다. 이 필드를 클릭하면 시설의 사용자 목록이 열리며 첫 줄은 검색 상자입니다(이름 또는 이메일). 일치하는 사용자가 없으면 + 버튼(Create user)이 이름과 이메일만 입력하는 짧은 양식을 열고, 새 사용자가 수신자가 됩니다. 이미 계정이 있는 이메일이면 두 번째 계정을 만드는 대신 그 사람을 시설에 추가합니다. Multiple locks가 켜져 있어도 수신자는 유지되며 Wallet Key가 선택한 모든 도어락에 추가됩니다.
  9. Create Guest Key를 클릭합니다(Multiple locks가 켜져 있으면 Create Shared Key).

12.2 게스트 키 공유

키를 만든 후 결과 패널에 게스트 키 링크가 QR 코드로 표시되며 다음을 수행할 수 있습니다:

  • QR 코드를 탭하여 뒤집습니다. 키 아이콘은 게스트 키 링크를 열고, 다운로드 아이콘은 코드를 이미지로 저장합니다. 뒤집힌 타일(또는 모서리의 작은 화살표)을 탭하면 코드로 돌아갑니다.
  • Copy Link는 게스트 키 링크를 복사합니다.
  • 수신자 이메일을 입력하고 Send Email을 클릭합니다(창이 열려 있는 동안 다시 보낼 수 있음).

공유(여러 도어락) 키의 경우 결과 패널에 복사할 링크와 키로 열 수 있는 도어락 목록이 표시됩니다.

12.3 게스트 키 업데이트

  1. Keys를 열고 게스트 키 카드를 찾습니다.
  2. Update를 클릭합니다.
  3. 유효 기간을 업데이트합니다.
  4. 변경 사항을 저장합니다.

12.4 게스트 키 삭제

  1. Keys를 열고 게스트 키 카드를 찾습니다.
  2. Delete를 클릭합니다.
  3. 작업을 확인합니다.

12.5 공유(여러 도어락) 게스트 키 관리

Multiple locks로 만든 공유 게스트 키는 Keys 페이지에 다른 키와 마찬가지로 카드로 표시되며, 단일 도어락 카드에 도어락 이름이 표시되는 자리에 Multiple이 표시되고 모서리에 도어락 수가 표시됩니다. 이 카드는 페이지 상단의 필터를 따르므로, 페이지가 Active로 필터링된 동안에는 취소된 공유 키가 보이지 않습니다.

  1. 카드를 탭하여 뒤집습니다. 뒷면에는 키로 열 수 있는 도어락, 상태, 유효 기간이 표시됩니다.
  2. 뒷면에서 Open을 클릭하여 게스트 접근 페이지를 봅니다.
  3. Revoke를 클릭하고 확인하면 공유 키가 적용되는 모든 도어락에서 키가 꺼집니다.
섹션 13

Wallet Key 관리

Wallet Keys 탭(Keys 아래)을 열어 Wallet Key 가용성을 검토합니다.

13.1 Wallet Key 잔액 검토

각 소유자 카드에는 다음이 표시됩니다:

  • 여유(사용 가능한) Wallet Key
  • 할당된 Wallet Key
  • 전체 Wallet Key
  • 사용률/상태 표시기

13.2 Wallet Key 구매

이 옵션은 권한이 있는 사용자만 사용할 수 있습니다.

  1. Wallet Keys 탭을 엽니다.
  2. Buy Keys를 클릭합니다.
  3. 필요한 수량을 입력합니다.
  4. Checkout을 클릭하고 결제를 완료합니다.

Local Admin은 Wallet Key를 구매할 수 없습니다. Community Manager에게 문의해야 합니다.

13.3 Wallet Key 이전

키 이전이 허용된 경우:

  1. Wallet Keys 탭을 엽니다.
  2. Transfer to Local Admin에서 수신자를 선택합니다.
  3. 수량을 입력합니다.
  4. Transfer Keys를 클릭합니다.

시설의 모든 관리자에게 이전할 수 있습니다. 수신자가 아직 해당 시설의 Local Admin 역할을 보유하지 않은 경우 이전 과정에서 그 역할이 부여되므로 키를 바로 사용할 수 있습니다.

13.4 Wallet Key의 출처와 소진 시 동작

구독 요금제에는 Wallet Key가 포함되어 있습니다. Professional은 50개, Enterprise는 200개입니다. 이 키는 계정에 속하며, 키를 할당할 때마다 그중 하나가 사용됩니다.

  • 여유 Wallet Key가 두 개 미만으로 남으면 포털을 열자마자 Buy Keys 바로 가기와

함께 경고가 표시됩니다. 경고를 닫으면 숨겨지며, 잔액이 회복되었다가 다시 부족해질 때만 다시 표시됩니다.

  • 남은 키가 없는 상태에서 키를 할당하려고 하면 포털은 구독에 여유 Wallet Key가

없음을 알리고 메시지 안에서 바로 Buy Wallet Keys를 제안합니다.

  • Local Admin에게는 구매 버튼이 표시되지 않습니다. 대신 Wallet Key를 이전해 줄

Community Manager에게 문의하라는 안내를 받습니다.

섹션 14

실물 NFC 키 프로그래밍

Physical Keys 탭(Keys 아래)을 열어 실물 NFC 카드를 프로그래밍하고 취소합니다. 이 탭에는 두 가지 보기가 있으며, 목록 위의 Assigned / Unassigned 버튼으로 전환합니다:

  • Assigned — 사용자가 보유한 카드입니다. 목록은 도어락과 상태(프로그래밍됨, 대기 중, 초안, 실패, 취소됨)로 필터링할 수 있습니다. 카드는 준비된 순간부터 나열되므로, 플래시가 확인되지 않은 카드도 계속 표시되며 나중에 완료하거나 다시 프로그래밍할 수 있습니다. Delivered 열은 도어락이 키를 받았는지 보여 줍니다. Delivered이거나, 도어락이 오프라인인 동안에는 Pending입니다(11.8 참조).
  • Unassigned — 아직 아무도 보유하지 않은, 미리 플래시해 둔 카드입니다(14.4 참조). 버튼에 대기 중인 카드 수가 표시됩니다.

시작하기 전에 프로그래머 리더 또는 도어락의 내장 프로그래머를 사용할 수 있는지 확인하세요.

14.1 새 실물 키 프로그래밍

  1. Physical Keys 탭을 엽니다.
  2. Flash key를 클릭하여 실물 키 마법사를 엽니다.
  3. 1단계 — 도어락과 사용자를 선택합니다. 사용자 필드는 검색 상자입니다. 이름이나 이메일을 입력하기 시작하면 아래 목록이 입력에 따라 좁혀지며, 각 항목에는 그 사람이 해당 도어락에 이미 보유한 실물 키 수도 표시됩니다. 필드 아래의 Show address를 선택하면 각 사람의 주소가 이름 위에 표시되고 주소로도 검색할 수 있습니다. 초기 상태는 Settings → Defaults를 따릅니다(23.5 참조).
  4. 2단계 — 프로그래밍 장치를 선택합니다(또는 Use lock built-in programmer를 유지).
  5. 카드 유형에 맞는 버튼으로 플래시를 시작합니다: Flash MIFARE Classic 또는 Flash DESFire EV3.
  6. 안내가 표시되면 NFC 카드를 프로그래머에 갖다 댑니다.
  7. 장치의 표시를 기다립니다.
  8. 포털에서 Done을 클릭합니다.
  9. 카드가 프로그래밍됨으로 표시되는지 확인합니다.

플래시하는 동안 도어락이 오프라인이면 마법사가 이를 알려 줍니다. 카드는 그래도 기록되며, 도어락이 다시 온라인 상태가 되는 즉시 자동으로 키를 인식합니다. 그때까지 키는 Keys 페이지에서 Pending으로, Physical Keys 목록의 Delivered 열에서 Pending으로 표시됩니다(11.8 참조). 카드를 기록하는 장치는 별개입니다. 선택한 프로그래밍 장치(또는 도어락 자체의 내장 프로그래머)가 Offline으로 표시되면 마법사는 아무 작업도 하기 전에 멈추고 해당 장치가 오프라인이어서 플래시할 수 없다고 알려 줍니다. 연결 가능한 프로그래머를 선택하거나 장치가 돌아올 때까지 기다리세요.

선택한 카드 유형(MIFARE Classic 또는 DESFire EV3)은 키와 함께 저장되며 키 카드와 실물 키 목록의 Type 열에 표시됩니다.

14.2 카드 지우기 및 다시 프로그래밍

다시 프로그래밍할 때 마법사는 지우기 단계와 플래시 단계를 차례로 수행합니다.

  1. 위와 같이 프로그래밍 마법사를 시작합니다.
  2. 지우기 단계를 따릅니다: 카드를 갖다 댄 다음 Done을 클릭합니다.
  3. 플래시 단계를 따릅니다: 카드를 다시 갖다 댄 다음 Done을 클릭합니다.

14.3 실물 키 취소

  1. Physical Keys 탭을 엽니다.
  2. 카드를 찾습니다.
  3. 취소 작업을 클릭합니다.
  4. 필요에 따라 취소 사유를 입력합니다.
  5. 작업을 확인합니다.

14.4 할당되지 않은 키: 카드를 미리 플래시하기

Physical Keys 탭을 Unassigned로 전환하면 누가 보유할지 정해지기 전에 카드를 미리 플래시해 두었다가 나중에 나눠 줄 수 있습니다. 할당되지 않은 각 키는 도어락, 플래시한 날짜, 그리고 날짜와 관계없이 해당 도어락용으로 마지막에 플래시한 카드에서 이어지는 순번으로 이루어진 키 이름 아래에 나열됩니다: `229/260914/1`은 2026년 9월 14일에 도어락 229용으로 플래시한 첫 번째 카드이고, `229/260914/3`은 세 번째 카드이며, 하루 뒤에 플래시한 다음 카드는 `229/260915/4`입니다. 목록에는 도어락, UUID, 도어락이 키를 받았는지 여부(Delivered: Delivered 또는 Pending), 카드 유형, 상태, 카드를 플래시한 시각과 플래시한 사람도 표시됩니다. 할당되지 않은 키는 여기에만 표시되며, Keys 또는 Users 페이지나 대시보드 타일에는 표시되지 않습니다. 목록은 한 페이지에 키 50개를 표시하며, 표 아래의 페이지 링크로 페이지를 이동하고, 목록 위의 검색 상자로 키 이름, 도어락 또는 UUID로 키를 찾을 수 있습니다.

여러 카드를 한 번에 플래시하기

  1. Unassigned를 열고 Flash unassigned keys를 클릭합니다.
  2. 도어락, 카드 유형(MIFARE Classic 또는 DESFire EV3), 프로그래밍 장치(또는 Use lock built-in programmer를 유지), Number of keys를 선택합니다. 필요하면 Start number를 입력합니다. 그러면 이번 작업의 첫 번째 키가 정확히 그 번호를 받고 이후 키는 그 번호에서 이어집니다. 비워 두면 해당 도어락용으로 마지막에 플래시한 키에서 번호가 이어집니다. 그날 이미 사용 중인 키 이름에 해당하는 시작 번호는 거부됩니다. 그런 다음 Start flashing을 클릭합니다.
  3. 창에서 카드를 하나씩 차례로 플래시합니다. 각 카드마다 안내가 표시되면 리더에 갖다 댄 다음 Done을 클릭합니다. MIFARE Classic 카드는 단일 카드 절차와 똑같이 먼저 지운 다음 플래시합니다(14.2 참조).
  4. 카드를 플래시할 때마다 다음 카드로 넘어가려면 Next를, 중단하려면 Abort를 클릭합니다. Abort는 실행을 종료하고 플래시된 키 수를 알려 주며, 중단 시점에 준비 중이던 카드는 폐기됩니다.
  5. 마지막 카드가 완료되면 창에 플래시된 키 수가 표시됩니다. 끝나기 전에 창을 닫으면 같은 방식으로 실행이 중단됩니다.

실행 중에 도어락이 오프라인이어도 카드는 그대로 플래시됩니다. 도어락 등록은 오프라인 대기열에서 대기하며(11.8 참조), 도어락이 다시 온라인 상태가 될 때까지 각 카드의 Delivered에는 Pending이 표시됩니다.

준비, 지우기, 플래시, 폐기된 모든 카드와 실행 자체가 Logs에 기록됩니다.

사용자에게 키 할당하기

  1. 행을 더블 클릭(또는 두 번 탭)하거나 키의 + 작업을 클릭합니다.
  2. Assign to user 창에서 사람을 선택합니다. Give Access와 동일한 검색 가능한 목록이며 Show address 옵션이 있습니다(11.2 참조). 또는 Create User를 클릭하여 사용자를 추가합니다. 창에는 도어락, 카드 유형, 전달할 키도 표시됩니다. Also add to locks에서 키로 열 도어락을 추가로 선택할 수 있습니다(선택 사항).
  3. Assign을 클릭합니다. 해당 사용자가 카드의 보유자가 되고, 키 이름은 더 이상 표시되지 않으며, 키는 Assigned 아래에 해당 사용자의 다른 실물 키와 함께 나열됩니다. Settings → Defaults의 실물 키 기본값이 새로 발급된 카드와 마찬가지로 적용되며, 할당은 Logs에 기록됩니다. 추가 도어락을 선택한 경우 키는 이어서 Add to Another Lock과 같은 방식으로 각 도어락에 추가됩니다. 키를 추가하지 못한 도어락은 창에 표시되며, 키는 할당된 상태로 유지됩니다.

완전히 플래시된 카드만 할당할 수 있으며, 아직 초안, 대기 중 또는 실패로 표시된 카드는 삭제만 할 수 있습니다. 도어락이 온라인일 필요는 없습니다. 도어락이 오프라인인 동안에는 전달이 대기열에 추가되고, 도어락이 돌아올 때까지 키는 해당 사용자의 키 중에서 Pending으로 표시됩니다(11.8 참조). 자체 전달이 아직 Pending인 카드도 할당할 수 있으며, 이 경우 대기 중인 등록이 해당 사용자에게로 넘어갑니다. 도어락이 돌아오기 전에 대기 중인 전달을 취소하면(Keys 페이지에서 대기 중인 키의 Cancel 또는 취소 작업) 카드는 Unassigned 보기로 돌아갑니다.

여러 키를 한 번에

키의 확인란을 선택합니다(또는 헤더의 Select all). 일괄 작업 모음이 나타나며, 선택 항목 중 플래시된 키에 대한 Assign to user와 전체에 대한 Delete가 표시됩니다.

키 삭제하기

행의 삭제 작업(또는 일괄 작업 모음의 Delete)을 클릭하고 확인합니다. 카드가 도어락에서 제거되고(도어락이 오프라인인 동안에는 제거가 대기열에 추가되었다가 다시 온라인 상태가 되는 즉시 실행됨) 목록에서 사라집니다. 전달이 아직 Pending인 카드를 삭제하면 대신 해당 전달이 취소됩니다. 삭제는 Logs에 기록됩니다.

섹션 15

도어락 관리

Devices → Locks를 열어 도어락을 추가, 제어, 구성합니다.

15.1 도어락 상태

도어락은 다음과 같이 표시될 수 있습니다:

  • Unclaimed
  • Claiming
  • Active
  • Inactive
  • Error

사용할 수 있는 작업은 현재 상태에 따라 다릅니다. 활성 도어락이 일반적인 경우이므로 카드에는 배지가 표시되지 않으며, 그 외의 모든 상태는 도어락 이름 아래에 배지로 표시됩니다.

도어락 이름 아래에는 도어락 유형(Matter 허브를 통해 보고하는 도어락의 경우 Matter)과 도어락의 실제 연결 이벤트를 기반으로 한 연결 표시기(Online 또는 Offline)가 카드에 표시됩니다. 아직 연결을 보고하지 않은 도어락은 Not connected으로 표시됩니다. 도어락의 ID, 일련번호, 허브는 Lock Details 창에 있습니다(15.14 참조).

카드 위의 필터 버튼은 목록을 좁히며 각각 개수를 표시합니다: All, Unclaimed, Online, Offline, Not connected, Inactive, Error. 세 가지 연결 필터는 카드의 연결 표시기를 따릅니다. 버튼 옆의 검색 필드는 입력한 내용이 이름에 포함된 도어락만 남깁니다.

15.2 도어락 추가

  1. Devices → Locks를 엽니다.
  2. Add Lock을 클릭합니다.
  3. 도어락 일련번호를 입력하거나 바코드 아이콘을 클릭하여 카메라로 일련번호를 스캔합니다.
  4. Matter 코드를 입력하거나 QR 아이콘을 클릭하여 카메라로 Matter QR 코드를 스캔합니다.
  5. Add를 클릭합니다.

도어락은 현재 선택된 시설에 추가됩니다. 카메라 스캔에는 카메라가 있는 장치와 카메라 사용 권한이 필요하며, 언제든지 값을 직접 입력해도 됩니다.

15.3 원격으로 도어락 열기

  1. Devices → Locks를 엽니다.
  2. 활성 도어락을 찾습니다.
  3. Open을 클릭합니다.
  4. 확인 창에서 상태를 검토하고 Open Lock으로 확인합니다.

포털은 먼저 열기 명령을 보냈다고 표시한 다음, 도어락이 직접 열렸다고 알릴 때까지 기다립니다. 보통 몇 초면 됩니다. 그런 다음 도어락이 열렸다는 메시지나 열림을 확인하지 않았다는 메시지가 표시됩니다. 후자의 경우 도어락이 온라인 상태인지 확인하고 다시 시도하세요.

버튼을 일시적으로 사용할 수 없으면 카운트다운이 끝날 때까지 기다린 후 다시 시도하세요.

15.4 도어락 이름 바꾸기

  1. Devices → Locks를 엽니다.
  2. 도어락을 찾습니다.
  3. 도어락 이름 옆의 연필(이름 바꾸기) 아이콘을 클릭합니다.
  4. 새 이름을 입력합니다.
  5. 변경 사항을 저장합니다.

15.5 도어락을 프로그래머 리더로 설정

호환되는 리더로 NFC 카드를 프로그래밍하려는 경우 이 기능을 사용합니다.

  1. Devices → Locks를 엽니다.
  2. 원하는 도어락을 찾습니다.
  3. 도어락 작업 메뉴를 열고 Lock Details를 선택합니다.
  4. Maintenance 페이지를 엽니다 — 제목 아래 탭 줄에 있는 렌치 아이콘입니다(어느 페이지가 열려 있는지는 제목에 표시됩니다).
  5. Set as Programmer를 선택합니다(비활성화하려면 Unset Programmer).

15.6 도어락 등록

  1. Devices → Locks를 엽니다.
  2. 미등록 도어락을 찾습니다.
  3. 작업 메뉴를 열고 Claim Lock을 선택합니다.
  4. 작업을 확인합니다.

15.7 도어락 비활성화

  1. Devices → Locks를 엽니다.
  2. 활성 도어락을 찾습니다.
  3. 작업 메뉴를 열고 Lock Details를 선택한 다음 Maintenance 페이지(렌치 아이콘)를 엽니다.
  4. Deactivate Lock을 선택합니다.
  5. Deactivate로 확인합니다.
  6. 도어락에 아직 활성 키가 있으면 창에 그 사실이 표시되고 버튼이 Force Deactivate로 바뀝니다. 이를 클릭하면 도어락이 그대로 비활성 상태로 전환됩니다. 키는 회수되거나 도어락이 제거될 때까지(15.9) 연결된 채 계속 작동합니다.

15.8 도어락 다시 활성화

  1. Devices → Locks를 엽니다.
  2. 비활성 도어락을 찾습니다.
  3. Reactivate를 클릭합니다.
  4. 작업을 확인합니다.

15.9 도어락 제거

  1. Devices → Locks를 엽니다.
  2. 제거 가능한 미등록 또는 비활성 도어락을 찾습니다.
  3. Remove를 클릭합니다.
  4. 경고를 주의 깊게 읽고 What will be withdrawn 목록을 확인합니다.
  5. Remove Lock으로 확인합니다.
  6. 제거가 진행되는 동안 창을 열어 두세요. 상태 표시줄에 각 단계가 표시됩니다. 요약은 Done으로 닫습니다.

도어락을 제거하면 계정에서 해제되며, 그 전에 도어락에 전송된 모든 항목이 SmartKey에서 회수됩니다. 각 사용자의 모바일 앱 및 QR 인터콤 접근 권한, 도어락의 모든 키(Wallet Key 및 기타 디지털 키, 실물 카드, 미리 플래시해 둔 카드), 게스트 키, 이 도어락을 여는 공유 게스트 키, 이 도어락을 사용하는 시나리오(삭제됨), 카메라 연결(카메라 자체는 유지됨)이 대상입니다. 다른 도어락도 여는 공유 게스트 키는 해당 도어락에 대해 다시 발급되며, 요약에 새 링크가 표시됩니다. 도어락이 오프라인이면 키 제거는 도어락이 다시 온라인 상태가 될 때까지 대기한 후 자동으로 전송되며, 모바일 앱 및 QR 인터콤 접근 권한과 게스트 키는 즉시 회수됩니다. 모든 항목이 회수되면 도어락은 키가 하나도 없는 상태(내장 키 포함)의 미등록 장치로 시스템에 계속 등록되어 있으므로, 나중에 일련번호와 페어링 코드를 사용하여 다시 추가할 수 있습니다.

회수할 수 없는 항목이 있으면 도어락은 제거되지 않습니다. 도어락은 계정에 비활성 상태로 남아 있고, 요약에 실패한 항목이 표시됩니다. 다시 시도하려면 Remove를 다시 클릭하세요. 이미 회수된 항목은 그대로 유지됩니다. 제거 도중 창이 닫혔다면 Remove에서 Continue the removal을 사용할 수 있습니다.

15.10 다른 시설로 도어락 보내기

  1. Devices → Locks를 엽니다.
  2. 도어락을 찾습니다.
  3. 작업 메뉴를 열고 Send to Another Entity를 선택합니다.
  4. 대상 시설을 선택합니다.
  5. 이전을 확인합니다.

15.11 도어락에서 사용자 제거

  1. Devices → Locks를 엽니다.
  2. 도어락을 찾습니다.
  3. 작업 메뉴를 열고 User List를 선택합니다.
  4. 원하는 사용자를 찾습니다.
  5. Remove를 클릭합니다.
  6. 작업을 확인합니다.

이렇게 하면 해당 도어락과 연결된 사용자의 접근 권한이 제거됩니다.

Users on 창 하단의 Keys 버튼은 이 도어락으로 필터링된 키 페이지를 열므로 같은 사용자를 키로도 검토할 수 있습니다.

15.12 도어락을 Wi-Fi에 연결

포털에서 직접 Bluetooth를 통해 근처 도어락에 Wi-Fi 자격 증명을 보낼 수 있습니다. 이 기능을 사용하려면 Web Bluetooth를 지원하는 브라우저(예: 데스크톱 또는 Android 장치의 Chrome이나 Edge, 또는 iPhone의 Bluefy – Web BLE Browser)와 도어락과의 물리적 근접성이 필요합니다.

  1. Devices → Locks를 엽니다.
  2. 도어락을 찾고 Configure Wi-Fi를 선택합니다.
  3. Bluetooth를 통해 도어락과 페어링하라는 브라우저 메시지를 확인합니다.
  4. SSID(네트워크 이름)를 입력합니다. Scan Wi-Fi를 클릭하여 도어락이 네트워크를 찾도록 할 수 있지만, 네트워크 이름은 여전히 직접 입력해야 합니다.
  5. Wi-Fi password를 입력합니다.
  6. Connect Lock to Wi-Fi를 클릭하고 성공 또는 실패 메시지를 기다립니다.

비밀번호는 Bluetooth를 통해 도어락으로 바로 전송되며 포털에는 저장되지 않습니다.

15.13 도어락을 Matter 허브에 연결

시설에 Matter 허브가 있으면 도어락 카드에서 직접 Thread를 통해 등록된 도어락(리더)을 허브에 페어링할 수 있습니다. 도어락은 이전과 같이 계속 작동하며, 이 작업은 도어락을 허브에 연결하기만 합니다. 도어락 제어는 여전히 SmartKey 서비스를 통해 이루어집니다.

  1. Devices → Locks를 엽니다.
  2. 도어락을 찾고 메뉴에서 Connect to Matter Hub를 선택합니다.
  3. 허브를 선택합니다. 시설에 허브가 하나뿐이면 자동으로 선택되고, 아직 허브가 없으면 먼저 허브를 등록해야 한다는 안내가 창에 표시됩니다.
  4. 화면의 안내에 따라 리더를 페어링 모드로 전환한 다음 Next를 클릭합니다. 도어락에 저장된 페어링 코드가 자동으로 사용되며, 도어락에 코드가 없으면 리더의 Matter 페어링 코드를 입력합니다.
  5. 허브가 리더를 페어링하는 동안 기다립니다. 몇 분이 걸릴 수 있으며, 창에 실시간 진행 상황이 표시된 후 성공, 허브 사용 중, 허브 오프라인 또는 시간 초과가 보고됩니다.
  6. 성공하면 도어락 카드에 도어락 유형으로 Matter가 표시되고 Lock Details 창에 허브 이름이 표시됩니다.

도어락이 Matter 허브를 통해 연결되어 있는 동안에는 카드에 도어락 유형으로 Matter가 표시됩니다. 여기에는 Matter 장치로 커미셔닝되어 자동으로 도어락으로 이동된 리더도 포함되며, 허브 이름과 Thread 신호는 Lock Details 창에 나열됩니다. 카드의 온라인/오프라인 표시기는 활성 연결을 따릅니다. 허브를 통해 보고하는 리더는 허브 측 상태를 표시하고, LTE 또는 Wi-Fi로 다시 전환된 도어락은 자체 연결을 다시 따릅니다. 도어락이 자체 LTE 또는 Wi-Fi 연결로 돌아가면 카드에는 다시 도어락 자체 유형(예: Smart Lock)이 표시되고, Lock Details 창에는 Matter 허브가 Not connected로 표시됩니다. 도어락이 다시 허브를 통해 보고하면 Matter가 자동으로 다시 표시됩니다.

15.14 도어락 세부 정보와 QR 코드

도어락 메뉴(카드 모서리의 점 세 개)에서 Lock Details를 선택하면 카드에 없는 모든 정보를 볼 수 있습니다: 시설, SmartKey 도어락 ID, 일련번호, 상태, 연결(온라인/오프라인 및 마지막 변경 시각), 도어락이 보고하는 Matter 허브, 위치, 연결된 카메라. 같은 창은 키 카드 뒷면의 Lock Details 버튼에서도 열립니다(11 섹션). 이 창은 제목 아래의 아이콘으로 페이지를 전환합니다 — Overview(정보 아이콘), Linked Cameras(카메라 아이콘, 카메라를 관리하는 경우), 그리고 도어락을 관리하는 경우 Maintenance(렌치 아이콘) — 제목에는 열려 있는 페이지 이름이 표시됩니다(예: "Maintenance — Front Door"). Maintenance 페이지에서는 Set as Programmer(15.5), Replace Lock(15.15), Deactivate Lock(15.7)을 사용할 수 있습니다. Linked Cameras 페이지에서는 이미 있는 카메라를 연결합니다. 카메라 자체는 Cameras 페이지에서 만듭니다.

일련번호가 있는 모든 도어락은 카드 오른쪽에 QR 인터콤 코드를 표시하며, 이는 관리자가 도어락 설정에서 인쇄하는 것과 같은 코드입니다. 코드를 탭하면 타일이 뒤집힙니다:

  • 카메라 아이콘은 코드가 연결되는 페이지, 즉 방문자가 문 앞에서 코드를 스캔하면 도달하는 페이지를 엽니다.
  • 다운로드 아이콘은 도어락 이름, 일련번호, QR 코드가 포함된 인쇄용 PDF를 저장합니다.

타일을 다시 탭하면 원래대로 돌아갑니다.

15.15 도어락 교체 또는 복사

도어락을 새 장치로 교체하거나, 두 번째 도어락에 기존 도어락과 같은 설정을 적용하려는 경우 이 기능을 사용합니다.

  1. Devices → Locks를 열고 도어락 메뉴를 연 다음 Lock Details를 선택합니다.
  2. Maintenance 페이지(렌치 아이콘)를 연 다음 Replace Lock을 클릭합니다.
  3. 스위치로 작업을 선택합니다:
    • Replace — 모든 항목이 대상 도어락으로 옮겨진 다음, 기존 도어락에서 모든 키와 접근 권한이 제거되고 기존 도어락이 비활성화됩니다. 대상 도어락은 New lock name에 입력한 이름(변경하지 않으면 기존 도어락의 이름)을 갖게 되며, 그 이름을 이어받는 경우 기존 도어락의 이름에는 "(replaced)"가 붙습니다.
    • Copy — 모든 항목이 대상 도어락에도 추가되며, 기존 도어락은 그대로 유지됩니다.
  4. Target lock(같은 시설의 활성 도어락)을 선택하거나, Add a new lock을 클릭하고 새 장치의 일련번호와 Matter 코드를 입력합니다. 도어락이 즉시 등록되고 대상으로 선택됩니다.
  5. New lock name 필드를 확인합니다 — 이전 후 대상 도어락이 갖게 될 이름입니다(Replace 모드에서는 기존 도어락의 이름, Copy 모드에서는 대상 도어락의 원래 이름). 필요하면 변경합니다.
  6. What will be transferred 목록을 검토하고 Replace Lock(또는 Copy to Lock)을 클릭합니다.

이전되는 항목: 도어락의 위치, 주소, 시간대, 근무 시간 외 알림 설정, 포털 사용자, 추가 시설, 이 도어락에 한정된 역할 부여, 프로그래머 리더 플래그, 주간 일정(새 도어락에도 전송됨), 소지자와 함께 이전되는 모든 키(Wallet Keys와 기타 디지털 키, 실물 키, QR 인터콤 접근, 게스트 키)와 각 소지자가 보유한 모바일 앱 및 QR 인터콤 접근 권한, 공유(여러 도어락) 게스트 키, 그리고 새 도어락이 같은 Matter 허브에 연결된 경우 해당 도어락을 사용하는 시나리오. Replace 모드에서는 연결된 카메라도 새 도어락으로 옮겨지며, 카메라는 도어락 하나에만 연결할 수 있으므로 Copy 모드에서는 그대로 유지됩니다.

이전이 실행되는 동안 창에는 현재 단계와 완료, 건너뜀, 실패한 단계 수를 보여 주는 상태 표시줄이 나타납니다. 이전이 끝날 때까지 창을 열어 두세요. 키 명령은 짧은 간격을 두고 한 번에 하나씩 전송되므로 키가 많은 도어락은 몇 분이 걸립니다. 중간에 창이 닫히거나 연결이 끊기면 Replace Lock을 다시 열었을 때 중단된 단계부터 Continue the transfer가 제공됩니다.

마지막에는 완료된 항목, 건너뛴 항목과 그 이유, 실패한 단계가 요약으로 표시됩니다. 게스트 키와 공유 게스트 키는 새 링크와 함께 새 도어락에 재발급됩니다. 이메일로 보냈던 게스트 키는 새 링크와 함께 다시 이메일로 발송되고, 나머지 새 링크는 요약에 표시됩니다. 모든 내용은 Logs → Audit 탭에 기록됩니다. 각 도어락에 Replace Lock / Copy Lock 항목 하나와 일반적인 키, 접근 권한, 게스트 키 항목이 기록됩니다.

섹션 16

주간 도어락 일정 구성

스케줄러를 사용하여 요일별 접근 시간 간격을 정의합니다.

16.1 일정 설정

  1. Devices → Locks를 엽니다.
  2. 원하는 도어락을 찾습니다.
  3. Scheduler를 클릭합니다.
  4. 요일을 선택합니다.
  5. 시간 간격을 하나 이상 추가합니다.
  6. 나머지 요일에 대해 반복합니다.
  7. 일정을 저장합니다. 변경 사항을 도어락에 즉시 반영하려면 장치에 동기화도 함께 수행하는 저장 옵션을 사용합니다.
  8. 장치에 동기화하면 도어락이 일정을 단계별로 받아들이는 동안 포털에 진행 상황이 표시됩니다. 일정이 적용되었다고 보고될 때까지 스케줄러를 열어 두세요. 도어락이 중간에 멈추면 포털이 실패한 단계를 알려 줍니다.

16.2 장치 일정 상태 새로고침

  1. 도어락 스케줄러를 엽니다.
  2. 상태 새로고침 작업을 클릭합니다.
  3. 포털이 장치 정보 로드를 마칠 때까지 기다립니다.
  4. 포털에 표시된 일정을 검토합니다.
섹션 17

허브 관리

Devices → Hubs를 열어 Matter 허브를 관리합니다.

각 허브 헤더에는 두 개의 표시기가 있습니다: 허브의 수명 주기 상태(예: Claimed 또는 Suspended)와 실시간 연결 표시기(Online, Offline, 또는 허브가 아직 연결을 보고하지 않은 동안에는 Unknown). 연결 표시기는 허브의 실제 연결 이벤트를 반영하며 수명 주기 상태와는 무관합니다.

17.1 허브 추가

  1. Devices → Hubs를 엽니다.
  2. Add Hub를 클릭합니다.
  3. 필요한 경우 허브 이름을 입력합니다.
  4. 시설을 선택합니다.
  5. 소유자를 선택합니다.
  6. 허브 UUID를 입력합니다.
  7. Add Hub를 클릭합니다.

17.2 허브 상태 새로고침

  1. Devices → Hubs를 엽니다.
  2. Refresh를 클릭합니다.

17.3 허브 이름 바꾸기 또는 역할 변경

  1. Devices → Hubs를 엽니다.
  2. 허브를 찾고 Edit Hub를 엽니다.
  3. 이름을 업데이트하거나 Primary hub 스위치로 기본 또는 보조 허브로 설정합니다.
  4. Save를 클릭합니다.

17.4 허브 일시 중지

  1. Devices → Hubs를 엽니다.
  2. 허브를 찾고 Suspend를 선택합니다.
  3. 사유를 입력합니다.
  4. 작업을 확인합니다.

17.5 허브 다시 등록 또는 이동

허브를 다른 적격 시설이나 소유자에게 할당하려면 이 작업을 사용합니다.

  1. Devices → Hubs를 엽니다.
  2. 허브를 찾고 Re-claim을 선택합니다.
  3. 대상 시설을 선택합니다.
  4. 소유자를 선택합니다.
  5. 사유를 입력합니다.
  6. 작업을 확인합니다.

17.6 Matter 장치 커미셔닝

  1. Devices → Hubs를 열고 Commission Device를 선택하거나, Devices → Matter를 열고 Add Device를 클릭합니다.
  2. 허브를 선택합니다.
  3. *(선택 사항)* 장치가 Wi-Fi로 연결되는 경우 Matter over Wi-Fi를 켭니다. 그런 다음 저장된 Wi-Fi profile을 선택하거나 새 Wi-Fi network name (SSID)와 password를 입력합니다(비밀번호를 표시하거나 숨길 수 있으며, Save this network as a reusable Wi-Fi profile을 선택하면 나중에 이 시설에서 다시 사용할 수 있음). Wi-Fi 자격 증명이 필요 없는 장치의 경우 스위치를 꺼 둡니다.
  4. 커미셔닝 코드를 입력하거나 카메라로 Matter QR 코드를 스캔합니다.
  5. Commission을 클릭합니다. Matter over Wi-Fi가 켜져 있으면 창이 Wi-Fi 자격 증명을 저장하고 잠시 기다린 후 커미셔닝을 시작하며, 작업이 진행되는 동안 버튼에 Saving Wi-Fi, Preparing commissioning, Commissioning이 차례로 표시됩니다.
  6. 장치가 Matter 탭에 나타날 때까지 기다립니다.

Matter over Wi-Fi가 켜져 있는 경우: Wi-Fi 자격 증명을 저장해도 비밀번호가 올바른지는 확인되지 않으며, 장치가 페어링하는 동안 연결을 테스트합니다. Wi-Fi 네트워크 저장에 실패하면 커미셔닝이 시작되지 않으므로 네트워크를 수정하고 다시 시도할 수 있습니다. 나중에 장치가 네트워크에 연결할 수 없으면 SSID, 비밀번호, 신호 강도, 네트워크 연결 가능 여부를 확인하라는 메시지가 표시됩니다.

페어링에 실패하면 장치 카드에 간단하고 알기 쉬운 설명(예: 장치가 제시간에 응답하지 않음)이 표시됩니다. 전체 기술적 오류 세부 정보는 백오피스와 장치의 이벤트 로그에서 관리자가 계속 확인할 수 있습니다.

커미셔닝된 장치가 SmartphoneKey 도어락 리더인 경우 Locks 섹션에 속하므로 자동으로 그곳으로 이동합니다. 약 30초 동안 Matter 탭에 해당 장치의 Transferring to Locks 카드가 표시된 후 장치가 Devices → Locks 아래에 사용 가능한 상태로 나타납니다. 이 장치는 속한 시설에 등록되고 리더의 이름을 따릅니다. 같은 리더를 다시 페어링하면 작업 중에 Matter 탭에 평소의 Commissioning… 카드가 표시됩니다.

섹션 18

Matter 장치 관리

Devices → Matter를 열어 허브를 통해 커미셔닝된 장치를 검토합니다.

18.1 Matter 장치 검토

목록에는 다음이 표시될 수 있습니다:

  • 장치 이름 또는 UUID
  • 허브
  • 시설
  • 장치 유형
  • 상태
  • 가용성(Online, Offline, 또는 장치가 연결 상태를 보고할 때까지 Unknown. Matter-Zigbee 게이트웨이 뒤의 장치는 게이트웨이의 연결 가능 여부 보고를 따르며, 게이트웨이 자체가 오프라인인 동안에는 게이트웨이의 모든 장치가 오프라인으로 표시됨)
  • 할당된 사용자
  • 이벤트
  • 배터리, 신호, 온도, 습도, 재실 여부 또는 기타 사용 가능한 값

각 장치 카드에는 Matter 장치 유형에 맞는 아이콘이 표시되며, 이는 SmartphoneKey 모바일 앱에서 사용하는 것과 같은 아이콘 세트입니다. 전환 가능한 장치(조명, 플러그, 스위치)는 보고된 켜짐/꺼짐 상태를 표시하고, 연기 감지기는 상호 연결된 다른 감지기에서 수신한 경보를 포함하여 경보 상태를 표시합니다.

페어링 시도가 실패하면 카드에 잠시 간단한 설명이 표시된 후 메시지가 자동으로 사라집니다. 실패 내용은 필요한 만큼 Logs → Activity와 장치 세부 정보에 남아 있습니다. 이미 페어링된 장치를 페어링하면 같은 짧은 메시지가 표시됩니다.

18.2 사용자에게 Matter 장치 할당

  1. Devices → Matter를 엽니다.
  2. 장치를 찾습니다.
  3. Assign을 클릭합니다.
  4. 사용자를 선택합니다.
  5. 할당을 확인합니다.

버튼이 비활성화되어 있으면 포털에 표시된 메시지를 검토하세요.

18.3 사용자-장치 할당 제거

  1. Devices → Matter를 엽니다.
  2. 할당된 장치를 찾습니다.
  3. 할당 세부 정보를 엽니다.
  4. Remove를 클릭합니다.
  5. 작업을 확인합니다.

18.4 장치 이벤트 보기

  1. Devices → Matter를 엽니다.
  2. 장치를 찾습니다.
  3. 장치의 이벤트 또는 세부 정보를 엽니다.
  4. 사용 가능한 이벤트 기록을 검토합니다.

18.5 포털에서 Matter 장치 제거

  1. Devices → Matter를 엽니다.
  2. 장치를 찾습니다.
  3. 삭제/제거 작업을 선택합니다.
  4. 작업을 확인합니다.

Matter 장치의 경우 포털은 먼저 허브에 장치 페어링 해제를 요청한 다음 해당 레코드를 삭제합니다. Zigbee 게이트웨이를 통해 연결된 장치는 원격으로 페어링을 해제할 수 없습니다. 포털 레코드만 삭제되며, 장치는 초기화될 때까지 게이트웨이에 페어링된 상태로 남습니다.

제거가 진행되는 동안 작업은 Removing으로 표시되며 다시 시작할 수 없습니다. 페어링 해제에는 몇 초가 걸리며, 허브에 같은 장치의 페어링 해제를 두 번 요청해서는 안 되기 때문입니다.

게이트웨이를 제거하면 게이트웨이를 통해 연결된 모든 Zigbee 장치도 제거됩니다. 이러한 장치는 게이트웨이를 통해서만 연결할 수 있기 때문입니다. 확인 대화 상자에는 게이트웨이 이름과 함께 제거되는 연결된 장치 수가 표시됩니다. 허브 삭제도 같은 방식으로 작동합니다. 허브에 커미셔닝된 모든 장치(게이트웨이와 그 뒤의 Zigbee 장치 포함)가 함께 제거됩니다.

중요: 포털에서 장치를 제거해도 실제 장치가 공장 초기화되지는 않을 수 있습니다. 필요한 경우 별도로 초기화하거나 사용 중지하세요.

18.6 Matter 장치 제어

역할이 허용하고 장치가 지원하는 경우 일부 Matter 장치는 포털에서 제어할 수 있습니다.

  1. Devices → Matter를 엽니다.
  2. 장치를 찾습니다.
  3. 장치 카드에 표시된 컨트롤을 사용합니다:
    • 버튼(예: 장치를 켜거나 끄는 버튼).
    • 레벨(예: 밝기)을 지원하는 장치용 슬라이더. 슬라이더는 장치가 마지막으로 보고한 레벨을 반영하며, 장치가 켜져 있는 동안 카드에 밝기 백분율이 표시됩니다.

컨트롤은 제어 가능한 기능을 보고하는 장치에만 표시되며, 그 외의 장치는 컨트롤 없이 현재 상태만 표시합니다.

18.7 접촉 센서의 열림/닫힘 표시 반전

접촉 센서가 장착된 방향과 반대로 열림과 닫힘을 보고하는 경우 이 기능을 사용합니다.

  1. Devices → Matter를 엽니다.
  2. 접촉 센서 장치를 찾고 Edit를 엽니다.
  3. Invert Open/Closed display를 켭니다.
  4. 변경 사항을 저장합니다.

그러면 포털이 해당 장치의 열림 및 닫힘 레이블을 바꾸어 표시된 상태가 문이나 창과 일치하게 됩니다.

18.8 Matter-Zigbee 게이트웨이 뒤의 Zigbee 장치

일부 Matter 장치는 Zigbee 장치를 연결하는 게이트웨이입니다(예: Matter-Zigbee 허브). 이러한 게이트웨이가 커미셔닝되면 포털은 이를 하위 허브로 표시합니다. 상위 허브 아래에 중첩된 허브 스타일의 헤더로, 자체 가용성, 세부 정보 패널, 작업을 갖습니다.

  • 게이트웨이에 연결된 Zigbee 장치는 허브에 직접 커미셔닝된 장치와 별도로 게이트웨이 헤더 아래에 나열됩니다.
  • 새 Zigbee 장치가 게이트웨이에 합류하면 게이트웨이 아래에 자동으로 나타나며, 포털에서 추가 커미셔닝 단계는 필요하지 않습니다.
  • 게이트웨이에 이미 연결되어 있던 Zigbee 장치는 상태를 보고하는 대로 자동으로 인식됩니다.
  • Zigbee 장치의 정보 창에는 게이트웨이와 Zigbee 엔드포인트가 표시됩니다.
  • 게이트웨이는 각 Zigbee 장치의 제조업체, 모델, 일련번호, 게이트웨이에 구성된 이름을 보고하며, 포털은 이러한 세부 정보를 자동으로 채웁니다(포털에서 직접 설정한 이름은 절대 덮어쓰지 않음).
  • Zigbee 장치의 온라인/오프라인 표시기는 해당 장치에 대한 게이트웨이의 연결 가능 여부 보고를 따르며, 게이트웨이 자체가 오프라인인 동안에는 게이트웨이의 모든 Zigbee 장치가 오프라인으로 표시됩니다.
  • 포털에서 게이트웨이를 제거하면 Zigbee 장치도 함께 제거됩니다. 이러한 장치는 게이트웨이를 통해서만 포털에 존재하기 때문입니다.
  • 게이트웨이는 한 번에 하나의 허브에만 추가할 수 있습니다. 게이트웨이가 아직 다른 허브에 추가되어 있으면 페어링이 거부되고 카드에 먼저 해당 허브에서 제거하라는 안내가 표시됩니다. 게이트웨이의 Zigbee 장치는 그 허브에 남아 있으므로, 그렇지 않으면 그곳에 방치될 수 있기 때문입니다.
섹션 19

카메라 관리

Cameras(카메라 탭)를 열어 카메라를 추가하고 관리합니다. 상태별로 필터링하고 그리드 밀도를 선택할 수 있습니다.

19.1 카메라 추가

  1. Cameras를 엽니다.
  2. Add Camera를 클릭합니다.
  3. 카메라 이름을 입력합니다.
  4. 카메라 유형을 선택합니다.
  5. 시설을 선택합니다.
  6. 필요한 경우 소유자를 선택합니다.
  7. 필요한 연결 세부 정보를 입력합니다:
    • RTSP 카메라의 경우 RTSP URL을 입력합니다.
    • HTTP 카메라의 경우 HTTP URL을 입력합니다.
    • 푸시 모듈 카메라의 경우 카메라에 인쇄된(또는 푸시 모듈이 제공한) 등록 코드를 관리자 로그인 및 비밀번호와 함께 입력합니다.
    • 그 밖의 지원되는 카메라 유형의 경우 필요한 로그인과 비밀번호를 입력합니다.
    • 양식에 RTSP URL 필드가 표시될 때마다 전체 링크(예: `rtsp://login:password@192.168.1.10:554/stream?channel=1`)를 붙여넣으면 로그인, 비밀번호, HTTP URL, 카메라 이름이 링크에서 자동으로 채워지며, 직접 입력한 값은 그대로 유지됩니다.
  8. 필요에 따라 같은 시설의 연결된 도어락을 선택합니다(푸시 모듈 카메라는 만든 후에 도어락에 연결할 수 있음).
  9. Create를 클릭합니다.

RTSP 카메라의 경우 양식에 Camera access 섹션도 있어 카메라를 만드는 즉시 사용자와 공유할 수 있습니다. 사용자 필드에서 사람을 고른 다음(Manage access와 같은 검색 상자이며(19.9 참조), Show the address when choosing a user가 켜져 있으면 주소 줄이 표시됨) 더하기 버튼을 클릭합니다. 사람마다 반복합니다. 구독에 Video archive 옵션이 포함되어 있으면, 사람을 추가하기 전에 Add a manager role을 선택하여 Viewer(실시간 영상만) 대신 Manager(실시간 영상 및 녹화) 역할을 부여할 수 있습니다. 필드 아래 목록에는 접근 권한을 받을 사람과 그 역할이 표시되며, X로 제거할 수 있습니다.

19.2 카메라 스트림 보기

  1. Cameras를 엽니다. 각 타일에는 해당 카메라의 마지막 화면이 표시되므로, 아무것도 열기 전에 각 카메라가 무엇을 보고 있는지 알 수 있습니다. 아직 화면을 보낸 적이 없는 카메라는 기본 이미지를 유지합니다.
  2. 카메라를 클릭해 창을 엽니다. 영상을 시작하기 전까지 플레이어에는 같은 마지막 화면이 날짜와 함께 표시됩니다.
  3. Play Live를 눌러 실시간 화면을 봅니다.

창에는 플레이어가 하나뿐입니다. 아래 Archive 블록의 녹화 영상도 같은 플레이어에서 재생되며 블록 제목이 Live Video에서 Archive로 바뀝니다. Play Live를 누르면 실시간 화면으로 돌아갑니다.

19.3 카메라 업데이트

  1. Cameras를 엽니다.
  2. 카메라를 찾습니다.
  3. Edit를 클릭합니다.
  4. 필요한 필드를 업데이트합니다.
  5. Save를 클릭합니다.

19.4 카메라를 도어락에 연결

  1. Cameras를 엽니다.
  2. 카메라를 찾습니다.
  3. Link를 클릭합니다.
  4. 같은 시설의 활성 도어락을 선택합니다.
  5. 작업을 확인합니다.

19.5 도어락에서 카메라 연결 해제

  1. Cameras를 엽니다.
  2. 카메라를 찾습니다.
  3. 연결 해제 작업을 선택합니다.
  4. 작업을 확인합니다.

19.6 카메라 비활성화

  1. Cameras를 엽니다.
  2. 카메라를 찾습니다.
  3. Disable을 선택합니다.
  4. 사유를 입력합니다.
  5. 작업을 확인합니다.

19.7 카메라 삭제

  1. Cameras를 엽니다.
  2. 카메라를 찾습니다.
  3. Delete를 선택합니다.
  4. 작업을 확인합니다.

19.8 RTSP 카메라 스트림 시작 또는 중지

  1. Cameras를 엽니다.
  2. RTSP 카메라를 찾습니다.
  3. 작업 메뉴를 엽니다.
  4. Start stream 또는 Stop stream을 선택합니다.

19.9 RTSP 카메라 접근 권한 공유

카메라를 공유받는 모든 사람은 다음 두 역할 중 하나를 받습니다:

  • Viewer — 실시간 영상을 봅니다.
  • Manager — 실시간 영상과 녹화된 영상(아카이브)을 봅니다.

Manager 역할은 녹화 기능과 마찬가지로 구독의 Video archive 옵션과 함께 제공됩니다(19.11 참조). 이 옵션이 없으면 카메라를 공유받는 모든 사람은 Viewer이며, 대화 상자에 관리자 권한에는 이 옵션이 필요하다고 표시됩니다.

  1. Cameras를 엽니다.
  2. RTSP 카메라를 찾습니다.
  3. Manage access를 선택합니다.
  4. 카메라를 Manager로 공유하려면 Add a manager role을 선택합니다. Viewer로 공유하려면 선택하지 않은 상태로 둡니다.
  5. 사용자를 선택합니다. 사용자 필드는 검색 상자이므로 이름, 이메일 또는 전화번호를 입력하기 시작하면 아래 목록이 입력에 따라 좁혀집니다. Settings → Defaults에서 Show the address when choosing a user가 켜져 있으면(23.5 참조) 각 사람의 주소가 이름 위에 표시되고 주소로도 검색할 수 있습니다.
  6. 사용자를 추가하여 접근 권한을 공유합니다.
  7. 이미 접근 권한이 있는 사람의 역할을 바꾸려면 이름 옆에서 Viewer 또는 Manager를 선택합니다.
  8. 접근 권한을 제거하려면 사용자 옆에서 권한을 취소합니다.

한 주소에 거주하는 모든 사용자와 카메라를 한 번에 공유하려면 Grant by address를 켭니다. 주소를 선택하고, 미리 선택된 거주자를 유지한 다음(해당 주소의 모든 사용자가 선택된 상태로 시작하며, 제외할 사용자는 선택 해제) 한 번에 추가합니다. Add a manager role 상자는 이들에게도 적용됩니다.

구독에서 Video archive 옵션이 빠지면 모든 Manager는 자동으로 Viewer로 바뀌고, 목록에는 구독에 옵션이 포함되면 다시 관리자가 된다고 표시됩니다. 옵션이 다시 포함되면 아무도 카메라를 다시 공유하지 않아도 Manager 역할을 되찾습니다.

19.10 카메라 상태

모든 RTSP 카메라 타일의 왼쪽 아래 모서리에는 상태 칩이 있으며, 카메라 창에는 같은 상태가 보고된 시각과 함께 표시됩니다. 상태는 비디오 박스가 지금 카메라에 대해 보고하는 내용입니다:

  • Live — 카메라가 스트리밍 중입니다.
  • Ready — 아무도 보고 있지 않아 박스가 영상을 일시 중지했습니다. 첫 Play Live에서 다시 시작됩니다. 정상적인 카메라입니다.
  • Connecting / Restarting — 박스가 영상을 준비하고 있습니다. 잠시 기다리세요.
  • Picture frozen / No picture — 박스가 카메라로부터 사용할 수 있는 영상을 받지 못하고 있습니다. 카메라와 연결 정보를 확인하세요.
  • Setting up — 방금 추가한 카메라를 비디오 박스에 연결하는 중입니다. 보통 1분이 걸리지 않습니다. Setup failed로 끝나면 이유와 함께 Retry 버튼이 표시됩니다.
  • Reconnecting — 카메라가 연결된 비디오 박스가 방금 다시 시작되었습니다. 카메라는 몇 분 안에 자동으로 돌아옵니다.
  • Not placed / Not running — 카메라가 어떤 비디오 박스에도 연결되어 있지 않거나, 박스가 카메라를 실행하고 있지 않습니다. 다시 시작하려면 Retry를 누르세요.
  • Video box silent — 비디오 박스가 보고를 멈췄습니다. 다시 연결될 때까지 영상을 볼 수 없을 수 있습니다.
  • Stopped — Stop stream으로 스트림이 중지되었습니다. 다시 시작하려면 Start stream을 선택하세요(19.8 참조).

그 밖의 값은 박스가 보고한 그대로 표시됩니다. 상태 옆의 시간("5분 전")은 박스가 마지막으로 보고한 시각을 뜻하며, 카메라 창의 미리보기는 마지막으로 캡처된 프레임이고 그 경과 시간이 함께 표시됩니다. Cameras 페이지가 열려 있는 동안 상태는 자동으로 업데이트됩니다. 비디오 서비스가 변경이 생길 때마다 바로 보고하므로 페이지를 새로 고칠 필요가 없습니다.

19.11 RTSP 카메라 영상 녹화

녹화는 구독 패키지의 Video archive 옵션(3, 7, 14 또는 30일)에 포함됩니다. 이 옵션이 없으면 카메라 창의 Recording 블록이 잠기고, Unlock을 누르면 구독 페이지가 열립니다.

  1. Cameras를 열고 RTSP 카메라를 엽니다.
  2. Recording 블록에서 녹화 영상을 얼마나 보관할지 — Off 또는 패키지가 허용하는 범위 내의 일수 — 를 선택하고 Save를 클릭합니다.
  3. 녹화하려면 스트림이 실행 중이어야 합니다. 카메라가 중지되어 있거나 아직 설정 중이면 먼저 Start stream으로 시작하세요.

아카이브에 보관하려는 일수보다 더 많은 영상이 이미 있으면 포털은 저장 전에 경고하고 두 가지 방법을 제안합니다. 모두 유지(보관 기간을 아카이브 전체를 포함하도록 늘림)하거나, 오래된 영상을 삭제하고 더 짧은 기간을 유지합니다. 녹화를 끄더라도 아무것도 삭제되지 않습니다. 이미 녹화된 영상은 만료될 때까지 남아 있습니다. 녹화 중인 카메라의 타일에는 일수가 적힌 빨간색 칩이 표시됩니다. 패키지에서 옵션이 사라졌을 때 카메라가 이미 녹화 중이었다면, 잠긴 블록이 아직 보관 중인 일수를 알려주고 Turn recording off를 제공합니다.

19.12 녹화 영상 보기(아카이브)

아카이브는 녹화와 같은 Video archive 옵션에 포함됩니다. 패키지에 이 옵션이 있으면 RTSP 카메라 창의 Recording 아래에 Archive 블록이 표시됩니다.

  1. Cameras를 열고 RTSP 카메라를 엽니다.
  2. Archive 블록에서 날짜를 선택합니다. 아래의 막대는 그 날의 24시간입니다. 녹색 구간은 녹화된 영상이고, 빈 곳은 아무것도 녹화되지 않은 시간입니다(스트림이 중지되었거나, 카메라가 대기 상태였거나, 영상이 만료된 경우).
  3. 막대에서 원하는 시점을 클릭합니다. 플레이어가 그 시점부터 재생을 시작하며, 빈 곳을 클릭하면 다음 녹화 구간부터 시작합니다.

재생은 최대 한 시간 단위의 창으로 진행되며 그 날의 다음 구간으로 자동으로 이어집니다. 막대의 빨간 커서가 현재 위치를 따라갑니다. Stop을 누르면 재생이 끝납니다. 녹화 영상은 창의 플레이어에서 재생되며, 그동안 제목은 Archive가 됩니다. 시청한 각 창은 Logs에 기록됩니다. 날짜와 시각은 사용 중인 컴퓨터의 시계를 따르며, 아카이브는 패키지가 보관하는 일수만큼 거슬러 올라갑니다.

섹션 20

카메라 역할 관리

카메라 역할은 어떤 사용자가 선택한 카메라에 접근할 수 있고 무엇을 할 수 있는지 정의합니다.

20.1 카메라 역할 만들기

  1. Cameras를 엽니다.
  2. Camera Roles 탭을 엽니다.
  3. Create Role을 클릭합니다.
  4. 역할 이름을 입력합니다.
  5. 설명을 입력합니다.
  6. 시설을 선택합니다.
  7. Create Role을 클릭합니다.

20.2 역할에 카메라 추가

  1. 원하는 카메라 역할을 엽니다.
  2. Add Camera를 클릭합니다.
  3. 같은 시설의 카메라를 선택합니다.
  4. 권한을 하나 이상 선택합니다.
  5. Add를 클릭합니다.

20.3 역할에서 카메라 제거

  1. 카메라 역할을 엽니다.
  2. 카메라를 찾습니다.
  3. Remove를 선택합니다.
  4. 작업을 확인합니다.

20.4 카메라 역할에 사용자 할당

  1. 원하는 카메라 역할을 엽니다.
  2. Add User를 클릭합니다.
  3. 같은 시설의 사용자를 선택합니다.
  4. 할당을 확인합니다.

20.5 카메라 역할에서 사용자 제거

  1. 카메라 역할을 엽니다.
  2. 사용자를 찾습니다.
  3. Remove를 선택합니다.
  4. 작업을 확인합니다.

20.6 카메라 역할 삭제

  1. Camera Roles 탭을 엽니다.
  2. 역할을 찾습니다.
  3. Delete를 선택합니다.
  4. 작업을 확인합니다.
섹션 21

활동 로그 검토

Logs → Activity를 열어 접근 이벤트를 검토합니다.

21.1 일상적인 모니터링

기본적으로 활동 목록은 다음과 같이 가장 관련성이 높은 접근 이벤트에 초점을 맞춥니다:

  • 키 승인됨
  • 도어락 잠금 해제됨
  • 열림 미확인
  • 도어락에 키 추가됨
  • 도어락에서 키 제거됨

원격 열기는 도어락이 직접 열렸다고 알린 뒤에만 Lock Unlocked로 표시됩니다. 그 전까지, 그리고 도어락이 끝내 확인하지 않으면 요청은 보낸 사람과 함께 Open Not Confirmed로 표시됩니다.

21.2 고급 세부 정보

더 자세한 이벤트 정보가 필요하면 필터 모음의 Advanced 토글을 켭니다.

21.3 활동 로그 필터링

사용 가능한 필터는 다음과 같습니다:

  • 도어락
  • 이벤트 유형
  • 날짜 범위(시작/종료)
  • 키 UUID
  • 사용자 이메일
  • 위치
  • 고급 토글

필터를 적용하면 목록이 업데이트됩니다.

필터 위의 Search 상자는 하나의 검색어로 이벤트를 찾습니다: 사용자의 이름, 이메일, 전화번호 또는 주소, UUID(장치, 사용자 또는 키의), 장치의 이름 또는 일련번호. 전화번호와 주소는 숫자만으로도 검색됩니다. Enter 키, 검색 버튼 또는 Apply Filters를 눌러 검색을 실행하고, ×를 누르면 지워집니다. 검색은 다른 필터와 함께 적용되어 드롭다운 목록을 좁히며, Export CSV에도 적용됩니다.

21.4 활동 로그 내보내기

  1. Logs → Activity를 엽니다.
  2. 필요한 필터를 적용합니다.
  3. Export CSV를 클릭합니다.
  4. 파일을 저장합니다.
섹션 22

감사 로그 검토

Logs → Audit를 열어 포털에서 수행된 관리 작업을 검토합니다.

각 행에는 작업을 수행한 사람(Performed by)과 작업 대상(Target user, 해당 사용자의 이메일 또는 전화번호 포함)이 표시됩니다. 대상 사용자로 필터링하면 한 사람의 이력을 따라갈 수 있습니다: 언제 만들어졌는지, 언제 Wallet Key나 실물 키가 발급되거나 다른 도어락에 추가되었는지, 언제 모바일 앱 또는 QR 인터콤 접근 권한이 부여되거나 제거되었는지 확인할 수 있습니다. 거부되거나 실패한 키 추가(여러 도어락 추가의 각 도어락 포함)는 실패 상태와 사유가 있는 행으로 표시됩니다. 나중에 해당 사용자가 삭제되더라도 그 사용자에 관한 행은 남아 있으며, 삭제됨으로 표시된 채 이름과 연락처를 계속 보여 주므로 이력이 온전하게 유지됩니다.

Matter 기기도 여기에 기록됩니다. 허브에 기기를 추가하려는 모든 시도마다 Matter Device Commissioning 행이 기록됩니다. 허브가 기기를 페어링하는 동안에는 대기 중이며, 이후 기기 이름과 함께 완료되거나 허브가 보고한 사유와 함께 실패로 표시됩니다. 허브가 끝내 응답하지 않았거나, 허브가 사용 중이거나 오프라인이어서 또는 Hub API가 명령을 거부하여 시도가 거부된 경우에도 마찬가지입니다. 허브에서 제거된 모든 기기마다 Matter Device Removed 행이 기록되며(게이트웨이와 함께 제거되는 Zigbee 기기 포함), 게이트웨이를 통해 나타난 Zigbee 기기에는 Matter Device Joined 행이 기록됩니다.

22.1 감사 로그 필터링

사용 가능한 필터는 다음과 같습니다:

  • 검색(작업을 수행한 사람, 대상 사용자의 이름, 이메일 또는 전화번호, 또는 설명 기준)
  • 작업 유형
  • 상태
  • 도어락
  • 수행자
  • 대상 사용자
  • 날짜 범위(시작/종료)

22.2 결과 정렬 및 페이지 이동

  1. 정렬 가능한 열 제목(타임스탬프, 작업, 상태)을 클릭하여 정렬합니다.
  2. 필요한 경우 페이지당 행 수를 선택합니다.
  3. 페이지 이동 컨트롤을 사용하여 페이지 간에 이동합니다.

22.3 세부 정보 보기

  1. 원하는 작업을 찾습니다.
  2. 행을 클릭하여 세부 정보를 엽니다.
  3. 대상 사용자와 실패한 작업의 경우 사유를 포함하여 사용 가능한 정보를 검토합니다.

22.4 감사 로그 내보내기

  1. 필요한 필터를 적용합니다.
  2. Export CSV를 클릭합니다.
  3. 파일을 저장합니다. 내보낸 파일에는 수행자, 대상 사용자, 대상 연락처 열이 포함됩니다.
섹션 23

설정

Settings를 열어 프로필, 구독, 알림, 접근 요청, 결제, 그리고 SmartphoneKey 팀에 보내는 피드백(34 섹션 참조)을 관리합니다. 각 영역은 페이지 상단의 탭입니다.

23.1 프로필 업데이트

  1. Settings → Profile을 엽니다.
  2. 전체 이름, 전화번호 또는 휴대폰 번호를 업데이트합니다.
  3. Save를 클릭합니다.

이메일 주소는 표시되지만 이 페이지에서 변경할 수 없습니다.

23.2 구독 및 패키지

  1. Settings → Subscription을 엽니다.
  2. 현재 요금제와 상태를 검토합니다.
  3. Available Packages에서 계정에 제공되는 구독 패키지를 검토합니다. 표시되는 패키지는 역할에 따라 다르며, 각 카드에는 가격, 결제 주기, 패키지에 포함된 모든 내용이 표시됩니다.
  4. 패키지의 Buy를 클릭하면 결제 화면이 열립니다. 표준 주문 페이지가 열리고 운영자가 구성한 결제 수단으로 결제합니다. 결제 후 패키지의 기능과 한도가 계정에 적용됩니다.

Base Access. 모든 도어락 소유자는 Base Access 구독을 갖습니다. 여기에는 로그와 감사가 포함된 접근 기록, 게스트 키, 최대 10명의 사용자, Matter 장치 페이지가 포함됩니다. 첫 도어락을 등록하면 첫해는 무료이며, 포털의 환영 메시지가 활성화를 안내합니다. 활성화하려면 Subscription 탭에서 Add payment method를 클릭하고 열리는 결제 페이지에서 카드를 저장합니다. 결제 시스템이 표준 카드 확인을 실행하고 바로 구독이 활성화됩니다. 카드를 추가한 후에도 활성화 배너가 계속 표시되면 Check activation을 클릭하세요.

기간이 정해진 구독은 종료 일주일 전에 포털에 일회성 알림이 표시됩니다. 접근이 중단되지 않도록 Available Packages에서 패키지를 갱신하세요.

계정이 Managed Access Control Service(파트너) 요금제를 사용하는 경우 탭에 Resident Digital Access Package가 포함된 Add-ons 섹션도 표시됩니다. 이 추가 기능은 세대당 Apple / Google Wallet 키 2개, 모바일 앱으로의 인터콤 통화, 게스트 키를 추가합니다. 구매하려면 구매 버튼을 클릭합니다. 추가 기능이 담긴 상점이 열리며, 여기서 세대 수를 설정하고 결제를 완료합니다. 이 추가 기능에는 활성 Managed Access Control Service 구독이 필요합니다.

23.3 사용량 검토

Subscription 탭에는 시설, 도어락, 사용자에 대한 사용량 미터도 표시됩니다.

한도에 가까워지면 경고 표시기에 주의하세요.

23.4 알림 구성

  1. Settings → Notifications를 엽니다.
  2. 사용 가능한 토글을 켜거나 끕니다:
    • Key Pool Alerts
    • Lock Activity
    • Subscription Reminders

변경 사항은 각 옵션을 전환할 때 적용됩니다.

23.5 기본 동작 설정

  1. Settings → Defaults를 엽니다.
  2. 각 항목에 대해 Use default(회사 전체 설정 유지), On 또는 Off를 선택합니다. 선택한 값은 본인의 작업에만 적용됩니다.
  3. Grant access defaults에서 키와 함께 무엇을 제공할지 결정합니다:
    • Grant Mobile App access 및 Grant Intercom access — Wallet Key를 할당할 때 적용됩니다. 둘 다 기본적으로 켜져 있습니다.
    • Give a physical key with Mobile App access 및 Give a physical key with Intercom access — 실물 키를 발급할 때 적용됩니다. 실물 카드는 그 자체로 도어락을 열며 요청하지 않는 한 어떤 종류의 접근 권한도 함께 제공하지 않으므로, 둘 다 기본적으로 꺼져 있습니다.
  4. Display에서 포털에 표시할 내용을 결정합니다:
    • Show the Physical Keys column on the Users page — 기본적으로 꺼져 있습니다. 켜면 각 사용자가 보유한 실물 카드 수를 세는 열이 추가됩니다(9.3 참조).
    • Show the address when choosing a user — 기본적으로 꺼져 있습니다. 켜면 Assign Key 마법사(여기서는 Show address의 초기 상태도 정합니다, 11.2 참조)와 카메라의 Manage access 창(19.9 참조)에서 사용자를 선택할 때 각 사람의 주소가 이름 위에 표시되고 주소로도 검색할 수 있습니다.
  5. 이메일 섹션에서는 각 이벤트가 여기서 활성화된 경우에만 메시지를 보냅니다(기본적으로 모두 꺼짐). 여기에는 새로 만든 사용자가 받는 환영 이메일도 포함됩니다(9.1 참조).
  6. Save를 클릭합니다.

23.6 결제 검토

  1. Settings → Billing을 엽니다.
  2. 송장을 검토합니다.
  3. 목록에서 송장 PDF를 엽니다.

송장을 열 수 없으면 다시 로그인하거나 관리자에게 문의하세요.

섹션 24

접근 요청 검토 및 승인

역할에 따라 설치 기사나 Community Manager로부터 요청을 받을 수 있습니다.

24.1 요청 승인

  1. Settings → Access Requests를 엽니다.
  2. 수신 요청에서 요청을 찾습니다.
  3. 요청 유형, 시설 또는 도어락 목록, 요청 기간, 사유를 검토합니다.
  4. 이 옵션이 표시되면 승인 기간을 조정합니다.
  5. Approve를 클릭합니다.

24.2 요청 거부

  1. Settings → Access Requests를 엽니다.
  2. 수신 요청에서 요청을 찾습니다.
  3. Reject를 클릭합니다.
  4. 작업을 확인합니다.

24.3 제출한 요청 검토

Settings → Access Requests에서 제출한 요청 목록을 검토하여 본인의 요청이 대기 중인지, 승인되었는지, 거부되었는지 확인합니다.

섹션 25

임시 설치 기사 접근 요청

다른 사용자가 소유한 선택된 도어락에 임시로 접근해야 할 때 이 페이지를 사용합니다.

  1. 설치 기사 접근 요청 페이지를 엽니다.
  2. 소유자의 이메일 주소를 입력합니다.
  3. 도어락 일련번호를 하나 이상 입력합니다.
  4. 요청 기간을 입력합니다.
  5. 사유를 입력합니다.
  6. 요청을 제출합니다.
  7. 소유자가 승인하거나 거부할 때까지 기다립니다.
  8. 제출한 요청 목록에서 상태를 확인합니다.
섹션 26

시설 관리 접근 요청

자격이 있는 Community Manager는 다른 시설에 대한 접근을 요청할 수 있습니다.

  1. 시설 관리 접근 요청 페이지를 엽니다.
  2. 소유자의 이메일 주소를 입력합니다.
  3. 시설 코드를 입력합니다.
  4. 요청을 제출합니다.
  5. 승인을 기다립니다.
  6. 제출한 요청 목록에서 상태를 확인합니다.
섹션 27

문제 해결

메뉴 섹션이 없음

해당 섹션이 역할에 포함되어 있지 않을 수 있습니다. 접근이 필요하다고 판단되면 관리자에게 문의하세요.

잘못된 시설의 데이터가 표시됨

시설 선택기를 사용하여 올바른 시설을 선택합니다. 페이지가 새로고침될 때까지 기다립니다.

버튼이 비활성화됨

포털에 표시된 메시지를 읽으세요. 해당 작업에는 다음이 필요할 수 있습니다:

  • 다른 역할
  • 활성 사용자
  • 활성 도어락
  • 사용 가능한 Wallet Key
  • 유효한 장치 상태
  • 선택된 시설
  • 완료된 사전 단계(예: 접근 버튼이 표시되려면 도어락에 키가 있어야 함)

원격 도어락 작업이 실패함

도어락 상태와 마지막 활동 시각을 확인합니다. 포털이 반복 명령을 일시적으로 차단하는 경우 카운트다운이 끝난 후 다시 시도하세요.

실물 카드가 제대로 프로그래밍되지 않음

다음을 확인하세요:

  • 올바른 도어락과 사용자가 선택되어 있습니다.
  • 올바른 프로그래머 장치가 선택되어 있습니다.
  • 올바른 카드 유형(MIFARE Classic 또는 DESFire EV3)이 선택되었습니다.
  • 카드를 프로그래머에 갖다 댔습니다.
  • 장치의 표시 후에 Done을 클릭했습니다.

송장이 열리지 않음

다시 로그인하고 다시 시도하세요. 문제가 계속되면 관리자에게 문의하세요.

섹션 28

새 관리자를 위한 빠른 체크리스트

  1. 계정을 등록하고 첫 도어락을 등록합니다.
  2. SPK Portal에 로그인합니다.
  3. 현재 시설을 확인합니다.
  4. 대시보드를 검토합니다.
  5. 필요한 경우 시설을 추가로 만듭니다.
  6. Local Admin을 추가합니다.
  7. 사용자를 만듭니다.
  8. 도어락(Devices → Locks)과 허브(Devices → Hubs)를 추가합니다.
  9. Wallet Key, QR 인터콤 접근 또는 실물 키를 할당합니다.
  10. 필요한 경우 도어락 일정을 구성합니다.
  11. 사용하는 경우 Matter 장치와 카메라를 추가합니다.
  12. 활동 및 감사 로그를 검토합니다.
  13. 알림을 구성합니다.
  14. 사용량과 Wallet Key 잔액을 정기적으로 검토합니다.
섹션 29

중요 참고 사항

  • 사용 가능한 섹션은 역할과 권한에 따라 다릅니다.
  • 변경하기 전에 항상 선택된 시설을 확인하세요.
  • 리소스를 삭제하기 전에 확인 메시지를 주의 깊게 읽으세요.
  • Local Admin은 Wallet Key를 받을 수는 있지만 구매할 수는 없습니다.
  • 포털에서 Matter 장치를 제거해도 실제 장치가 초기화되지 않을 수 있습니다.
  • 방문자 접근에는 영구 사용자 키 대신 임시 게스트 키를 사용하세요.
섹션 30

AI 어시스턴트(챗봇)

선택 기능인 AI 어시스턴트는 포털에 관한 질문에 답하고 사용자를 대신해 장치를 조작할 수 있습니다. 시스템 관리자가 전역적으로 활성화하며, 켜져 있으면 SPK Portal 오른쪽 하단에 "AI" 글자가 있는 SmartphoneKey 리더 모양의 버튼이 나타납니다. 휴대폰에서는 채팅이 전체 화면으로 열립니다.

어시스턴트와 채팅하기:

  1. 채팅 버튼을 클릭하여 어시스턴트 패널을 엽니다.
  2. 질문이나 요청을 입력하고 Enter 키를 누릅니다(또는 보내기 버튼 클릭).
  3. 어시스턴트는 이 사용자 가이드와 실제 장치 데이터를 바탕으로 답변합니다.

장치 작업. 사용할 수 있는 장치에 대한 작업을 어시스턴트에게 요청할 수 있습니다. 예:

  • "현관문 도어락을 열어 주세요."
  • "복도 조명을 켜 주세요."
  • "거실 조명을 50%로 설정해 주세요."

명령은 즉시 실행됩니다. 어시스턴트가 장치를 찾아 요청된 작업을 실행하고 채팅에 결과를 보고합니다.

장치 제어 그 이상. 어시스턴트는 다음 작업도 할 수 있습니다:

  • 도어락의 임시 게스트 키를 만들고 접근 링크를 지정한 주소로 보냅니다. 예: "사무실 문의 임시 키를 3일간 발급하고 john@example.com으로 보내 주세요". 어시스턴트가 이메일 발송 여부를 알려 주며, 답변 아래에 키의 QR 코드가 저장 버튼과 함께 표시됩니다.
  • 도어락의 게스트 Wallet Key를 발급합니다. 예: "사무실 문의 게스트 Wallet Key를 anna@example.com에게 24시간 동안 발급해 주세요". 어시스턴트는 게스트 키 창의 Wallet Key 모드(12절)와 같은 키를 발급하고, 수신자에게 이메일로 보내며, 답변 아래에 Wallet Key의 QR 코드를 표시합니다. 수신자가 아직 도어락 시설의 사용자가 아니면 어시스턴트가 그 사람의 이름을 묻고, 창의 + 양식처럼 먼저 사용자를 만듭니다.
  • Matter 기기의 시나리오를 만듭니다. 예: "복도 동작 감지기가 움직임을 감지하면 복도 조명을 켜 줘" 또는 "평일 18:30에 현관 조명을 켜 줘". 어시스턴트는 Simple 편집기(31절)와 같은 방식으로 시나리오를 만들어 허브로 보내고 허브의 응답을 알려 줍니다. 시나리오 목록을 보여 주거나 켜고 끌 수도 있습니다.
  • 장치의 센서 값을 읽습니다. 예: "주방 온도는 몇 도인가요?"
  • 접근 기록을 검색합니다. 예: "오늘 오후 3시에서 5시 사이에 누가 문을 열었나요?"
  • 새 카메라를 등록합니다. 예: rtsp:// 링크를 붙여넣으면 어시스턴트가 누락된 세부 정보(카메라 유형 등)를 묻고 카메라를 만듭니다.
  • 사용자를 관리합니다. 예: "Anna Petrenko, anna@example.com 사용자를 만들어 주세요", 전화번호 기반 제한 사용자 만들기, 사용자 비활성화 또는 다시 활성화.
  • 접근 권한을 부여하고 취소합니다. 예: 이메일로 사용자에게 디지털 키 발급, 모바일 앱 및 인터콤 접근 권한 부여 또는 취소, RTSP 카메라를 사용자와 공유.
  • 장치를 등록합니다. 예: 일련번호와 페어링 코드로 새 도어락 추가, 도어락 이름 바꾸기, 숫자 페어링 코드로 허브를 통해 Matter 장치 추가.
  • 이름과 짧은 코드로 새 시설(조직)을 만듭니다.
  • 접근 기록의 다운로드 가능한 CSV 보고서를 준비합니다. 예: "어제 누가 문을 열었나요?" — 채팅 안에 바로 다운로드 버튼이 표시됩니다.

음성 입력. 음성 입력이 구성되어 있으면 메시지 상자 옆에 마이크 버튼이 나타납니다. 말하는 동안 버튼을 길게 누르고 있다가 손을 떼면 인식된 명령이 어시스턴트에게 자동으로 전송됩니다. 짧게 탭하면 녹음되지 않고 말하는 동안 버튼을 누르고 있으라는 안내가 표시됩니다.

참고:

  • 어시스턴트는 계정이 접근할 수 있는 도어락과 장치만 볼 수 있으며, 포털에서 직접 할 수 있는 것 이상은 절대 수행할 수 없습니다.
  • 관리자가 설정한 월간 사용 한도에 도달하면 어시스턴트를 일시적으로 사용할 수 없을 수 있습니다.
섹션 31

시나리오

Scenarios 페이지에서는 한 장치가 다른 장치에 반응하도록 할 수 있습니다. 여기서 만든 시나리오는 Matter 허브가 실행합니다. 시나리오는 트리거(장치가 보고하는 상황 또는 특정 시각)와 트리거가 발생했을 때 허브가 장치에서 수행하는 작업으로 구성됩니다.

위치. 시나리오 빌더는 기본 메뉴에 항목이 없습니다. Devices → Matter Devices를 열고 페이지 헤더의 Scenarios 버튼을 사용합니다. 이 페이지는 구독의 일부로, 패키지 중 하나에 Scenario editor 기능이 포함되면 사용할 수 있게 됩니다.

두 가지 편집기. 새 시나리오는 모바일 앱의 시나리오 생성기와 완전히 동일하게 작동하는 Simple 편집기에서 열립니다. Advanced 편집기는 여러 트리거, 조건, 지연 또는 장치 그룹이 있는 시나리오를 위한 블록 캔버스입니다. 편집기 헤더의 Simple / Advanced 컨트롤로 둘 사이를 전환합니다. Simple 시나리오는 언제든지 Advanced 편집기에서 열 수 있지만, Advanced 시나리오는 트리거 하나와 작업 하나로만 구성된 동안에만 Simple로 되돌아갈 수 있습니다.

Simple 편집기. 시나리오에 이름을 지정한 다음 두 카드를 채웁니다. When — 장치, 장치가 보고하는 이벤트(접촉, 누수, 움직임, 연기, 도어락 상태, 전원, 버튼, 온도, 습도, 조도, 공기질, 배터리 등), 조건(*이다*, *아니다*, *변경됨*; 측정값의 경우 *초과*, *미만* 또는 *같음*), 값을 선택합니다. Then — 장치와 장치가 수행할 동작(켜기, 끄기, 전환, 잠금, 잠금 해제, 밸브 또는 블라인드 열기/닫기, 25 / 50 / 75 / 100 % 사전 설정으로 밝기 설정)을 선택합니다. More settings에는 설명, 허브, 시간대, 실행 설정이 있습니다. 장치 목록과 장치를 선택한 후의 When / Then 카드에서 모든 장치는 Matter 장치 페이지의 카드와 같은 아이콘과 색상을 갖습니다.

Advanced 편집기. 왼쪽 패널에서 블록을 캔버스로 끌어다 놓고, 한 블록의 오른쪽 가장자리에서 다른 블록의 왼쪽 가장자리로 끌어 연결합니다. 블록을 선택하면 오른쪽 패널에서 구성할 수 있습니다.

  • Triggers는 시나리오를 시작합니다: Device event(Simple 편집기와 동일한 장치 속성, 조건, 값에 더해 장치가 보고하는 모든 속성을 위한 *Other attribute…*) 또는 Schedule(시각과 요일).
  • Condition은 규칙이 모두(또는 하나라도) 충족되어야 하는 선택적 보호 조건입니다: 장치 속성, 시간 창, 요일 또는 매년 반복되는 날짜 범위. 각 규칙은 Not으로 부정할 수 있습니다.
  • Actions는 허브가 수행하는 작업입니다: 장치 명령(장치가 허용하는 모든 명령을 위한 *Other command…*와 그 매개변수 포함), 선택적 전환이 있는 밝기, 점진적 램프 또는 지연. 명령은 장치 하나 또는 그룹(모든 조명, 모든 플러그와 스위치)을 대상으로 할 수 있습니다. 허브는 작업을 차례로 실행하므로, 여러 분기가 있을 때 지연은 마지막 분기에만 둘 수 있습니다.
  • Keep until은 조건이 참이 되면 종료 작업을 실행합니다. 예를 들어 방이 시원해질 때까지 에어컨 플러그를 켜 둡니다. 허브는 이를 두 번째 시나리오로 받습니다.

시나리오 설정(블록이 선택되지 않았을 때 표시됨)에는 설명, 허브, 모든 시간 창, 요일, 날짜 범위가 따르는 시간대, 실행 중에 다시 트리거될 때 수행할 동작(무시, 작업 다시 시작, 실행 대기열에 추가, 병렬 실행), 작업 전에 조건을 다시 확인하는 디바운스, 두 실행 사이의 쿨다운, 전체 작업 목록에 대한 타임아웃이 있습니다.

게시와 허브의 응답. Validate는 시나리오를 확인하고 문제가 있는 블록을 강조 표시합니다. Save는 허브를 건드리지 않고 초안을 저장합니다. Publish는 시나리오를 허브로 보내고 허브가 이를 확인합니다. 이름 옆의 배지에 *허브로 보내는 중…*, 그다음 *허브에서 실행 중* 또는 허브의 사유와 함께 *허브에서 거부됨*이 표시됩니다. 허브가 응답하지 않으면 배지에 그렇게 표시되며 Resend로 시나리오를 다시 보냅니다. 게시된 시나리오를 편집하면 Modified로 표시되며, 다시 게시할 때까지 허브는 이전 버전을 유지합니다. 시나리오의 스위치는 아무것도 삭제하지 않고 허브에서 시나리오를 활성화하거나 비활성화합니다. Unpublish는 허브에서 시나리오를 제거하고 초안은 유지합니다.

참고:

  • 시나리오는 같은 허브에 커미셔닝된 장치만 사용할 수 있으며, 제거 중인 장치는 편집기에서 사라집니다.
  • 측정값은 일상적인 단위(°C, %, lux)로 입력하며, 포털이 시나리오를 보낼 때 허브 고유의 단위로 변환합니다.
  • 블록, 규칙, 작업의 수에는 제한이 있으며, 한도에 도달하면 검증에서 알려 줍니다.
섹션 32

지원 구성기(Support Configurator)

모바일 앱의 Support 버튼은 Admin Panel이 제공하는 지원 페이지를 엽니다. 이 페이지가 회사의 도어락을 사용하는 사용자에게 표시하는 내용은 백오피스의 Configuration → Support Configurator에서 설정합니다. 구성은 회사당 하나이며, 메뉴는 회사의 레코드를 바로 엽니다.

모드. *Simple* 모드는 연락 채널, 근무 시간, 지원 주소로 이메일을 보내는 Leave a message 양식을 표시합니다. *Advanced* 모드는 회사 자체 지원 담당자를 위한 요청 데스크와 선택적 AI 어시스턴트를 추가합니다.

언어. Support page language는 기본적으로 *사용자 언어 따르기*로 설정되어 있어 페이지가 앱이 실행되는 언어(또는 계정의 언어)로 열립니다. *고정 언어*를 선택하고 포털 언어 중 하나를 고르면 앱 설정과 관계없이 모든 사용자에게 해당 언어로 페이지가 표시됩니다.

Contacts 탭. 사용하는 채널만 입력하세요. 각 채널은 휴대폰에서 탭하여 여는 카드가 됩니다:

  • Emergency phone (24/7) — 가장 먼저 나열되며 24시간 이용 가능으로 표시됩니다.
  • Phone 및 Email.
  • WhatsApp, Viber, Signal — 국제 형식의 번호이며, 페이지에서 해당 번호와의 채팅이 열립니다.
  • Telegram — 사용자 이름(예: `@acme_support`) 또는 `t.me` 링크.
  • Facebook Messenger — 페이지 이름 또는 `m.me` 링크.
  • Website / help center — 추가 도움말이 있는 페이지 링크.
  • Office address — 휴대폰의 지도 앱에서 열립니다.

링크가 될 수 없는 값(공백이 있는 사용자 이름, `http`/`https`가 아닌 주소)은 저장할 때 거부되며, 메시지에 해당 채널이 표시됩니다.

Working Hours 탭. Show working hours를 켜 두면 선택한 시간대로 계산된 Open now / Closed now 표시와 함께 주간 일정이 표시됩니다. 요일을 휴무로 표시하거나 여는 시각과 닫는 시각을 설정합니다.

Message Form 탭. 양식이 켜져 있으면 페이지에 남겨진 모든 메시지가 발신자의 이름, 이메일, 전화번호와 함께 Send messages to(이 필드가 비어 있으면 지원 이메일)로 전송되므로 직접 답장할 수 있습니다. Simple 모드에서는 양식에 보낼 주소가 필요합니다. 따라서 연락처 카드에 이메일이 없는 회사의 경우 양식이 꺼진 상태로 시작하며, 주소를 입력하거나 요청이 대신 데스크로 가는 Advanced 모드를 선택하는 즉시 다시 켜집니다.

미리 보기. 양식 헤더의 Preview Support Page는 사용자가 앱에서 보는 것과 똑같이 페이지를 엽니다.

Support Desk 탭(Advanced 모드). Advanced 모드에서는 페이지에 남겨진 메시지가 이메일을 보내는 대신 요청을 엽니다. 이 탭에서는 Support Desk(33 섹션)에서 요청에 답변할 담당자, 즉 User 이상의 역할(Portal Tier 2, Customer, Installer, Community Manager, Local Admin 또는 사용자 지정 Customer 역할)을 보유한 회사의 포털 사용자를 선택합니다. 또한 새 요청에 대해 담당자에게, 답변에 대해 요청자에게 이메일을 보낼지, 답변되지 않은 요청을 몇 시간 후에 다시 알릴지, 해결된 요청이 며칠 후에 자동으로 닫힐지, 한 사람이 동시에 열어 둘 수 있는 요청 수(1~10), 요청자에게 평가를 요청할지, 담당자가 삽입할 수 있는 정형 답변을 결정합니다. 양식 모서리의 Requests 버튼은 회사의 요청을 나열합니다. Chat 그룹에는 Offer a chat with the support team이 있습니다. 이 옵션을 켜면 지원 페이지에 어시스턴트와 같은 스타일의 채팅 창이 표시되어 사용자가 지원팀에 글을 쓸 수 있습니다. 첫 메시지는 요청을 열고(출처 *지원 채팅*), 이후 메시지는 그 요청에 이어지며, Support Desk에서 한 답변이 창에 표시됩니다. It is solved는 요청을 해결 처리합니다. 어시스턴트가 활성화되어 있으면 어시스턴트 창이 채팅 창의 자리를 대신합니다.

Assistant 탭(Advanced 모드). AI assistant를 켜면 지원 페이지 상단에 채팅이 추가됩니다. 어시스턴트는 SmartphoneKey 모바일 앱 지식 베이스(앱의 모든 화면, 메시지, 제한에 대한 상세 설명과 문제 해결 표), 위의 연락처와 근무 시간, 이 탭에 입력하는 Company FAQ(질문과 답변 쌍, 그대로 인용됨)를 바탕으로 답변합니다. 어시스턴트는 모든 질문을 먼저 모바일 앱에 관한 질문으로 취급합니다. 답변하기 전에 지식 베이스에서 해당 사안을 찾아보고 사용자의 키, 도어락 상태, 최근 출입 이벤트를 확인하며, 지식 베이스에 내용이 없는 경우에만 일반적인 조언을 제공하고, SmartphoneKey와 관련 없는 질문에는 답변 대신 요청을 남기라는 제안(또는 아래에서 선택한 대로 연락처)으로 바로 응답합니다. 어시스턴트는 사용자 본인의 키와 이벤트만 볼 수 있고, 문을 열거나 접근 권한을 변경할 수 없으며, 자유 형식 프롬프트는 없습니다. 동작은 옵션으로 구성됩니다: 어조와 답변 길이, 언어(사용자 언어 따르기 또는 고정 언어), 사용할 수 있는 지식 베이스 주제(읽는 방법, 앱이 무엇이고 무엇을 하지 않는지는 항상 포함됨), 사용자를 위해 할 수 있는 작업(키와 상태 표시, 최근 출입 이벤트 표시, 도어락 온라인 여부 표시, Wallet 키 이메일 다시 보내기, 요청 열기), 인계 시점(요청 제안, 연락처 표시 또는 둘 다; 답변하지 못한 대화가 일정 횟수를 넘으면 담당자 제안; 긴급 단어가 나오면 긴급 전화를 먼저 표시; 근무 시간 외에는 계속 답변하거나 연락처와 양식만 남김), 그리고 한도(사용자당 하루 메시지 수(20, 50 또는 100)와 대화당 메시지 수(10~30))로, 채팅이 몇 시간씩 이어지지 않고 기술적인 질문을 해결하고 메시지를 남길 수 있게 합니다. 회사는 Settings의 전역 설정 대신 자체 LLM API 키, URL, 모델로 어시스턴트를 실행할 수 있으며, 월간 토큰 예산을 선택적으로 설정할 수 있습니다. 이번 달에 사용한 토큰은 탭에 표시됩니다. 사용자가 요청을 남기면 채팅이 요청에 첨부되어 데스크에서 이미 오간 내용을 볼 수 있으며, 데스크 통계에는 어시스턴트가 스스로 해결한 사안의 비율이 표시됩니다.

사용자에게 보이는 내용. 사용자는 앱의 Profile 탭에서 페이지를 열고 자신이 속한 시설을 운영하는 회사의 연락처를 봅니다. 이메일 없이 전화번호만으로 앱을 사용하는 사용자는 앱이 대신 요청하는 서명된 링크를 통해 같은 페이지에 도달합니다. 이 링크는 자동으로 만료되며, 지원 이메일 안의 링크도 같은 방식으로 발급됩니다. 회사가 구성을 입력하기 전까지 페이지에는 시스템 관리자가 Settings → Support에 입력한 SmartphoneKey 지원 연락처가 표시되므로 아무도 빈 페이지를 보지 않습니다. 페이지는 앱의 언어를 따르지만, Support Configurator 상단의 Support page language가 모든 사용자에게 하나의 고정 언어로 고정한 경우는 예외입니다.

섹션 33

Support Desk

Support Desk는 Support Configurator에서 선택한 담당자가 모바일 지원 페이지에 남겨진 요청에 답변하는 곳입니다. 담당자는 포털 홈의 SmartphoneKey Portal 카드 아래에 있는 Support Desk 카드에서 접근하며, 카드에는 대기 중인 새 요청 수가 표시됩니다. 관리자는 포털 Dashboard에서 같은 수치를 볼 수 있습니다. Support Requests 타일에 상태별 열린 요청과 첫 답변까지의 평균 시간이 표시됩니다.

목록. 요청은 Open, Unread, Mine, New, In progress, Waiting for user, Resolved, Closed, All 탭으로 그룹화되며, 검색 상자(제목, 이름, 이메일, 전화번호 또는 요청 번호), 정렬 순서, 현재 목록의 CSV 내보내기가 있습니다. 여러 회사를 담당하는 담당자는 헤더에서 회사를 선택하며, 헤더에는 인터페이스 언어 선택기와 테마 스위치도 있습니다. 헤더에는 최근 30일의 정보도 표시됩니다: 열린 요청과 새 요청, 평균 첫 답변 시간과 해결 시간, 평균 평가, AI 어시스턴트가 해결한 요청의 비율.

요청. 요청을 열면 대화(요청자의 메시지, 담당자의 답변, 내부 메모, 있는 경우 어시스턴트의 대화 기록)와 요청자 패널(이름, 시설, 주소, 전화번호, 이메일, 계정 종류, 사용자가 보유한 키와 도어락)이 표시됩니다. 그 아래의 Open the SmartphoneKey Portal은 해당 사용자의 사용자 정보 창으로 바로 포털을 엽니다. 헤더에서 요청을 Take(담당)하거나 Resolve(해결)하거나 Status, Priority, Category, Agent를 변경합니다.

답변하기. 답변 상자에 내용을 작성하고 Send answer를 클릭합니다. 요청자는 자신의 요청 페이지에서 답변을 보고, 이메일 주소가 있으면 이메일도 받습니다. 다른 담당자만 볼 수 있는 메모를 남기려면 Internal note를 선택합니다. Insert a canned reply는 구성에서 미리 준비된 텍스트 중 하나를 추가하고, Attach는 최대 세 개의 사진 또는 PDF 파일을 추가합니다. 채팅 창에서 열린 요청(출처 *지원 채팅*)에 대한 답변은 지원 페이지의 해당 창에도 표시됩니다.

수명 주기. 새 요청은 첫 답변과 함께 In progress가 됩니다. Waiting for user는 요청자의 응답을 기다리고 있음을 뜻합니다. Resolved 요청은 요청자가 다시 글을 써서 요청을 다시 열지 않는 한 구성된 일수가 지나면 자동으로 닫힙니다. 해결되면 요청자에게 1에서 5까지 도움에 대한 평가를 요청하며, 평가는 요청과 통계에 표시됩니다.

섹션 34

Feedback & Suggestions

Settings → Feedback & Suggestions에서 SmartphoneKey 팀에 무엇을 추가하거나 개선하면 좋을지 전하고, 각 아이디어가 어떻게 처리되는지 확인할 수 있습니다. 이 탭에는 보낸 모든 피드백이 나열되며, 팀의 답변은 각 항목 안에 표시됩니다.

34.1 피드백 남기기

  1. Settings → Feedback & Suggestions를 열고 New feedback을 클릭합니다.
  2. 피드백 종류를 선택합니다: Idea(새로 있었으면 하는 기능), Improvement(이미 있지만 더 나아질 수 있는 기능), Problem(예상대로 작동하지 않는 것) 또는 Other.
  3. 해당 영역을 선택합니다: 장치 및 도어락, 실물 키, 사용자 및 접근, Wallet Keys, 카메라 및 영상, 인터콤, 허브 및 Matter, Admin Portal, 모바일 앱, 결제 및 구독, 지원 또는 기타.
  4. 짧은 Title(한 줄)을 입력한 다음, 추가하거나 개선하고 싶은 내용, 해결되는 문제, 그리고 원하는 경우 이상적인 작동 방식(기대하는 결과, 다른 제품의 예시, 링크)을 설명합니다.
  5. 얼마나 중요한지 선택합니다: Nice to have, Important 또는 Critical.
  6. 도움이 된다면 스크린샷이나 PDF를 첨부하고(최대 5개, 각 5 MB) Send feedback을 클릭합니다.

이름, 이메일 주소, 회사, 포털에서 선택한 시설은 자동으로 추가되므로 본인에 대해 따로 입력할 내용은 없습니다.

34.2 피드백 진행 상황 확인

이 탭에는 보낸 모든 항목이 최신순으로 상태와 함께 표시됩니다: New, Under review, Planned, In progress, Done 또는 Declined. 카드를 열면 전체 내용, 첨부 파일, 대화를 볼 수 있습니다.

팀이 답변하거나 상태를 변경하면 다음에 포털을 열 때 일회성 알림이 표시됩니다. View를 클릭하면 해당 피드백이 열리고, Later를 클릭하면 알림이 닫힙니다. 항목을 열기 전까지 카드에는 *새 답변* 표시가 남아 있고, Feedback & Suggestions 탭에는 아직 읽지 않은 답변이 있는 항목 수가 표시됩니다.

34.3 팀에 답변하기

피드백을 열고 대화 아래의 Your reply에 내용을 작성한 다음 Send reply를 클릭합니다. 팀은 백오피스에서 답변을 확인하고 같은 대화에서 다시 답변할 수 있습니다.

34.4 피드백 공유 초대

운영자가 피드백을 요청하는 초대를 보낼 수 있습니다: 포털을 열면 일회성 메시지가 표시됩니다. Leave feedback을 클릭하면 새 피드백 양식으로 바로 이동하고, Later를 클릭하면 메시지가 닫힙니다. 이 메시지는 초대당 한 번만 표시됩니다.

섹션 35

Partner Portal

Partner Portal은 통합 파트너, 즉 API를 통해 자체 플랫폼을 SmartphoneKey에 연결하는 회사를 위한 셀프서비스 영역입니다. Admin Portal과는 별개입니다. Partner 역할(SmartphoneKey 팀이 백오피스에서 부여)을 가진 계정은 포털 홈의 SmartphoneKey Portal 카드와 Support Desk 카드 아래에 Partner Portal 카드를 보게 되며, 그 외에는 아무것도 바뀌지 않습니다. 같은 조직에서 이 역할을 가진 모든 계정은 동일한 등록 정보로 작업합니다.

35.1 통합 설정

페이지는 상단에 진행 표시줄로 보이는 세 단계로 안내합니다.

  1. Register organization. Organization name과 Organization ID(소문자, 숫자, 하이픈으로 3~64자)를 입력합니다. 포털은 회사 이름에서 ID를 제안하고 사용 가능한지 확인합니다. 이 ID는 모든 API 호출에서 플랫폼을 식별하며 나중에 변경할 수 없습니다. 계정의 이메일 주소가 소유자로 기록됩니다.
  2. Create API key. 플랫폼이 모든 요청의 X-API-Key 헤더로 보내는 키입니다. 저장했음을 확인해야만 닫을 수 있는 대화 상자에 한 번만 표시되며, 이후 페이지에는 키의 앞부분과 끝부분만 보입니다.
  3. Register webhook. SmartphoneKey가 이벤트를 전달할 플랫폼의 HTTPS 주소와 원하는 이벤트(All events 또는 이벤트 유형 목록)입니다. 웹훅 secret도 한 번만 표시됩니다. 모든 전달에는 X-Webhook-Secret 헤더로 이 값이 실리므로 서버는 이 값이 없는 호출을 거부할 수 있습니다.

admin API가 어떤 단계를 확인하지 않으면 페이지는 그 단계를 반복하는 대신 Finish, Check, Discard 버튼과 함께 미확인 상태로 유지하며, SmartphoneKey는 백오피스에서 같은 내용을 봅니다.

35.2 통합 관리

설정이 끝나면 페이지에 Organization 카드, API key 카드, Webhook 카드, 활동 로그가 표시되고, 웹훅이 등록되어 있는 동안 Webhook health와 Delivery stats도 표시됩니다.

  • Rotate API key는 admin API에 한 번만 표시되는 새 키를 요청합니다. 현재 키가 아직 활성 상태이면 admin API가 거부하므로, 먼저 SmartphoneKey에 폐기를 요청한 뒤 플랫폼을 즉시 업데이트하세요.
  • Update webhook URL은 전달을 새 HTTPS 주소로 옮기며, 구독은 새 주소에서 다시 검증됩니다. Replace webhook은 먼저 새 secret으로 새 구독을 만들고, 새 구독이 생긴 뒤 현재 구독을 제거합니다. secret을 잃었거나 이벤트 구성이 달라질 때 사용하며, 제거에 실패하면 SmartphoneKey가 이전 구독을 제거할 때까지 둘 다 활성 상태로 남습니다.
  • Webhook health는 최근 15분과 24시간의 실패한 전달 수를 전달됨·일치 수와 함께 보여 주고, 마지막 전달 오류와 최근 오류를 표시합니다.
  • Delivery stats는 기준 시점 이후의 합계(전체, 전달됨, 실패, 재시도), 전달 비율, 일별 차트를 보여 줍니다. Reset stats는 SmartphoneKey 쪽에서 아무것도 삭제하지 않고 지금부터 새 기준 시점을 시작합니다.
  • Activity는 누가 언제 무엇을 등록, 생성, 교체 또는 변경했는지 나열합니다. SmartphoneKey 팀은 백오피스의 Configuration → Partner Integrations에서 같은 목록을 보며, 키와 secret은 그곳에 절대 표시되지 않습니다.

헤더에는 My account로 돌아가는 링크, 인터페이스 언어 선택기, 테마 전환, Sign out이 있습니다. SmartphoneKey가 포털을 파트너 API에 연결하기 전까지 페이지는 그 사실을 알리고 작업은 비활성 상태로 유지됩니다.