什么是WorkOS的用戶管理服務(wù)?

什么是WorkOS的用戶管理服務(wù)接口？

WorkOS的用戶管理服務(wù)有哪些核心功能？

1. 在幾分鐘內(nèi)將身份驗(yàn)證添加到您的應(yīng)用程序 設(shè)置您的應(yīng)用程序支持的身份驗(yàn)證策略，然后微調(diào)托管的 AuthKit UI 以匹配您的應(yīng)用程序的品牌、顏色、消息傳遞和域。自帶前端以實(shí)現(xiàn)完全控制。
2. 定制以滿足您的需求 用戶管理 API 可解鎖自定義用戶流以適應(yīng)應(yīng)用程序的業(yè)務(wù)邏輯。事件 API 使您的數(shù)據(jù)庫保持同步。
3. 安全靈活的 RBAC 通過用戶會(huì)話輕松定義角色和權(quán)限。在用戶配置、角色分配和訪問檢查中維護(hù)端到端數(shù)據(jù)完整性。
4. 隨您擴(kuò)展的身份驗(yàn)證堆棧 無縫集成單點(diǎn)登錄、目錄同步、多重身份驗(yàn)證和 WorkOS 組織。永遠(yuǎn)不用擔(dān)心您的授權(quán)供應(yīng)商的規(guī)模會(huì)超出您的規(guī)模。
5. 第一天就擁有高級(jí)安全性 用戶管理服務(wù)包含自動(dòng)垃圾郵件和機(jī)器人檢測(cè)、密碼強(qiáng)度驗(yàn)證以及泄露密碼保護(hù)功能。
6. 企業(yè)級(jí)用戶管理 實(shí)施組織級(jí)身份驗(yàn)證策略并啟用即時(shí) (JIT) 或目錄同步 (SCIM) 用戶配置。

WorkOS的用戶管理服務(wù)的核心優(yōu)勢(shì)是什么？

在哪些場(chǎng)景會(huì)用到WorkOS的用戶管理服務(wù)？

開始之前
為了充分利用本指南，您需要：WorkOS 帳戶、您的 WorkOS API 密鑰和客戶端 ID。

1.配置您的項(xiàng)目

安裝依賴項(xiàng)
如果您使用 Next.js，則可以使用authkit-nextjs圖書館。 Next.js 庫是在 Next.js 應(yīng)用程序中使用 AuthKit 和模擬并提供完整會(huì)話管理的最快方法。

npm install @workos-inc/node

配置重定向 URI
重定向 URI 是 WorkOS 在用戶進(jìn)行身份驗(yàn)證后重定向到的回調(diào)端點(diǎn)。該端點(diǎn)將用 WorkOS 返回的授權(quán)代碼交換經(jīng)過身份驗(yàn)證的User 對(duì)象。我們將在下一步中創(chuàng)建此端點(diǎn)。

您可以在WorkOS 儀表板的“重定向”部分中設(shè)置重定向 URI – 確保不包含通配符子域或查詢參數(shù)。

設(shè)定秘密
要調(diào)用 WorkOS，請(qǐng)?zhí)峁?API 密鑰和客戶端 ID。將這些值存儲(chǔ)為托管機(jī)密，并將它們作為環(huán)境變量或直接傳遞到應(yīng)用程序的配置中，具體取決于您的偏好。

WORKOS_API_KEY='sk_example_123456789'
WORKOS_CLIENT_ID='client_123456789'

2.將 AuthKit 添加到您的應(yīng)用程序
讓我們將托管身份驗(yàn)證流程集成到您的應(yīng)用程序中。
將用戶重定向到 AuthKit
首先，我們需要引導(dǎo)用戶使用 AuthKit 登錄（或注冊(cè)），然后再將他們重定向回您的應(yīng)用程序。我們將通過生成 AuthKit 授權(quán) URL 服務(wù)器端并將用戶重定向到它來完成此操作。

您可以使用可選的狀態(tài)參數(shù)對(duì)任意信息進(jìn)行編碼，以幫助恢復(fù)重定向之間的應(yīng)用程序state 。

const express = require('express');
const { WorkOS } = require('@workos-inc/node');

const app = express();
const workos = new WorkOS(process.env.WORKOS_API_KEY);
const clientId = process.env.WORKOS_CLIENT_ID;

app.get('/auth', (req, res) => {
  const authorizationUrl = workos.userManagement.getAuthorizationUrl({
    // Specify that we'd like AuthKit to handle the authentication flow
    provider: 'authkit',

    // The callback endpoint that WorkOS will redirect to after a user authenticates
    redirectUri: 'http://localhost:3000/callback',
    clientId,
  });

  // Redirect the user to the AuthKit sign-in page
  res.redirect(authorizationUrl);
});

添加回調(diào)端點(diǎn)
接下來，我們添加回調(diào)端點(diǎn)（在配置重定向 URI中引用），它將為經(jīng)過身份驗(yàn)證的 User 對(duì)象交換授權(quán)代碼（有效期為 10 分鐘）。

const express = require('express');
const { WorkOS } = require('@workos-inc/node');

const app = express();

const workos = new WorkOS(process.env.WORKOS_API_KEY);
const clientId = process.env.WORKOS_CLIENT_ID;

app.get('/callback', async (req, res) => {
  // The authorization code returned by AuthKit
  const code = req.query.code;

  if (!code) {
    return res.status(400).send('No code provided');
  }

  const { user } = await workos.userManagement.authenticateWithCode({
    code,
    clientId,
  });

  // Use the information in `user` for further business logic.

  // Redirect the user to the homepage
  return res.redirect('/');
});

驗(yàn)證身份驗(yàn)證流程
導(dǎo)航到我們創(chuàng)建的身份驗(yàn)證端點(diǎn)并注冊(cè)一個(gè)帳戶。然后，您可以使用新創(chuàng)建的憑據(jù)登錄并查看WorkOS 儀表板的“用戶”部分中列出的用戶。

處理用戶會(huì)話
將會(huì)話管理與 WorkOS 集成有兩種方法：
A.?使用authkit-nextjs
如果使用authkit-nextjs庫，則會(huì)為您處理會(huì)話管理。無需進(jìn)一步集成。
B.?手動(dòng)
為了在應(yīng)用程序中保留用戶的身份驗(yàn)證狀態(tài)，我們需要存儲(chǔ)和訪問會(huì)話。

詳情查看鏈接：https://workos.com/docs/user-management/1-configure-your-project