SuperAPI AI 工具集

clerk-core-workflow-a

办公与效率

查看项目

更新于 10-15 22:42

技能介绍

用途:在应用中实现用户注册与登录流程,包括认证界面搭建、登录体验定制和 OAuth 社交登录。前置条件为已安装并配置 Clerk SDK(clerk-install-auth 已完成)、在控制台的 Social Connections 中启用 OAuth 提供商、并设置登录/注册相关环境变量。

主要能力:一是预置组件快速搭建,使用 @clerk/nextjs 的 SignIn、SignUp 组件配合 appearance 自定义样式与 routing="path"、path、signInUrl 等路由参数,并通过 NEXT_PUBLIC_CLERK_SIGN_IN_URL、NEXT_PUBLIC_CLERK_SIGN_UP_URL、NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL、NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL 等环境变量配置跳转。二是自定义表单,使用 useSignIn 的 signIn.create 处理登录,依据 status 为 complete、needs_second_factor、needs_identifier 分别处理会话激活、跳转多因素页或提示输入标识符,并用 form_identifier_not_found、form_password_incorrect、session_exists 等错误码给出提示。三是 OAuth,使用 authenticateWithRedirect 指定 strategy(如 oauth_google、oauth_github、oauth_apple)及 redirectUrl、redirectUrlComplete,并由 AuthenticateWithRedirectCallback 处理回调。四是注册与邮箱验证,使用 useSignUp 的 create、prepareEmailAddressVerification、attemptEmailAddressVerification 配合邮箱验证码。五是 TOTP 多因素认证,使用 signIn.attemptSecondFactor 与 strategy: 'totp'。

使用方式:按资料中的组件与 hook 代码接入对应页面,配置 CLERK_* 环境变量并处理回调路由。

适用场景与限制:适合需要 Clerk 认证的界面开发;资料提到电话验证使用 phone_code、魔法链接使用 email_link、企业 SSO(SAML/OIDC)由 SignIn 组件处理重定向、可通过 user.created webhook 跟踪转化率、MFA 注册经 UserProfile 组件或 user.createTOTP() API。资料未提供具体收费、价格与平台兼容性信息。