什么是WorkOS的用戶管理服務?

什么是WorkOS的用戶管理服務接口？

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

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

WorkOS的用戶管理服務的核心優勢是什么？

在哪些場景會用到WorkOS的用戶管理服務？

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

1.配置您的項目

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

npm install @workos-inc/node

配置重定向 URI
重定向 URI 是 WorkOS 在用戶進行身份驗證后重定向到的回調端點。該端點將用 WorkOS 返回的授權代碼交換經過身份驗證的User 對象。我們將在下一步中創建此端點。

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

設定秘密
要調用 WorkOS，請提供 API 密鑰和客戶端 ID。將這些值存儲為托管機密，并將它們作為環境變量或直接傳遞到應用程序的配置中，具體取決于您的偏好。

WORKOS_API_KEY='sk_example_123456789'
WORKOS_CLIENT_ID='client_123456789'

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

您可以使用可選的狀態參數對任意信息進行編碼，以幫助恢復重定向之間的應用程序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);
});

添加回調端點
接下來，我們添加回調端點（在配置重定向 URI中引用），它將為經過身份驗證的 User 對象交換授權代碼（有效期為 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('/');
});

驗證身份驗證流程
導航到我們創建的身份驗證端點并注冊一個帳戶。然后，您可以使用新創建的憑據登錄并查看WorkOS 儀表板的“用戶”部分中列出的用戶。

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

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