用户管理
截图未公开:原图可能包含账号或资源标识。
入口:项目侧栏 Auth → Users。列表与管理操作需要 users.write 权限。
用户列表
- 顶部搜索框支持按 姓名、邮箱、手机号、用户 ID 搜索。
- 表格列:User ID、Name、Identifiers(邮箱 / 手机号)、Status(
Verified/Unverified;被封禁用户显示红色blocked)、Joined;Labels 与 Last activity 列默认隐藏,可通过列选择器打开。 - 列表按创建时间倒序分页加载。
创建用户
点击 Create user 打开弹窗。所有字段均可留空:
| 字段 | 校验与说明 |
|---|---|
| Name | 最长 128 字符 |
合法邮箱格式;创建时统一转小写,且在项目内唯一(重复时返回 USER_EMAIL_ALREADY_EXISTS) | |
| Phone | 必须以 + 开头并带国家码,+ 后最多 15 位数字(如 +14155552671) |
| Password | 至少 8 个字符(服务端校验 8–256 位);项目开启密码字典 / 个人信息策略后约束更严 |
| User ID | 默认自动生成;可展开自定义输入:仅允许 a-z A-Z 0-9、句点、连字符、下划线,最长 36 字符,不能以特殊字符开头 |
成功结果:通知 "{name} has been created",并跳转到该用户详情页。创建时系统自动为用户生成一个 Email 类型的 target(填写了手机号时同时生成 SMS target),供 Messaging 使用(见下文 Targets)。
用户详情
用户详情页(/auth/user-{userId})包含六个页签:Overview / Memberships / Identities / Targets / Sessions / Activity。
Overview 卡片
| 卡片 | 操作与规则 |
|---|---|
| Status | Block account 封禁 / Unblock account 解封(立即生效)。同时存在邮箱与手机号时提供 Verify 下拉:分别验证 / 取消验证 Email 与 Phone |
| 输入新邮箱后点 Update 直接更换(不发送确认邮件) | |
| Phone | 同上;格式要求 + 开头、+ 后最多 15 位 |
| Password | 重设提示:至少 8 个字符 |
| Labels | 选择或输入用户标签;仅允许字母数字字符 |
| Preferences | 键值偏好,逐条编辑 |
| User impersonation | 开关:允许该用户通过 Client SDK 冒充项目内其他用户。仅授予受信任的运营 / 支持账号;操作记录在发起冒充的账号下 |
| Multi-factor authentication | 开关用户 MFA;已启用验证器显示 TOTP (One-time code),可 Delete authenticator 删除 TOTP 因子——该操作不可逆 |
| Delete user | 永久删除用户及其全部关联数据,不可逆。确认后删除并返回用户列表 |
Sessions(会话)
- 列:Client(如 "Chrome 128 on macOS 14")、Location(国家,未知显示 Unknown)、IP(可复制);当前会话带绿色
current session徽章。页面不展示会话过期时间,也不展示任何 token。 - 操作:单条 Sign out;右上 Sign out all sessions 注销全部会话(确认后立即生效)。
Memberships(团队成员关系)
- 列:Name(团队名,点击进入团队详情)、Roles(该用户在团队中的自定义角色)、Joined。
- 行内删除或勾选批量删除:把用户从对应团队移除;批量操作不可逆。
Identities(OAuth 身份)
- 用户通过 OAuth 提供方登录后,此处显示其关联的第三方身份。
- 列:Identity ID、Provider、Email、Expiry Date(访问令牌过期时间)、Created;Provider UID 与 Updated 默认隐藏。
- 操作:仅 删除(单条 / 批量);无新建入口。
Activity
- 展示该用户的操作审计记录。
批量删除风险
用户列表支持勾选批量删除,提示该操作不可逆并将永久移除所选用户及其全部数据。删除用户会同时移除其会话、memberships、identities、targets 与所属数据,不可恢复。