--- title: "配置 Keycloak SSO" slug: "configuring-keycloak-sso" updated: 2026-10-15T23:14:18Z published: 2026-10-15T23:14:18Z canonical: "knowledge.catonetworks.com/configuring-keycloak-sso" --- > ## 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. # 配置 Keycloak SSO 本文说明如何将 Keycloak 配置为 SDP 用户和 Cato 管理应用程序(CMA)管理员的唯一单点登录(SSO)提供程序。 SSO 依赖来自 Cato 和你的 IdP 的加密令牌来验证用户已通过身份认证并允许连接到网络。有关详细信息,请参阅 [Cato 用户的 SSO 认证](/v1/docs/sso-authentication-for-users-with-cato)。 ## 概况 您可以配置 Keycloak 作为 SSO 提供程序,以集中管理 CMA 管理员和通过 Cato 客户端连接的远程用户的认证。此集成通过强制登录 Keycloak 凭据提高了账户安全性并简化了身份管理。 确保 Cato 中每位用户和管理员的电子邮件地址与 Keycloak 中的相应电子邮件地址匹配。 一旦启用 SSO,管理员必须通过 Keycloak 进行认证以访问 CMA,管理员和用户都必须通过 Keycloak 进行认证以连接 Cato 客户端。 ## 配置 Keycloak 作为 SSO 提供程序 按照以下步骤配置 Keycloak 作为 SSO 提供程序: 1. 在您的 Keycloak 管理控制台中将 Cato 添加为 Keycloak 客户端 2. 在 CMA 中输入您的 Keycloak 主机的详细信息 ### 步骤 1:将 Cato 添加为 Keycloak 客户端 在 Keycloak 管理控制台中,将 Cato 添加为客户端。将 Cato URI 加入白名单,以配置 Cato 作为客户端的一部分。您将在第 2 步中需要这些值: - 客户端 ID - ServiceNow 客户端密钥 此过程涉及 Keycloak 控制台,该控制台可能会更改。要阅读最新的 Keycloak 文档,请参阅 [管理资源服务器](https://www.keycloak.org/docs/latest/authorization_services/index.html#_resource_server_overview)。 **将 Cato 添加为 Keycloak 客户端:** 1. 在 Keycloak 中,转到 **客户端 > 创建客户端**。 2. 在 **常规设置** 选项卡中,输入基本设置,包括客户端 ID。您需要客户端 ID 以便稍后与 Cato 集成。 3. 在 **功能配置** 选项卡中,确保启用了 **客户端认证**。 ![keycloak_capability_config.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/30971045766429.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A42%3A45Z&se=2026-11-19T07%3A42%3A45Z&sr=b&sp=r&sig=ZE9AcvJ85yFkyauT%2B77yK%2F1l1rQgnbYbc46KfABIVjE%3D) 4. 在 **登录设置** 选项卡中,在 **有效重定向 URI** 中输入以下 Cato URI: ![keyCloak_login_settings.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/30971041745309.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A42%3A45Z&se=2026-11-19T07%3A42%3A45Z&sr=b&sp=r&sig=YvxZB5P8oLHai%2B2OEi%2BzOUzJCTxc%2FJnFwm6O0XCSkWM%3D) - https://sso.via.catonetworks.com/auth_results - https://sso.ias.catonetworks.com/auth_results - https://sso.proxy.catonetworks.com/auth_results - https://169.254.255.254/auth_results - https://auth.catonetworks.com/oauth2/broker/code/keycloak - https://auth.in1.catonetworks.com/oauth2/broker/code/keycloak - https://auth.jp1.catonetworks.com/oauth2/broker/code/keycloak - https://auth.us1.catonetworks.com/oauth2/broker/code/keycloak - https://auth.catonetworks.com/endsession/* - https://auth.in1.catonetworks.com/endsession/* - https://auth.jp1.catonetworks.com/endsession/* - https://auth.us1.catonetworks.com/endsession/* 5. 点击 **保存** 以创建 Keycloak 客户端。 6. 转到 **客户端** 区域,然后点击您刚创建的客户端。 7. 转到 **凭证** 选项卡并复制 **客户端密钥**。在 CMA 中创建 SSO 提供程序时,您将需要该值。 ![keycloak_client_secret.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/30971045809821.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A42%3A45Z&se=2026-11-19T07%3A42%3A45Z&sr=b&sp=r&sig=h%2FCUldFU5jHTsb1dBIMC83aBiC4qWtkmqNHuzLsLUkY%3D) ### 步骤 2:将 Keycloak 配置为您的 SSO 提供程序 在 CMA 中,输入您在上一步中创建的 Keycloak 客户端的详细信息: - Keycloak URL - 客户端ID - 客户密钥 Keycloak 网址的值是网址的开始部分,直到域名结束,不包含HTTPS。 例如,如果您用于访问 Keycloak 的 URL 是 **https://keycloak.example.com/realms/myRealm/.well-known/openid-configuration**,您将输入 **keycloak.example.com/realms/myRealm** 作为您的 Keycloak URL。 Cato支持为您的账户使用[多个IdPs进行SSO](/v1/docs/configuring-multiple-identity-providers)。仅默认 SSO 提供程序用于 CMA 管理员,请确保将 Keycloak 定义为 **默认** 认证方法。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image (18).png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A42%3A45Z&se=2026-11-19T07%3A42%3A45Z&sr=b&sp=r&sig=TImjwwtBs0I3Egw%2Bq4w7nVE3cs97POhYk5BJmBlZRQ8%3D) **将 Keycloak 配置为您的 SSO 提供程序:** 1. 在 CMA 中,从导航菜单中点击 **访问 > 单点登录**。 2. 点击 **新建**。 3. 从 **身份提供商** 下拉菜单中,选择 **Keycloak**。 4. 输入一个 **名称** 以识别此集成。 5. 输入您的 **Keycloak 网址**,不带协议前缀并仅到域名。 6. 输入在步骤 1 中创建的**客户端ID**和**ServiceNow 客户端密钥**。 7. 启用 **默认** 切换,以使用 Keycloak 作为 CMA 管理员的唯一 SSO 提供程序。 8. 点击 **应用**。 ## 已知局限性 - Red Hat 构建的 Keycloak 不支持 SSO