托管登录
Fóir 托管你的用户登录所用的页面。它带有你项目的名称、徽标和颜色,你也可以从你验证过的登录域名提供它。
页面提供什么
页面为你配置的每个身份提供方显示一个按钮,另有密码标签页和邮件验证码标签页。密码登录默认开启。六位数的邮件验证码默认关闭,直到你在项目设置中打开 customerOtpEnabled。(文档把你的用户称为“customers”。)
你为登录注册的每个应用(文档中称为“relying party”)都可以为自己隐藏某种方式或某个提供方。它只能收窄项目允许的范围,不能放宽。
新账号与密码重置
在托管页面上,新用户通过输入发送到从未被使用过的地址的验证码,或通过提供方首次登录来获得账号。使用密码注册是 customerRegister mutation,重置密码是一对 mutation,都从你自己的界面调用。
项目设置决定谁可以注册:任何人、仅受邀者、候补名单,或无人。现有用户始终可以登录。
令牌与会话
登录是带 PKCE 的 OAuth 2.1 授权码流程。它返回一个 15 分钟的访问令牌和一个 30 天的刷新令牌,刷新令牌每次使用都会轮换。重放已被轮换过的令牌会撤销整个令牌族。
在已验证的登录域名与你的应用共享可注册域名时,Fóir 会设置一个会话 cookie,由你的应用换取访问令牌,因此浏览器中不存储任何令牌。该会话在闲置 30 天后或从首次登录起 90 天后结束,两者都可以按项目设置。
了解详情
“使用 Fóir 登录”指南涵盖注册登录应用、开始和完成登录的两个 mutation,以及刷新令牌。