托管登录

Fóir 托管你的用户登录所用的页面。它带有你项目的名称、徽标和颜色,你也可以从你验证过的登录域名提供它。

页面提供什么

页面为你配置的每个身份提供方显示一个按钮,另有密码标签页和邮件验证码标签页。密码登录默认开启。六位数的邮件验证码默认关闭,直到你在项目设置中打开 customerOtpEnabled。(文档把你的用户称为“customers”。)

你为登录注册的每个应用(文档中称为“relying party”)都可以为自己隐藏某种方式或某个提供方。它只能收窄项目允许的范围,不能放宽。

你的域名与品牌

页面从 auth.foir.io 提供,直到你在登录应用上列出一个登录域名并用两条 DNS 记录验证它。名称、徽标和主色属于项目,因此一个项目中的所有应用共用同一外观。组织可以覆盖它们,页面会随之变化。

新账号与密码重置

在托管页面上,新用户通过输入发送到从未被使用过的地址的验证码,或通过提供方首次登录来获得账号。使用密码注册是 customerRegister mutation,重置密码是一对 mutation,都从你自己的界面调用。

项目设置决定谁可以注册:任何人、仅受邀者、候补名单,或无人。现有用户始终可以登录。

令牌与会话

登录是带 PKCE 的 OAuth 2.1 授权码流程。它返回一个 15 分钟的访问令牌和一个 30 天的刷新令牌,刷新令牌每次使用都会轮换。重放已被轮换过的令牌会撤销整个令牌族。

在已验证的登录域名与你的应用共享可注册域名时,Fóir 会设置一个会话 cookie,由你的应用换取访问令牌,因此浏览器中不存储任何令牌。该会话在闲置 30 天后或从首次登录起 90 天后结束,两者都可以按项目设置。

了解详情

“使用 Fóir 登录”指南涵盖注册登录应用、开始和完成登录的两个 mutation,以及刷新令牌。