跳到主要内容
版本:3.9.x

使用 Okta 配置 SCIM 账号同步

Okta 是一个基于云的身份和访问管理平台,为应用程序提供安全的身份验证和用户管理。通过使用 SCIM(System for Cross-domain Identity Management,跨域身份管理系统)将 Okta 与 API7 企业版集成,你可以自动将用户账号从 Okta 同步到 API7 控制台,从而消除手动管理用户的需求并确保一致的访问控制。

本指南将引导你配置 Okta 和 API7 企业版之间的 SCIM 账号同步。

前提条件

  1. 安装 API7 企业版
  2. 拥有一个具有管理员权限的 Okta 账户。

在 Okta 中创建 SCIM 应用程序

搜索 SCIM 集成

  1. 登录 Okta Admin Console(管理控制台)。
  2. 从侧边导航栏导航至 Applications > Applications(应用程序 > 应用程序)。
  3. 点击 Browse App Catalog(浏览应用目录)。
  4. 在搜索栏中搜索 SCIM
  5. 从搜索结果中选择 SCIM 2.0 Test App (Header Auth)

Search for SCIM integration in Okta

添加集成

  1. 点击 Add Integration(添加集成)将 SCIM 测试应用程序添加到你的 Okta 组织中。

Add SCIM integration

配置常规设置

  1. General Settings(常规设置)选项卡中,根据需要配置应用程序名称和其他设置。

Configure general settings

配置登录选项

  1. Sign-On Options(登录选项)选项卡中,选择 Secure Web Authentication (SWA) 作为登录方法。(你也可以根据需要选择合适的登录方法,如 SAML 2.0)。

Select sign-on options

  1. 点击 Done(完成)保存应用程序。

Save to add the application

在 API7 控制台中启用 SCIM

  1. 使用管理员账号登录 API7 控制台。
  2. 从顶部导航栏选择 组织 (Organization),然后选择 设置 (Settings)。

Dashboard settings

  1. 启用 SCIM 账号同步 (SCIM Provisioning)。

Enable SCIM provisioning

  1. 复制 API7 SCIM 端点 URL (API7 SCIM Endpoint URL) 和 SCIM 令牌 (SCIM Token)。你将需要这些值来配置 Okta 集成。

Copy SCIM URL and token

在 Okta 中配置 SCIM 集成

配置 API 集成

  1. 返回 Okta Admin Console 并导航至你的 SCIM 应用程序。
  2. 选择 Provisioning(账号同步)选项卡。

Select provisioning tab

  1. 点击 Configure API Integration(配置 API 集成)。
  2. 勾选 Enable API Integration(启用 API 集成)。
  3. 输入从 API7 控制台复制的 SCIM 2.0 Base URL
  4. API Token(API 令牌)字段中,输入 Bearer <your_token>。将 <your_token> 替换为你从 API7 控制台复制的 SCIM 令牌。
备注

请确保在 Bearer 之后包含一个空格。

  1. 点击 Test API Credentials(测试 API 凭证)验证连接,然后点击 Save(保存)。

Configure API integration

启用账号同步功能

  1. Provisioning(账号同步)选项卡中,从左侧面板选择 To App(到应用程序)。
  2. 点击 Edit(编辑)修改账号同步设置。

Edit provisioning settings

  1. 根据需要启用 Create Users(创建用户)、Update User Attributes(更新用户属性)和 Deactivate Users(停用用户)。
  2. 点击 Save(保存)应用更改。

Enable create users

将用户分配给应用程序

  1. 在 SCIM 应用程序中,选择 Assignments(分配)选项卡。
  2. 点击 Assign(分配)并选择 Assign to People(分配给人员)。

Assign to people

  1. 选择你希望同步到 API7 企业版的用户。

Select people to assign

  1. 为每个选定的用户点击 Assign(分配),然后点击 Done(完成)。

Save selection

  1. 验证用户是否已分配给该应用程序。

Check assigned users

验证用户同步

  1. 返回 API7 控制台。
  2. 从顶部导航栏选择 组织 (Organization),然后选择 用户 (Users)。
  3. 验证在 Okta 中分配的用户是否已同步到 API7 控制台。

Verify users in Dashboard

附加资源