Blink Auth 是 Blink 平台的身份认证方案,提供托管(managed)与无头(headless)两种模式。
用途与配置:使用前需先启用认证提供方,例如通过 CLI 执行 blink auth-config set --provider google --enabled true、blink auth-config set --provider github --enabled true、blink auth-config set --provider email --enabled true。也可通过 MCP 工具 blink_auth_get_config 与 blink_auth_set_config 管理配置。
两种模式:托管模式一行代码即可跳转到托管认证页,适合网站与 MVP,但不支持移动端;在该模式下仅 blink.auth.login() 与 blink.auth.logout() 可用,调用 signInWithGoogle()、signInWithEmail() 等方法会抛出错误。无头模式需自行构建 UI,是移动端(Expo/React Native)和自定义登录表单的必需选择,支持 signUp、signInWithEmail、signInWithGoogle、signInWithGitHub、signInWithApple、signInWithMicrosoft 等方法。
主要能力:支持自定义字段注册、密码重置(含 generatePasswordResetToken 自定义流程)、魔法链接的发送与校验;通过 roles 配置实现 RBAC,可用 blink.auth.can() 检查权限、hasRole() 检查角色。核心方法包括 me、updateMe、getValidToken、signOut。登录后 SDK 会自动附加 Authorization: Bearer <JWT>,多数模块需要认证,公开例外为 analytics ingest 与 storage upload(仅新增)。
React 使用需通过 onAuthStateChanged 监听认证状态,加载期间应显示 spinner 或骨架屏,不要返回 null。Expo 需配置 webBrowser 与 AsyncStorageAdapter。
限制:托管模式不支持移动端;两种模式的方法可用范围不同,混用会报错。关于收费、价格与其他平台支持等资料暂未提供。