用户

Users 选项卡列出了可以（或曾经可以）使用移动应用解锁此设施门的所有人员。本页介绍添加用户、CSV 导入和导出、Access Policy 归因、永久授权、单独的管理员/集成 Access Time Windows、访问紧急关闭开关、应用活动、会话以及删除用户。

图 1：Users 选项卡

用户的来源

每一行都有一个来源，说明它是如何创建的：

Performance Hub 员工同步默认开启；集成和 Computer Vision 同步默认关闭。请在 Settings → Sync settings 下进行配置，详见同步与集成。

每一行至少需要一个手机号或电子邮件地址，因为人员需要通过它接收一次性验证码来登录移动应用。

统计数据和筛选器

图 2：统计磁贴

点击某个磁贴即可筛选列表。（选择磁贴还会重置 Source 筛选器。）

图 3：搜索、导出 CSV、Import、Add user、筛选标签和排序

• Search：匹配姓名、手机号或电子邮件地址。
• 导出 CSV：下载当前筛选后的列表。例如，健身房可以在开展会员挽回活动之前导出其 No access 用户。
• Import 和 Add user：见下文。
• 筛选标签：

• Sort by：Name、Recently added、Recently updated、Last used、Last synced；并可切换升序/降序。
• 只要有搜索或筛选处于活动状态，就会显示 Clear filters。

解读用户行

图 4：带有标记的用户行

已同步的行还会在姓名下方显示其 External ID 或 Computer Vision ID。员工行则显示其 Performance Hub 角色。

大型列表会逐步加载：在列表其余部分加载期间，列表底部会显示 N more users loading…。

手动添加用户

1. 点击 Add user。

图 5：Add user 对话框

2. 填写 First name、Last name，以及 Mobile phone 或 Email 中的至少一项："At least one of mobile phone or email is required for OTP login." 手机号会被规范化为国际格式。
3. 可选择设置 Person type（例如 Gold、Trial、Staff）、Custom tags（以逗号分隔；现有标签列在字段下方）以及 Notes。
4. 勾选 Send email invitation 可立即通过电子邮件向该人员发送应用下载链接（需要电子邮件地址；没有电子邮件地址时该复选框不可用）。
5. 点击 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 用于设置在该用户的应用仪表板上显示的个人消息；当两者都有效时，它会叠放在设施范围的横幅之上。当某条自动消息适用时，面板会显示该消息，并提供为此用户关闭自动消息的控件。请参阅应用消息。

Track source updates（仅限已同步的用户）

对于 Integration/CCTV 用户，Track source updates 开关控制同步是否继续覆盖该行：

• **开启（默认）：**姓名、手机号、电子邮件地址、类型、状态、同步标签以及由来源管理的 Access Time Windows 会在同步成功时刷新。
• **关闭（解除关联）：**经明确确认后，由来源管理的 Access Time Windows 会被清除，同步会完全跳过该行。您的手动编辑和由管理员管理的时间窗口会被保留，来源中的移除也不再影响该行。该行会显示 Decoupled 标记。

重新开启即可重新关联。当前的来源时间窗口快照会在下一次成功的完整同步中恢复，而不会从失败或不完整的来源获取中恢复。

已同步用户的面板还包含指向来源记录（Integration 记录或 Computer Vision 人员）的链接。

通过集成移除

当会员在集成中被删除时，其门禁访问权限会被移除，面板会显示 Removed by integration。该行会保留在列表中，以便保存其历史记录。请参阅同步与集成。

访问控制

图 8：Access Control 部分

Access Control 部分将该用户的授权设置集中在一起：访问紧急关闭开关、策略覆盖范围、额外的永久访问权限以及管理员/集成 Access Time Windows。

Access enabled（紧急关闭开关）

Access enabled 开关可立即阻止或恢复该用户的所有门禁访问权限。关闭时：

• 无论策略、授权或 Access Time Windows 如何，该会员的每次解锁尝试都会被拒绝（原因：access disabled）。
• 该行显示 Disabled 标记，并在列表中显示为灰色。

使用此开关可以立即暂停某人的访问权限，而无需删除其记录或更改策略。

额外的永久访问权限

授权会在设施的 Access Policies 所允许的权限之外，为这个特定人员提供访问权限。当某个策略已覆盖该用户时，此部分会显示 Allowed by policy 和 "This user's door access is set by policy — no manual grants are needed." 点击 Show 可打开授权编辑器：

已被策略覆盖的门会标记为 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 时区及其夏令时规则。

面板中注明："Time windows add access. They do not restrict existing rules or grants." 请参阅访问策略时间表。

邀请

显示是否已发送应用邀请电子邮件、发送时间以及是否发送失败；按钮显示为 Send invitation email 或 Resend invitation email。邀请仅通过电子邮件发送。完整详细信息请参阅应用邀请。

会话和应用活动

• App activity：显示 Last used the app 及时间戳（或 "Hasn't used the app yet."）以及最近的 IP 地址。
• Sessions：Sign out of app 会撤销该用户的应用会话："This revokes the user's app session. They'll need to sign in again to unlock doors." 注意："Sessions are revoked immediately, but if the user is currently signed in it may take up to 15 minutes before they're fully signed out of the app." 由于会话以手机号/电子邮件地址为键，因此在其他设施使用相同手机号/电子邮件地址的人员也会在那里被注销。

删除用户

图 9：危险区域

Delete user 会从 Users 中移除该行。"Their access log history is kept for the audit trail." 删除还会立即停用其访问权限。对于已同步的用户，请注意，除非您同时停用该集成或解除关联，否则该人员可能会在下一次同步时重新出现；要清除整个集成的用户，请使用同步与集成中的 Bulk delete synced users。

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 员工同步。

相关页面

• 应用邀请
• Access Policies
• 访问策略时间表
• Access Scopes
• 同步与集成
• 访问决策的工作原理