사용자

이 페이지의 내용

Users 탭에는 이 시설에서 모바일 앱을 사용하여 출입문을 잠금 해제할 수 있는(또는 할 수 있었던) 모든 사람이 표시됩니다. 이 페이지에서는 사용자 추가, CSV 가져오기 및 내보내기, Access Policy 적용 근거, 영구 권한, 별도의 관리자/통합 Access Time Windows, 액세스 차단 스위치, 앱 활동, 세션 및 삭제를 다룹니다.

Users 탭: 타일, 검색, 필터 및 사용자 목록

그림 1: Users 탭

사용자의 출처

각 행에는 생성 방식을 알려 주는 소스가 있습니다.

소스	배지	행이 생성되는 방식	데이터 관리 주체
Manually added	Manual	관리자가 Add user를 클릭했거나 Import(CSV)를 사용함	관리자
External Integration	Integration(또는 파트너 이름)	회원 관리 통합에서 자동으로 동기화됨	동기화. 동기화된 필드는 실행할 때마다 덮어씀
CCTV/Computer Vision	CCTV/Computer Vision	CCTV 모듈에서 식별된 사람으로부터 동기화됨	동기화
Performance Hub staff	Performance Hub staff	역할에 이 시설이 포함된 직원을 Performance Hub IAM에서 자동으로 동기화함	Performance Hub IAM

Performance Hub 직원 동기화는 기본적으로 켜져 있으며, 통합 및 Computer Vision 동기화는 기본적으로 꺼져 있습니다. Settings → Sync settings에서 구성합니다. 동기화 및 통합을 참조하십시오.

행에는 휴대폰 번호나 이메일 주소가 하나 이상 있어야 합니다. 사람들은 이를 사용하여 일회용 코드로 모바일 앱에 로그인합니다.

통계 및 필터

사용자 타일: All users, Has access, No access 및 Not synced

그림 2: 통계 타일

타일	표시 내용
All users	이 시설의 모든 사용자
Has access	현재 출입문을 하나 이상 잠금 해제할 수 있는 사용자
No access	현재 어떤 출입문도 잠금 해제할 수 없는 사용자
Not synced	동기화에서 보류된 레코드(예: 중복)

타일을 클릭하면 목록이 필터링됩니다. (타일을 선택하면 Source 필터도 재설정됩니다.)

Users 도구 모음: 검색, CSV 내보내기, Import, Add user, Sync status를 포함한 필터 및 정렬

그림 3: 검색, CSV 내보내기, Import, Add user, 필터 칩 및 정렬

검색 — 이름, 전화번호 또는 이메일과 일치하는 항목을 찾습니다.
CSV 내보내기 — 현재 필터링된 목록을 다운로드합니다. 예를 들어 체육관은 재가입 유도 캠페인 전에 No access 사용자를 내보낼 수 있습니다.
Import 및 Add user — 아래를 참조하십시오.
필터 칩:

칩	옵션
Source	All sources, Manually added, External Integration, CCTV/Computer Vision, Performance Hub staff
Access	Any status, Has access, No access, Disabled, Without grants
Membership status	Any membership + 데이터에 있는 상태
Person type	Any type + 데이터에 있는 유형
Tag	Any tag + 데이터에 있는 태그
Invitation	Any invitation, Invited, Not invited, Send failed
App adoption	Any adoption, Active(앱을 사용한 적 있음), Not yet active
Sync status	Any status 또는 동기화에서 보류된 레코드만(예: 중복)

Sort by — Name, Recently added, Recently updated, Last used, Last synced이며, 오름차순/내림차순 토글이 있습니다.
검색이나 필터가 활성화되어 있으면 Clear filters가 표시됩니다.

사용자 행 읽기

소스, 메시지, 동기화 및 멤버십 칩이 있는 사용자 행

그림 4: 배지가 있는 사용자 행

배지	의미
Manual / Integration / CCTV/Computer Vision(또는 파트너 이름)	행의 소스
Performance Hub staff	행이 Performance Hub IAM에서 동기화됨
Message	사용자에게 활성 앱 메시지가 있음(심각도별 색상 표시)
Disabled	Access enabled가 꺼져 있음. 사용자는 아무것도 잠금 해제할 수 없으며 행이 흐리게 표시됨
Access granted via policy	활성화된 Access Policy가 하나 이상 지금 또는 향후 정책 기간에 이 사용자 및 구성된 출입문과 일치할 수 있음
Access via time windows	사용자에게 관리자 또는 통합 소유 Access Time Windows가 있음. 행을 열어 활성, 예정, 만료, 오래됨 또는 매핑되지 않음 상태인지 확인
Grants	사용자에게 별도의 사용자별 영구 권한이 있음
Not synced – duplicate	같은 이메일이나 전화번호를 가진 다른 레코드가 자리를 유지하여 이 레코드는 동기화되지 않음. 중복 해결 참조
Invited	초대 이메일이 전송되었으며 사용자가 아직 앱을 사용하지 않음
멤버십 상태(예: Current, Expired)	소스 시스템의 사용자 멤버십 상태

동기화된 행에는 이름 아래에 External ID 또는 Computer Vision ID도 표시됩니다. 직원 행에는 대신 Performance Hub 역할이 표시됩니다.

목록이 길면 점진적으로 로드됩니다. 나머지 목록이 로드되는 동안 목록 하단에 *N more users loading…*이 표시됩니다.

수동으로 사용자 추가

Add user를 클릭합니다.

Add user 대화 상자

그림 5: Add user 대화 상자

First name, Last name과 Mobile phone 또는 Email 중 하나 이상을 입력합니다. "OTP 로그인에는 휴대폰 번호나 이메일 중 하나 이상이 필요합니다." 전화번호는 국제 형식으로 정규화됩니다.
선택적으로 Person type(예: Gold, Trial, Staff), Custom tags(쉼표로 구분, 기존 태그는 필드 아래에 표시됨) 및 Notes를 설정합니다.
앱 다운로드 링크를 즉시 이메일로 보내려면 Send email invitation을 선택합니다(이메일 주소 필요, 이메일 주소가 없으면 확인란이 비활성화됨).
Add user를 클릭합니다.

이 시설에 같은 전화번호/이메일을 가진 사용자가 이미 있으면 대화 상자에 이를 알리고 중복 항목을 만드는 대신 Open existing user를 제공합니다.

사용자를 추가하는 것만으로는 어떤 출입문도 통과할 수 없습니다. 일치하는 Access Policy, 영구 권한 또는 별도의 관리자/통합 Access Time Window가 여전히 필요합니다.

CSV에서 사용자 가져오기

Import를 클릭하여 스프레드시트에서 사용자를 일괄 생성합니다. 가져오기당 최대 200명입니다.

사용자 가져오기 대화 상자

그림 6: CSV 가져오기 마법사

1단계 — CSV 업로드. .csv 파일을 끌어다 놓거나 클릭하여 찾아봅니다. Download template을 사용하면 올바른 헤더가 있는 시작 파일을 받을 수 있습니다.

2단계 — 필드 매핑. 각 CSV 열을 First name, Last name, Mobile phone, Email, Person type, Tags, Notes, Access enabled, Door grants, Scope grants 필드 중 하나 또는 Do not import에 매핑합니다. 일반적인 헤더 이름(예: mobile, phone, groups)은 자동으로 매핑됩니다. 휴대폰 번호 열이나 이메일 열을 하나 이상 매핑해야 합니다.

Access enabled는 true/yes/enabled/1/on/y/active 및 false/no/disabled/0/off/n/inactive를 허용합니다.
Door grants / Scope grants에는 출입문 또는 Access Scope 이름을 입력합니다. 일치하지 않는 이름은 미리 보기에서 표시됩니다.

3단계 — 미리 보기 및 가져오기. 처음 몇 행을 검토하고 Send invitation email to imported users 여부를 선택한 다음(이메일이 있는 사용자만 초대됨) Import를 클릭합니다. 결과에 Imported, Skipped (already exist) 및 Errors 개수가 표시됩니다.

사용자 세부 정보 패널

행을 클릭하면 사용자의 패널이 열립니다.

동기화된 회원의 사용자 창: 프로필, 메시지, 액세스 제어, 초대 및 소스

그림 7: 동기화된 회원의 패널

프로필 및 신원

헤더에는 소스, 멤버십 상태, External ID 및 사용자가 정책에 의해 허용되는지 여부가 표시됩니다.

First name / Last name / Mobile phone / Email — 동기화된 사용자의 경우 행이 분리되지 않은 한(아래 참조) 동기화할 때마다 덮어씁니다.
Person type 및 Membership status — Access Policy Who 조건에 사용됩니다.
Synced tags(읽기 전용, 소스 시스템에서 가져옴) 및 Custom tags(관리자 소유, 동기화로 덮어쓰지 않음). 두 종류 모두 정책 태그 조건을 충족할 수 있습니다.
Notes — 최대 2000자의 자유 텍스트입니다.

앱 메시지

App messaging은 이 사용자의 앱 대시보드에 표시되는 개인 메시지를 설정하며, 둘 다 활성화된 경우 시설 전체 배너 위에 쌓여 표시됩니다. 자동 메시지가 적용되면 패널에 해당 메시지와 함께 이 사용자에 대한 자동화를 끄는 컨트롤이 표시됩니다. 앱 메시지를 참조하십시오.

소스 업데이트 추적(동기화된 사용자만 해당)

Integration/CCTV 사용자의 경우 Track source updates 토글은 동기화가 행을 계속 덮어쓸지 여부를 제어합니다.

켜짐(기본값): 동기화가 성공하면 이름, 전화번호, 이메일, 유형, 상태, 동기화된 태그 및 소스 소유 Access Time Windows가 새로 고쳐집니다.
꺼짐(분리됨): 명시적으로 확인한 후 소스 소유 Access Time Windows가 지워지고 동기화가 이 행을 완전히 건너뜁니다. 수동 편집 내용과 관리자 소유 기간은 유지되며 소스에서 제거되어도 더 이상 영향을 받지 않습니다. 행에 Decoupled 배지가 표시됩니다.

다시 연결하려면 토글을 다시 켭니다. 현재 소스 기간 스냅샷은 다음에 성공한 완전한 동기화에서 복원되며, 실패했거나 일부만 완료된 소스 가져오기에서는 복원되지 않습니다.

동기화된 사용자의 패널에는 소스 레코드(Integration 레코드 또는 Computer Vision 사람)로 연결되는 링크도 포함됩니다.

통합에서 제거됨

통합에서 회원이 삭제되면 해당 회원의 출입문 액세스가 제거되고 패널에 Removed by integration이 표시됩니다. 행은 목록에 남아 있으므로 기록이 유지됩니다. 동기화 및 통합을 참조하십시오.

액세스 제어

Access Control: 액세스 활성화, 정책 적용 범위 및 추가 영구 액세스

그림 8: Access Control 섹션

Access Control 섹션에는 액세스 차단 스위치, 정책 적용 범위, 추가 영구 액세스 및 관리자/통합 Access Time Windows 등 사용자의 인증 설정이 함께 모여 있습니다.

액세스 활성화(차단 스위치)

Access enabled 토글은 이 사용자의 모든 출입문 액세스를 즉시 차단하거나 복원합니다. 꺼져 있으면 다음과 같이 됩니다.

정책, 권한 또는 Access Time Windows와 관계없이 모든 회원 잠금 해제 시도가 거부됩니다(사유: 액세스 비활성화됨).
행에 Disabled 배지가 표시되고 목록에서 흐리게 표시됩니다.

레코드를 삭제하거나 정책을 변경하지 않고 누군가를 즉시 정지하려면 이 기능을 사용하십시오.

추가 영구 액세스

권한은 시설의 Access Policies가 허용하는 범위에 더해 특정 사람에게 액세스를 부여합니다. 정책이 이미 사용자를 포함하는 경우 섹션에 Allowed by policy와 *"이 사용자의 출입문 액세스는 정책으로 설정되어 있으므로 수동 권한이 필요하지 않습니다."*가 표시됩니다. Show를 클릭하면 권한 편집기가 열립니다.

권한	효과
Facility-wide	시설의 모든 출입문(켜져 있는 동안 출입문/범위 목록보다 우선함)
Door grants	개별 출입문 선택
Scope grants	Access Scopes 선택. 사용자는 나중에 범위에 추가된 출입문을 포함하여 범위의 모든 출입문에 액세스할 수 있음

정책이 이미 포함하는 출입문은 Already covered by policy 또는 Set by policy로 표시되므로 수동 권한이 필요하지 않은 곳을 확인할 수 있습니다. 권한에는 자체 운영 시간을 지정하여 권한이 적용되는 시간을 제한할 수 있습니다. Clear all은 모든 권한을 한 번에 제거합니다. 자동 정책 가져오기와 이후의 정책 편집은 영구 권한을 변경하지 않습니다.

정책 및 권한 표시기는 추가적으로 적용됩니다. 불필요한 수동 권한을 제거해도 정책 액세스는 제거되지 않으며, 정책을 편집해도 권한은 제거되지 않습니다.

출입 시간대

Access Time Windows 섹션에서는 Add one-time window 및 Add weekly window(최대 50개)로 이 사람의 임시 추가 액세스를 관리합니다.

관리자 소유 절대 기간 및 주간 기간은 편집할 수 있으며 시설, 선택한 출입문 또는 Access Scopes를 대상으로 지정할 수 있습니다.
통합 소유 기간은 읽기 전용이며 소스, 소스 ID, 선언된 시간대, 논리적 범위 매핑, 소스 경과 시간 및 최신성 상태가 표시됩니다.
활성, 예정, 만료, 오래됨 및 매핑되지 않음 상태가 구분되어 표시됩니다. 오래되었거나 매핑되지 않은 기간은 액세스를 허용하지 않지만, Access Policies와 영구 권한은 대체 경로로 계속 사용할 수 있습니다.
정확한 시점에는 [from, to) 경계를 사용합니다. 주간 기간은 표시된 IANA 시간대와 해당 일광 절약 시간 규칙을 사용합니다.

패널에는 다음과 같이 안내되어 있습니다. "시간 기간은 액세스를 추가합니다. 기존 규칙이나 권한을 제한하지 않습니다." Access Policy 일정을 참조하십시오.

초대

앱 초대 이메일의 전송 여부, 전송 시간 및 실패 여부가 표시되며, 버튼에는 Send invitation email 또는 Resend invitation email이 표시됩니다. 초대는 이메일로만 보냅니다. 자세한 내용은 초대를 참조하십시오.

세션 및 앱 활동

App activity — 타임스탬프가 포함된 Last used the app(또는 "Hasn't used the app yet.")과 최근 IP 주소가 표시됩니다.
Sessions — Sign out of app은 사용자의 앱 세션을 취소합니다. "사용자의 앱 세션이 취소됩니다. 출입문을 잠금 해제하려면 다시 로그인해야 합니다." 참고: "세션은 즉시 취소되지만, 사용자가 현재 로그인되어 있는 경우 앱에서 완전히 로그아웃되기까지 최대 15분이 걸릴 수 있습니다." 세션은 전화번호/이메일을 기준으로 하므로, 다른 시설에서 같은 전화번호/이메일을 사용하는 사람은 해당 시설에서도 로그아웃됩니다.

사용자 삭제

Delete user 버튼이 있는 위험 영역

그림 9: 위험 영역

Delete user는 Users에서 행을 제거합니다. "감사 추적을 위해 접근 로그 기록은 유지됩니다." 삭제하면 액세스도 즉시 비활성화됩니다. 동기화된 사용자의 경우 통합을 비활성화하거나 분리하지 않으면 다음 동기화에서 다시 나타날 수 있습니다. 통합 전체를 정리하려면 동기화 및 통합에서 Bulk delete synced users를 사용하십시오.

Performance Hub 직원

IAM에서 동기화된 Performance Hub 직원의 사용자 창

그림 10: Performance Hub 직원의 패널

직원 패널에는 Synced from Performance Hub IAM 배너가 있습니다. 직원은 Performance Hub 역할에 이 시설이 포함되어 있으면 자동으로 추가되고, 해당 액세스가 종료되면 제거됩니다. 배너에는 직원의 역할이 표시됩니다.

이름, 이메일, 전화번호 및 사람 유형은 Performance Hub IAM에서 관리되며 여기에서는 읽기 전용입니다.
Synced tags(예: Performance Hub staff 및 Role: …)는 동기화할 때마다 덮어씁니다. Custom tags와 Notes는 계속 추가할 수 있습니다.
직원은 여기에서 삭제할 수 없습니다. Performance Hub IAM에서 시설 액세스를 제거하거나, Access enabled를 꺼서 출입문 액세스를 즉시 중지하십시오.

Performance Hub 직원 동기화를 참조하십시오.