Citrix Cloud™

故障排除

当我开启 SAML 支持案例时,需要向 Citrix 支持和工程团队提供哪些信息?

如果您需要 SAML 相关问题的帮助,Citrix 支持和工程团队需要以下信息:

  • 提供足够的上下文,并描述您的登录场景以及 Citrix 或 Active Directory 环境。
  • 您在初始配置期间遵循了哪些 Citrix eDocs。
  • 您的 IdP 中 SAML 应用程序的屏幕截图和详细信息。
  • 您的 Active Directory 详细信息。
  • 来自 SAML 跟踪器浏览器扩展的 SAML 跟踪器文件 (.json)。
  • 来自浏览器开发工具的 HAR 文件 (.har)。
  • 正常工作和出现故障的最终用户或 Citrix Cloud 管理员用户的详细信息。
  • 执行 SAML 登录到 Store 或 Citrix Cloud 的机器的公共调用方 IP。

为 Citrix 支持和工程团队捕获 SAML 跟踪

Citrix 工程和支持团队建议使用 SAML 跟踪器浏览器扩展进行所有 SAML 调试,以及使用浏览器开发工具生成的 .HAR 文件。此扩展适用于大多数常用 Web 浏览器,并可导出 .JSON 文件。该扩展将 SAML 请求和响应解码为 XML,使其易于阅读,更易于理解和调试。

突出显示 SAML 跟踪器的 Firefox 浏览器扩展列表

SAML 跟踪器文件输出

如何从我的浏览器收集 HAR 文件并发送给 Citrix 支持和工程团队?

有关更多信息,请参阅文章 收集 HAR 文件

有用的第三方 SAML 调试工具

重要提示:

当使用第三方工具进行调试时,Citrix 不承担任何责任。使用和访问第三方工具和网站的风险由您自行承担。

工具 用途
https://www.samltool.io/ 解码 base 64 SAML 请求和响应
https://www.sslshopper.com/certificate-decoder.html 解码证书数据
https://www.rcfed.com/SAMLWSFed/MetadataCertificateExtract 从 SAML 元数据中提取签名和加密证书文件
https://www.whatismyip.com/ 提供尝试 SAML 登录的客户端的调用方 IP。

属性错误

属性错误可能在以下任何一种情况下发生:

  • SAML 配置中所需的属性未正确编码。
  • SAML 断言中缺少 cip_sid 和 cip_upn 属性。
  • SAML 断言中缺少 cip_sid 或 cip_oid 属性,并且由于连接问题,Citrix Cloud 无法从 Active Directory 中检索它们。

发生属性错误时,Citrix Cloud 会显示一条错误消息,其中包含有问题的属性。

包含 cip_oid 的属性错误消息(/en-us/citrix-cloud/media/saml-idp-missing-attribute-error.png)

要解决此类错误:

  1. 确保您的 SAML 提供程序以正确的编码发送所需的属性,如以下表格所示。至少必须包含 SID 或 UPN 属性之一。

    属性 编码 必需
    cip_email 必须是字符串格式 (user@domain)
    cip_oid 必须是 Base64 或字符串格式
    cip_sid 必须是 Base64 或字符串格式 是,如果未使用 cip_upn
    cip_upn 必须是字符串格式 (user@domain) 是,如果未使用 cip_sid
  2. 验证 Cloud Connector 在线且运行状况良好,以便 Citrix Cloud 可以检索其所需的任何缺失属性。有关更多信息,请参阅 Cloud Connector 高级运行状况检查。

意外错误

在以下情况下,Citrix Cloud 可能会遇到意外错误:

  • 用户使用 IDP 发起的流程启动 SAML 请求。例如,通过身份提供商的应用程序门户选择磁贴而不是直接导航到商店 URL (customer.cloud.com) 来发出请求。
  • SAML 证书无效或已过期。
  • 身份验证上下文无效。
  • SAML 断言和响应签名不匹配。

发生此错误时,Citrix Cloud 会显示一条通用错误消息。

意外错误消息

如果此错误是由于通过身份提供商的应用程序门户导航到 Citrix Cloud 引起的,您可以使用以下解决方法:

  1. 在身份提供商的应用程序门户中创建一个引用您的商店 URL 的书签应用程序(例如,https://customer.cloud.com)。
  2. 将用户分配给 SAML 应用程序和书签应用程序。
  3. 更改 SAML 应用程序和书签应用程序的可见性设置,以便书签应用程序可见,而 SAML 应用程序在应用程序门户中隐藏。
  4. 禁用 Citrix® StoreFront Cloud 中的“始终提示最终用户输入其凭据”设置,以消除额外的密码提示。有关说明,请参阅始终提示最终用户输入其凭据。