跳到主要内容

管理用户

通过 Logto 控制台管理​

浏览和搜索用户​

要访问 Logto 控制台中的用户管理功能，请导航至 控制台 > 用户管理。进入后，你会看到所有用户的表格视图。

该表格包含三列：

  • 用户：显示用户的信息，如头像、全名、用户名、手机号和邮箱
  • 来自应用程序：显示用户最初注册时所用的应用程序名称
  • 最近登录：显示用户最近一次登录的时间戳

支持对 name、id、username、primary-phone、primary-email 进行关键词映射搜索。

添加用户​

通过控制台，开发者可以为终端用户创建新账号。只需点击页面右上角的“添加用户”按钮即可。

在 Logto 控制台或通过 Management API 创建用户时（不是终端用户通过 UI 自助注册），你必须至少提供一个标识符：primary email、primary phone 或 username。name 字段为可选项。

用户创建后，Logto 会自动生成一个随机密码。初始密码只会显示一次，但你可以稍后重置密码。如果你想设置特定密码，可在用户创建后使用 Management API 的 patch /api/users/{userId}/password 进行更新。

你可以一键复制输入的标识符（邮箱地址 / 手机号 / 用户名）和初始密码，方便将这些凭证分享给新用户，让他们可以登录并开始使用。

提示:

如果你想实现仅限邀请注册，推荐使用魔法链接邀请用户。这样只有白名单用户才能自助注册并设置自己的密码。

查看和更新用户资料​

要查看用户详情，只需点击用户表格中的对应行。你将进入“用户详情”页面，在这里可以查看用户的资料信息，包括：

  • 认证 (Authentication) 相关数据：
  • 连接：
    • 社交连接（identities）：
      • 查看用户已绑定的社交账号，包括社交 ID 及从社交平台同步的资料详情（如用户通过 Facebook 登录，则会显示“Facebook”条目）。
      • 你可以移除已有社交身份，但不能代用户绑定新的社交账号。
      • 对于启用了token 存储的社交连接器，可在连接详情页查看和管理访问令牌 (Access token) 与刷新令牌 (Refresh token)。
    • 企业单点登录 (SSO) 连接（sso_identities）：
      • 查看用户已绑定的企业身份，包括企业 ID 及从企业身份提供商同步的资料详情。
      • 你无法在控制台添加或移除企业单点登录 (SSO) 身份。
      • 对于基于 OIDC 的企业连接器，若启用了token 存储，可在连接详情页查看和删除令牌。
  • 用户资料数据：姓名、头像 URL、自定义数据及未包含的其他 OpenID Connect 标准声明 (Claims)。所有这些资料字段均可编辑。
注意:

在移除社交连接前，请务必确认用户还有其他登录方式，如其他社交连接、手机号、邮箱或用户名加密码。如果用户没有其他登录方式，移除社交连接后将无法再次访问其账户。

查看用户活动​

要查看用户的近期活动，请在“用户详情”页面切换到“用户日志”子标签。在这里，你可以看到一张表格，显示用户的近期操作，包括执行的动作、结果、相关应用和操作时间。

点击表格行可查看更多日志详情，如 IP 地址、用户代理、原始数据等。

挂起用户​

在“用户详情”页面，点击“三点”->“挂起用户”按钮。

用户被挂起后，将无法登录你的应用，也无法在当前访问令牌 (Access token) 过期后获取新的访问令牌 (Access token)。此外，该用户发起的任何 API 请求都会失败。

如需恢复该用户，只需点击“三点”->“恢复用户”按钮即可。

删除用户​

在“用户详情”页面，点击“三点”->“删除”按钮。删除用户操作不可撤销。

重置用户密码​

在“用户详情”页面，点击“三点”->“重置密码”按钮，Logto 会自动重新生成一个随机密码。

重置密码后，请复制并发送给终端用户。关闭“重置密码”弹窗后将无法再次查看密码。如果忘记保存，可以再次重置。

你无法在 Logto 控制台为用户设置特定密码，但可以通过 Management API 的 PATCH /api/users/{userId}/password 指定密码。

密码合规性检查​

在 Logto 更新密码策略后，现有用户仍可使用当前密码登录。只有新创建的账号才需遵循更新后的密码策略。

为加强安全性，你可以使用 POST /api/sign-in-exp/default/check-password API 检查用户密码是否符合默认登录体验下的当前策略。如不符合，可通过自定义流程结合 Account API 提示用户更新密码。

管理用户角色​

在用户详情页的“角色”标签下，你可以轻松分配或移除角色以满足需求。详情请查阅基于角色的访问控制 (RBAC)。

查看用户所属组织​

Logto 支持组织 (Organizations)并可管理其成员。你可以轻松查看用户详情及其所属组织。

通过 Logto Management API 管理​

Management API 是一组用于访问 Logto 后端服务的 API。如前所述，用户 API 是该服务的重要组成部分，可支持多种场景。

与用户相关的 RESTful API 挂载在 /api/users，用户活动（即用户日志）除外，日志接口为 /api/logs?userId=:userId。

你可以在多种场景下通过 Management API 管理用户，如高级用户搜索、批量创建账号、仅限邀请注册等。

常见问题​

如何限制特定用户访问某些应用？​

由于 Logto 的 Omni-sign-in 特性，设计上并不支持在认证 (Authentication) 前限制用户访问某些应用。 不过，你仍然可以为应用设计特定的用户角色和权限，保护你的 API 资源，并在用户成功登录后对 API 访问进行权限校验。 更多信息请参考授权 (Authorization)：基于角色的访问控制 (RBAC)。