你的应用用户登录
你的应用自带账户
基于 Kliv 构建的应用拥有自己的用户,也就是使用你产品的客户、成员或团队成员。每个应用从一开始就内置一套完整的用户登录系统。你不需要自己集成认证提供商,也不需要管理密码存储:描述谁应当能够登录,Kliv 会处理其余工作。
需要明确一个区别:本页讨论的是你的应用用户。你自己团队的登录,也就是与你一起在 Kliv 上构建应用的人,包括你的组织使用的任何企业 SSO,是另一套体系;相关内容见用户管理。
登录方式
你的应用用户可以通过以下方式登录:
- 邮箱和密码 —— 使用已验证邮箱地址的传统账户
- Sign in with Google 和 Sign in with Facebook —— 使用用户已有账户的一键社交登录
- Passkeys (WebAuthn) —— 使用设备生物识别或安全密钥的无密码登录
- 双因素认证(TOTP) —— 认证器应用生成的基于时间的一次性代码,作为第二步验证
在对话中告诉 Kliv 你的应用应提供哪些方式。“让用户用邮箱或 Google 注册,并支持 passkeys”就足够了。
组织和角色
用户不必只是扁平列表。你的应用用户可以属于组织,并且每个用户在组织中都有一个角色。这是团队产品和 B2B 应用的自然形态:一家公司注册、邀请成员,每个人能做什么由其角色决定。描述你需要的角色,Kliv 会完成设置。
登录和数据访问
登录不只是门口的一道关卡,它还决定每个用户可以访问什么。数据访问遵循你数据库的行级安全规则,因此已登录用户只能读取和写入这些规则允许的行。行级安全如何工作,请参见数据库。
agent 也是如此。如果你的应用包含 agent,用户的登录状态会限定 agent 可以代表他们读取什么;为某位用户回答问题的 agent 不能使用该用户本人看不到的行。参见Agent 和你的数据。
使用你自己的 Google 或 Facebook 凭据
使用 Google 和 Facebook 登录时,Kliv 管理的密钥开箱即用,你无需在服务提供商处注册任何内容。使用你自己的密钥是可选的:这样,服务提供商的授权同意页面会显示你的应用名称,而不是 Kliv。
如果使用自己的密钥,你需要为访客登录所用的每个地址,在服务提供商处注册一个重定向 URI:
https://<你的网站地址>/api/v2/auth/oauth/<服务提供商>/complete
例如:https://example.com/api/v2/auth/oauth/google/complete。每个地址都需要一个:每个自定义域名各一个;如果访客会使用网站的 <站点标识>.kliv.site 地址,也要为它注册一个。重定向到主域名的 www 地址则不需要。
你不必手动拼写这些 URI。站点设置 → 社交登录 → 使用你自己的 OAuth 凭据 中会列出你网站的准确 URI,每个都带有复制按钮。
在哪里添加:
- **Google:**在 Google Cloud Console 中打开你的 OAuth 客户端,将它们添加到“已获授权的重定向 URI”(Authorized redirect URIs)中。“已获授权的 JavaScript 来源”可以留空。
- **Facebook:**在你的 Meta 开发者应用中打开 Facebook 登录设置,将它们添加到“有效 OAuth 跳转 URI”(Valid OAuth Redirect URIs)中。
通过 Apple 登录仅支持 Kliv 管理的密钥。
使用你自己的密钥时,在预览地址上无法登录,因此请在已发布的网站上测试。
相关文档
- 数据库 → —— 行级安全规则
- Agent 和你的数据 → —— agent 如何遵守用户访问权限
- 用户管理 → —— 你自己团队的登录和角色