--- title: "SCIM 配置与 OneLogin" slug: "scim-provisioning-with-onelogin" updated: 2026-07-30T03:30:12Z published: 2026-07-30T03:30:12Z canonical: "knowledge.catonetworks.com/scim-provisioning-with-onelogin" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # SCIM 配置与 OneLogin 本文解释了如何使用 OneLogin Cato SCIM 应用程序从您的 OneLogin 账户自动同步用户到您的 Cato 账户。 ## 功能支持 Cato Networks 提供下一代安全网络架构,消除了依赖零散点解决方案的传统 IT 方法带来的复杂性、成本和风险。 从单点登录(SSO)到用户配置,OneLogin的Cato集成在整个用户生命周期内处理用户访问和群组,包括: - 在Cato 管理应用程序中创建和移除用户 - 从 OneLogin 同步用户和属性到 Cato 管理应用程序 - 单点登录(SSO)到 OneLogin - 更新用户属性 - 停用用户 - 导入用户 - 导入群组 (OneLogin 角色) ### 要求 确保在创建自定义 Cato SCIM 应用程序之前,您在 OneLogin 中有管理员权限可以配置应用程序和用户配置。 ### 已知局限性 - 在 OneLogin 中已删除的用户在 Cato 管理应用程序中被禁用 - 从 OneLogin 中已删除的角色,其对应的群组在 Cato 管理应用程序中不会被删除 - 不支持嵌套群组 - SCIM同步覆盖现有的相同名称的LDAP群组。 查看更多信息,请参阅《如何SCIM同步覆盖现有LDAP群组》 ## 配置Cato SCIM 应用以自动同步用户到Cato 您可以在 OneLogin 应用程序库中使用 Cato SCIM 应用程序,从您的 OneLogin 账户连接和同步用户到您的 Cato 账户。 本节解释了如何根据以下工作流程配置此 SCIM 应用程序: - 在Cato 管理应用程序,启用 SCIM 配置您的Cato账户 - 在您的 OneLogin 账户中添加Cato SCIM 应用 - 配置该应用以连接到您的Cato账户 - 定义在 OneLogin 中同步的用户 - 定义从 OneLogin 同步到您Cato账户中的群组的角色 身份提供者(IdP)中用户的状态会自动同步到您的Cato账户。 例如,当您在 IdP 中禁用用户时,他们将在您的 Cato 账户中同步为已禁用。 ### 为 SCIM 应用配置Cato 管理应用程序 在 Cato 管理应用程序 中,启用 SCIM 配置并将 URL 和令牌复制到文本文件。 您将在 Cato SCIM 应用程序中输入这些设置,该应用程序配置在您的 OneLogin 账户中。 **连接****Cato 管理应用程序****到 SCIM 应用** 1. 在 Cato 管理应用程序中,从导航菜单选择 **访问 > 目录服务**并点击 **SCIM** 标签页。 ![SCIM.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218199917469.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=%2B4XcWjyDMw3yA8xKqHwvC45tWcS6x31DbjLKw10rMRo%3D) 2. 选择**启用SCIM配置**以连接您的账户到SCIM App。 3. 单击 **保存**。 4. 复制并粘贴SCIM URL和令牌到空白文本文件。 1. 在**基本URL**中点击复制图标![copy.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218199999517.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=4GPhoEG6ED%2B4miEtjLC3DjA4t1ubVrS0hUHJ7fHR9EU%3D)将SCIM URL复制到剪贴板,然后粘贴到文本文件。 2. 在**Bearer令牌**中点击复制图标![copy.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218199999517.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=4GPhoEG6ED%2B4miEtjLC3DjA4t1ubVrS0hUHJ7fHR9EU%3D)将唯一账户令牌复制到剪贴板,然后粘贴到文本文件。 ### 添加Cato SCIM 应用 您可以将 Cato SCIM 应用程序添加到您的 OneLogin 账户,并使用它将用户从您的 OneLogin 账户配置到您的 Cato 账户。 要将 Cato SCIM 应用程序添加到您的 OneLogin 账户: **要将** **Cato** **SCIM 应用添加到您的 OneLogin 账户:** 1. 在您的 OneLogin 管理仪表板上,点击 **应用程序 > 应用程序**。 2. 点击**添加应用**。 3. 搜索**Cato Networks**应用程序,然后单击带有**SAML2.0,配置中**的**Cato Networks**应用程序。 ![OneLogin_CatoApp.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218224303901.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=Qfe%2FwNIQE26UP26Sig8iMXVS08ZVQL8UGreytF8Lp0M%3D) 4. 在 **应用程序列表 / 添加 Cato Networks** 窗口中,输入应用程序的 **显示名称**,然后单击 **保存**。 ![OneLogin_CatoApp_AddApp.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218224381725.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=WjKie0vsRXkVDSiq98a%2FzOrSFrJi40JBQNNVfJZHt4k%3D) 消息显示应用程序已成功添加到你的账户。 ### 配置 SCIM 应用以连接到您的账户 在应用程序的 **配置** 和 **配置中** 部分中配置设置,以便它可以连接到你的 Cato 账户。 您需要输入从 Cato 管理应用程序 复制的 URL 和令牌,具体见上文中的 [配置 SCIM 应用程序的 Cato 管理应用程序](/v1/docs/scim-provisioning-with-onelogin#configuring-the-cato-management-application-for-the-scim-app)。 **配置 SCIM 应用以连接到您的** **Cato** **账户:** 1. 从应用程序导航窗格,点击 **配置**。 2. 在**API连接**部分中,配置OneLogin以与您的账户集成: ![OneLogin_CatoApp_Configuration.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218224455965.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=CYF%2Bd8IpEfH8gYFas%2BnLSsrGz3DJm2ZOaHFhG390aX0%3D) 1. 在 **SCIM 基本 URL**中,粘贴从Cato 管理应用程序复制的 URL。 2. 在 **SCIM Bearer 令牌**中,粘贴从Cato 管理应用程序复制的令牌。 3. 在 **API 状态**中,点击 **启用**。 4. 单击 **保存**。 5. 从导航窗格中点击**配置中**。 ![OneLogin_CatoApp_Provisioning.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218213678493.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=F9mDFUd%2F9CI4Y469CMI9WukyGp%2BPZn0tvZQT99JvGvE%3D) 6. 为应用程序配置这些配置设置: 1. 选择 **启用配置**。 2. **(可选)** 配置 **在执行此操作之前需要管理员批准** 设置: 3. 在 **当用户在 OneLogin 中被删除,或者用户的应用访问被移除时,执行以下操作**中,选择 **暂停**。 4. 确保在 **权限** 部分中的 **刷新** 链接是可点击的。 7. 应用程序在 **集成的应用程序** 表中显示,状态为 **已连接**。 Cato SCIM应用程序的参数已配置,应用程序已准备好连接到您的Cato账户。 ## 同步 VPN 用户到您的 Cato 账户 SCIM应用程序可以连接到您的账户后,分配您正在同步到Cato的用户。 然后您可以继续下一部分以将组添加到应用程序。 **为您的** **Cato** **账户配额用户:** 1. 从顶部菜单,选择 **用户 > 用户**。 2. 选择您要分配给SCIM应用程序的用户。 ![OneLogin_SelectUser.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218238784285.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=uce7fKxFszbQkayyURXn7XZG2JJeJIY5kB3OxGV3Rlk%3D) 3. 从用户的导航窗格中选择**应用程序**。 ![OneLogin_User_Applications.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218238871325.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=vNhf5M97pn1YAkRccet0OLSasVXLqWFdrgNd5X02brk%3D) 4. 将 SCIM 应用分配给用户: 1. 点击加号按钮为用户添加一个新应用程序。 2. 在**分配新登陆到**窗口中,从**选择应用程序**下拉菜单中选择SCIM应用程序。 ![OneLogin_User_Applications_AssignApp.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218200549789.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=piX8gcqeYh4WPq%2BPg0bOi149SIAZire62BWpcGn%2BRv4%3D) 3. 点击**继续**。 4. 在弹出窗口中,点击**保存**。 ![OneLogin_EditAppForUser.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218200628125.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=EmTmWdFBgASJ40xawX3p1kX7DS%2BcfXjcEPeiOYTkxWQ%3D) SCIM应用程序已分配给用户。 5. 点击 **保存用户**。 该用户的设置已更新。 6. 对每个您配置到您的Cato账户的用户重复上述步骤4和5。 要显示分配给SCIM应用程序的用户,请转到SCIM应用程序并从应用程序导航窗格中选择**用户**。 ## 同步 OneLogin 角色到您的 Cato 账户 您可以在OneLogin中与您正在同步到Cato的用户一起分配角色。 您可以选择手动为此角色添加用户。 为每个角色创建一个将角色连接到应用程序的规则。 然后将角色分配给应用程序,角色及其关联用户被同步到您Cato账户中的新组。 **为您的** **Cato** **账户预配 OneLogin 角色:** 1. 从顶部菜单,选择 **用户 > 角色**。 2. 选择您将分配给 SCIM 应用的角色。 3. **(可选)** 手动为角色分配用户: 1. 从角色的导航菜单中,选择**用户**。 ![OneLogin_Role_AddUser.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218239197469.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=i3owOI5OOnU10SnRB9XyYJqM%2BuLxzuJV62IKaWCefMY%3D) 2. 在 **检查现有用户或向此规则添加新用户**中,输入您要添加到应用程序的用户名。 3. 点击 **检查**,窗口中显示用户。 4. 点击 **添加到角色**。 该用户已被添加到 **手动添加的用户** 部分。 4. 创建一个规则将角色连接到 SCIM 应用。 1. 从顶部菜单,点击 **应用程序 > 应用程序** 然后打开 SCIM 应用。 2. 从应用程序导航窗格,选择 **规则**。 3. 点击 **添加规则**。 4. 在**新映射**窗口中,为规则输入一个**名称**。 ![OneLogin_App_Rule.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218195700381.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=VkrwIKwRVY%2FUqEmGdM12%2BWp7cKfBgqPac9gGXv8M7os%3D) 5. 在 **操作** 部分,选择 **在 <应用程序名称> 中设置群组**。 上图显示选项为 **在 Sample Cato SCIM 应用中设置群组**。 6. 从 **每个** 下拉菜单,选择角色。 7. 输入角色名称匹配的**值**。 上图显示角色名为 **示例角色**。 8. 单击 **保存**。 规则已添加到应用程序。 ![OneLogin_Rule_Configured.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218239313693.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=NuBz3OOKX90j0ZKvFvMTtVmySApC3au5zI7hTTnDl6c%3D) 9. 单击 **保存**。 连接角色到应用程序的规则已保存到应用程序。 5. 将SCIM应用程序分配给角色。 SCIM应用程序将角色从OneLogin同步到您的Cato账户。 1. 从角色的导航菜单,选择 **应用程序**。 2. 点击加号按钮显示在您 OneLogin 账户中的应用程序。 3. 选择Cato SCIM 应用程序,然后点击**保存**。 应用程序已添加到角色。 ![OneLogin_Role_Add_App.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24218225187357.png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A31%3A33Z&se=2026-11-19T06%3A31%3A33Z&sr=b&sp=r&sig=RdchZn3rqO%2BsNaQCcDGPtAQklQynN%2BtbgiOEzRoGr7w%3D) **从SCIM应用程序中移除用户或群组** ### 重要 **重要:**不要直接从Cato 管理应用程序删除使用SCIM应用程序配置的用户或群组。 您必须首先在SCIM应用程序中取消分配它们。 当您希望删除通过 SCIM 应用配额到您的Cato账户的用户或群组时,请在应用程序中取消其分配。 在 SCIM 应用下次与您的账户同步时,用户和群组会自动被禁用。 **删除同步到您的** **Cato** **账户的用户或群组:** 1. 在Cato SCIM应用程序中,取消分配用户或群组。 在下次同步期间,SCIM应用程序将在您的Cato账户中禁用用户或群组。 2. **(可选)** 用户或群组被禁用后,您可以从 Cato 管理应用程序中删除他们。 ## 分配 ZTNA 许可证 在 IdP 中,定义同步到您的 Cato 账户的群组和用户。 在初始同步完成后,所有用户将被创建到 Cato 管理应用程序中,并可在 **用户目录** 页面上查看。 然后您可以为用户分配 ZTNA 许可证,欲知更多信息,请参阅 [为用户分配 ZTNA 许可证](/v1/docs/assigning-ztna-licenses-to-users)。 ## 了解SCIM配置的事件 Cato 管理应用程序 在用户和群组因未满足客户端连接策略要求而受阻时生成事件。 每小时,Cato 管理应用程序 都会发送电子邮件警报,汇总 SCIM 配置操作(成功或失败)。 下表解释了不同事件。 | 事件类型 | 操作 | 描述 | | --- | --- | --- | | SCIM配置 | 成功 | 通过SCIM应用将用户或群组同步到您的账户的操作已成功。 | | SCIM配置 | 失败 | SCIM应用未能将IdP与您的账户同步。 **事件消息**解释了同步失败的原因。 | | SCIM配置 | 已禁用 | IDP中已禁用的用户成功同步并禁用到您的Cato账户。 |