--- title: "SCIM 配置故障排除" slug: "scim-provisioning-troubleshooting" updated: 2026-09-02T23:44:58Z published: 2026-09-02T23:44:58Z canonical: "knowledge.catonetworks.com/scim-provisioning-troubleshooting" --- > ## 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 配置故障排除 SCIM 配置是 来自身份提供者 (IdP) 的目录服务功能,用于在 Cato 管理应用程序 (CMA) 内配置用户。 无法完成此配置意味着用户将不会被添加到 CMA。 此剧本旨在提供故障排除SCIM 配置过程中的问题指南。 # 症状 SCIM 配置问题可以通过多种方式显现。 管理员可能注意到以下症状: - SCIM 配置无法启用 - 无法通过 SCIM 配置将用户添加到 CMA - 新用户已添加到 CMA,但无法正常工作 - 无法通过 SCIM 配置将更多用户添加到 CMA - SCIM 用户已更新,但更改未在 CMA 中反映出来 # 可能的原因 以下是可识别故障排除时可能的原因 - 该账户不符合 SCIM 配置的要求 - IdP 和 CMA 之间的凭证不匹配 - IdP 中缺少属性,无法传播到 CMA - 许可证不足,无法配置用户 - IdP 中的群组未分配到应用程序 - 用户或群组在配置应用程序中范围设置不正确 - 所需的用户或群组嵌套在 IdP 中 - 用户或群组没有从配置应用程序的相关字段更新到 CMA ## 故障排除 管理员可能遇到的症状排查步骤如下所示。 这些步骤旨在确定面临问题的可能原因。 解决步骤将在本手册中稍后突出显示。 ### 故障排除 SCIM 配置无法启用 #### 确保账户符合 SCIM 配置的要求 尝试启用 SCIM 时注意展示的错误信息。 在这种情况下 *无法启用 SCIM 配置。* 请联系支持并参考账户 ID 配置 - 电子邮件" ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(148).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=gY2brUSmPgQ5rd2J1%2B5Rt16RKW2%2BtVUb6W4Zous%2FBqM%3D) ### 故障排除初始 SCIM 配置无法将用户添加到 CMA #### 确认配置应用程序中的凭证正确 转到**SCIM 应用程序 > 配置 > 配置 > 管理员凭证**,按下**测试连接**并查看错误信息: ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(149).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=2dWrcU3oFgX6W2fnq%2Bu7wrrVU6o%2BGSDeZ%2BUDocUxiy4%3D) #### 检查可用许可证 检查账户的事件,在**监控 > 事件**应用过滤器:**事件类型是系统**,检查具有**子类型 Sdp 许可证**的事件 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(150).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=j2yRBot1y4cRtQMs065Mpzl1kWcLY0xl4voeDqh2%2BVs%3D) ### 故障排除新用户已添加到 CMA,但无法正常工作 #### 确认 CMA 中的属性正在正确填写 CMA 不能为没有必需电子邮件属性的用户分配许可证。 检查用户条目在**访问 > 用户 > 用户目录**并确认电子邮件字段具有有效内容。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(151).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=qmVbKeqX0jfrOb91uWMCIo10Zrt6DH91HTnsu3%2F3g1Y%3D) 检查账户的事件,在**监控 > 事件**应用过滤器:**事件类型是系统** ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(152).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=xVo3vknYYtKk0kc81DWGUowb3Y5WHSFyfXjJFhkPMio%3D) #### 检查可用许可证 检查账户的事件,在**监控 > 事件**应用过滤器:**事件类型是系统**,检查具有**子类型 Sdp 许可证**的事件 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(153).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=ttFgtaR2SBfbEklXQuV7cABOH76ZmZc9816fN2WTQV4%3D) ### 故障排除无法通过 SCIM 配置将更多用户添加到 CMA #### 检查用户或群组不在 CMA 中出现的位置 如果无法在 CMA 的 **访问 > 用户 > 用户目录** 或 **访问 > 用户群组**中看到预期的用户或群组。 对于**用户目录**可以通过**来源 SCIM**进行过滤 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(154).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=Ck%2B6AvvFr7rARCDoid1NRjMxsZbX9kEqsdYUfT%2F9QKo%3D) 对于**用户群组**查看**类型: SCIM 定义** ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(155).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=1UWNdvTImsawSd7QST%2BwZkuo5fqq7ptF6K9YN4XobMc%3D) #### 验证使用按需配置功能故障的原因 在配置应用程序中,您可以通过使用**按需配置**功能来确认用户的范围。 转到**企业应用程序 > Cato 配置应用程序 > 配置 > 按需配置**输入用户详细信息并按下**配置**。 一旦失败,您可以查看跳过的操作的详细信息 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(156).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=gX47vcxB89hOFyDnqrZsuPY7dfbAgbwedqphanYCZ7A%3D)在此场景中,我们可以看到该用户是部门**兄弟会**的一部分,而该规则 *'没有变种人'*不符合范围规则,具有条款 **部门不等于‘兄弟会’** #### ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(157).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=Mz46My8KcWxFIcG%2F9%2Ffad%2BmhaDkTrSkqLFDYgLdTIsM%3D)检查其他配置错误。 还有其他场景,例如群组不属于应用程序,审查展示的消息并识别原因。 在这种情况下,群组是**活跃的**并符合**范围**,但报告为未**分配到应用程序**: ### ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(158).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=jZo%2FFoqoCqjQhTjpKf%2BsHt4VKbSwuuKE4YmK%2F0Nfz90%3D)故障排除 SCIM 用户已更新,但更改未在 CMA 中反映出来 用户可能在 SCIM 配置应用程序中更新了属性,但在完成配置同步后未反映出来。 ## 解决已发现的问题 ### 解决账户不符合 SCIM 配置的要求 您需要向 Cato 支持提出问题。 请参见下面的提高案例到 Cato 支持部分。 ### 解决 IdP 和 CMA 之间的凭证不匹配 转到**SCIM 应用程序 > 配置 > 配置 > 管理员凭证**。 确保应用程序的凭证(租户 URL 和令牌)有效。 CMA 中提供凭证,位于 **访问 > 目录服务 > SCIM** ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(159).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=DhsWh6JMoXyev74NrwT1%2BEes7127STjw6WMqikhOBjs%3D) 这可以通过在配置应用程序中按下测试连接按钮来验证。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(160).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=3E49v%2BHBBSztordRPqdvHvbQ2VD2SCX19sPhwCrfqbo%3D) ### IdP 中缺少属性,无法传播到 CMA 转到**企业应用程序 > Cato 配置应用程序 > 配置 > 配置 > 映射**然后选择 **配置 Microsoft Entra ID 用户**在**属性映射**部分确认 **userPrincipalName** 以及 **电子邮件地址**已被映射。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(161).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=34v0kRbBk8FPgwacgO%2FUkMWshUgassI3f4QvYu3wrDY%3D) ### 解决许可证不足,无法配置用户 在 CMA 中转到**管理 > 许可证 > 用户**并验证是否有足够的许可证来配置您尝试添加的用户数量。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(162).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=IRisUzdX16JjkbJTMykO8zZ22xT5o6Jh%2BFSi8QxYf1E%3D)如果缺乏足够的许可证,请取消分配/禁用/删除不活动的用户或联系您的销售团队以获取更多许可证选项。 ### 解决 IdP 中的群组未分配到配置应用程序 转到**企业应用程序 > Cato 配置应用程序 > 用户 & 群组**并验证该用户/群组是否在列表中。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(163).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=%2Bdw38tF9vIiITZb8J3GjpsBfDdWKS6vMGiMqct4e8X4%3D)如果不存在,可以通过**添加用户/群组**按钮添加。 ### 用户或群组在配置应用程序中范围设置不正确 转到**企业应用程序 > Cato 配置应用程序 > 配置 > 配置 > 映射**然后选择 **用户**或**群组**映射。 验证来源对象范围过滤器是否包含相关的用户/群组。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(165).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=5ASqTK8QYKUW3UOlWNh9mL3f4pVtejbiXYFIKp%2BVGpQ%3D) ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(166).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=B4BOmFFYpKwbXJftZXHvTYkWtRDZidEBKAiLgNdF4ro%3D) ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(169).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=cxxWn426uSdzN%2FEYATsNfMzNzNK%2B372UwDtr3NzCjLQ%3D) **注意:**多个范围过滤器使用或逻辑,而过滤器中的多个属性使用和逻辑。 ### 所需的用户或群组嵌套在 IdP 中 确认在将群组添加到配置应用程序时,它们作为单独条目添加,而不是嵌套在其他群组中。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(168).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A07%3A03Z&se=2026-11-19T06%3A07%3A03Z&sr=b&sp=r&sig=b322MaYSTPdI0cgK9q%2F3mlA9pM40x3zwgHKWXtNetWk%3D) ### 解决 SCIM 用户已更新,但更改未在 CMA 中反映出来 执行同步时,确认 IdP 中用户的以下字段之一是否已更新。 - 电子邮件 - UPN - 名字 - 姓氏 - 电话号码 如果问题仍然存在,尝试从您的 IdP 中删除用户,如果可能,然后检查用户是否进入 CMA 的禁用状态。 如果没有,请提升到支持。 # 上传案例到 Cato 支持 如果按照本剧本操作后问题仍未解决,请使用此[知识库文章](https://support.catonetworks.com/hc/zh-cn/articles/360017066338-Submitting-a-Support-Ticket)提交支持工单。 为了获得最有用的请求响应,管理员应提供在使用此剧本过程中采取的故障排除步骤结果。 例如包括: - 账户名称/号码 - 使用中的 IdP 提供商详细信息 - 来自 IdP 的截图,其中包含相关用户的 UPNs - 来自 IdP 的用户组详细信息