AuthKit
如何使用AuthKit的托管UI或使用无头用户管理API构建您自己的前端
示例
使用AuthKit有两种方式,本仓库包含了这两种方式的示例:
- 使用AuthKit的托管UI
这是使用AuthKit和WorkOS用户管理为您的应用添加身份验证的最快方式。它包含一个完全可主题化的托管UI,可处理所有身份验证流程。当您准备投入生产时,可以将其指向自定义域名(
auth.yourapp.com
)以匹配您的应用程序。 - 使用您自己的自定义UI 使用AuthKit的所有功能,但通过直接集成无头WorkOS用户管理API在您自己的代码库中构建UI。您的身份验证UI将在您的应用程序中自托管。
前提条件
您需要一个WorkOS账户。
运行示例
-
使用
npm install
或yarn install
安装依赖项 -
设置您的环境变量:登录您的WorkOS仪表板,导航至API密钥并复制客户端ID和密钥(API密钥)。 将
.env.local.example
文件重命名为.env.local
,并提供您的_客户端ID_和_密钥_。WORKOS_CLIENT_ID="<您的客户端ID>" WORKOS_API_KEY="<您的密钥>"
-
在您的WorkOS仪表板中配置重定向,导航至重定向并添加以下URL:
http://localhost:3000/using-your-own-ui/sign-in/google-oauth/callback
http://localhost:3000/using-your-own-ui/sign-in/microsoft-oauth/callback
http://localhost:3000/using-your-own-ui/sign-in/github-oauth/callback
http://localhost:3000/using-your-own-ui/sign-in/sso/callback
http://localhost:3000/using-hosted-authkit/basic/callback
http://localhost:3000/using-hosted-authkit/with-session/callback
http://localhost:3000/using-hosted-authkit/with-nextjs/callback
-
使用
npm run dev
或yarn dev
运行示例,并导航至http://localhost:3000