单点登录和 Webex Control Hub

单点登录 (SSO) 是一种会话或用户验证的流程,允许用户通过提供凭证来访问一个或多个应用程序。 此流程能够为用户已获得授权的所有应用程序验证用户。 这样用户在特定会话期间切换应用程序时,不会再看到额外提示。

安全断言标记语言 (SAML 2.0) 联合协议用于提供 Cisco Webex 云与您的身份提供程序 (IdP) 之间的 SSO 验证。

档案

Cisco Webex Teams 仅支持 Web 浏览器 SSO 档案。 在 Web 浏览器 SSO 档案中,Cisco Webex Teams 支持下列绑定:

  • SP 发起的 POST->POST 绑定

  • SP 发起的 REDIRECT->POST 绑定

NameID 格式

为了传达关于特定用户的信息,SAML 2.0 协议支持多种 NameID 格式。 Cisco Webex Teams 支持以下 NameID 格式。

  • urn:oasis:names:tc:SAML:2.0:nameid-format:transient

  • urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

  • urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

在您从 IdP 加载的元数据中,第一个条目是为在 Cisco Webex 中使用而配置的。

单点注销

Cisco Webex Teams 支持单点注销档案。 当用户在 Cisco Webex Teams 应用程序中注销时,系统会使用 SAML 单点注销协议结束会话并与您的 IdP 确认该注销操作。 请确保您的 IdP 经过单点注销配置。

集成 Cisco Webex Control Hub 与 PingFederate 以实现单点登录


配置指南给出了 SSO 集成的特定示例,但没有提供针对所有可能性的详细配置。 例如,记录了 nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient 的集成步骤。 其他格式如 urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified 或 urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress 也适用于 SSO 集成,但不在我们的文档范围内。

为 Cisco Webex 组织中的用户设置此集成(包括 Cisco Webex Teams、Cisco Webex Meetings 以及 Cisco Webex Control Hub 中管理的其他服务)。 如果 Webex 站点集成在 Cisco Webex Control Hub 中,Webex 站点会继承用户管理。 如果您无法用这种方式访问 Cisco Webex Meetings,且其不受 Cisco Webex Control Hub 管理,则必须另外执行集成来为 Cisco Webex Meetings 启用 SSO。 (请参阅配置 Webex 的单点登录了解站点管理中 SSO 集成的更多信息。)

开始之前

对于 SSO 和 Cisco Webex Control Hub,IdP 必须遵循 SAML 2.0 规范。 此外,IdP 必须按以下方式进行配置:
  • 将“NameID 格式”属性设置为 urn:oasis:names:tc:SAML:2.0:nameid-format:transient

  • 配置 IdP 声明,包括 uid 属性名称,其值要映射到在 Cisco 目录连接器中选择的属性或者映射到用户属性,而用户属性应与 Cisco Webex 身份服务中选择的用户属性匹配。 (例如,该属性可以是电子邮件地址,也可以是用户主体名称。) 请参阅 https://www.cisco.com/go/hybrid-services-directory 中的自定义信息获取指导。

  • 使用受支持的浏览器。 我们建议使用最新版本的 Mozilla Firefox 或 Google Chrome。

  • 禁止浏览器中的任何弹出式窗口拦截器。

将 Cisco Webex 元数据下载到本地系统

1

https://admin.webex.com 中的客户视图,转至设置,然后滚动到验证

2

单击修改,单击集成第三方身份提供程序。 (高级),然后单击下一步

3

下载元数据文件。

Cisco Webex 元数据文件名为 idb-meta-<org-ID>-SP.xml

配置新的服务商连接

1

转至 PingFederate 管理门户 (https://<FQDN of="" PingFederate="">:9999/pingfederate/app)。

2

在“SP 连接”下方选择“新建”。

3

选择“不使用此连接的模板”单选按钮,然后选择“下一步”。

4

选档“浏览 SSO 档案”,然后单击“下一步”。

5

选择“导入元数据”标签页。

6

单击选择文件,找到并导入您从 Cisco Webex Control Hub 下载的元数据文件,然后单击下一步

7

检查“常规信息”标签页中的信息,然后单击“完成”。

配置浏览器单点登录

1

从 PingFederate 管理门户选择“配置浏览器 SSO”。

2

勾选“SP 发起的 SSO”复选框,然后单击“下一步”。

3

选择“配置断言创建”。

  1. 将“NameID-format”更改为“瞬态”,然后勾选“包括瞬态标识符以及其他属性”复选框。

  2. 按以下格式添加“mail”和“uid”属性以扩展协议属性:urn:oasis:names:tc:SAML:2.0:attrname-format-basic。然后单击“下一步”。

  3. 选择“映射新的适配器实例”以选择验证机制。 从“适配器实例”下拉列表中选择一个先前配置的验证机制,然后单击“下一步”。

  4. 选择“使用一个映射从多个数据存储库检索更多属性”单选按钮,然后单击“下一步”。

  5. 选择“添加属性源”以添加域的 Active Directory 域控制器,然后单击“下一步”。

  6. 指定基本 DN,并选择根对象类 <Show All="" Attributes="">。 在“过滤器”文本框中,输入 LDAP 过滤器,然后单击“下一步”。

    该条目必须包含您期望用户提供的属性。 它还需要包含映射到 LDAP 源的值。 例如,如果您的 Active Directory 已设置为根据 Windows 登录属性进行过滤,请输入 sAMAccountName=${Username}

  7. 选择源和值,以将断言属性映射到 AD 数据存储库所提供的属性。 (不要在“颁发条件”处输入任何信息。)

  8. 确认“断言配置”中的“身份映射”已设为“瞬态”,“属性协议”已设为“uid”,且“适配器实例”已设为“1”。


     

    uid 属性应该映射到用户电子邮件地址。

4

选择“配置协议设置”。

  1. 对于“允许的 SAML 绑定”,仅勾选 POST 和“重定向”复选框。

  2. 对于“签名策略”,请选择“总是对 SAML 断言签名”。

    协议设置应类似以下示例。

  3. 选择“配置凭证”以配置断言的证书。

  4. 选择为 SAML 断言创建好的证书。

5

在“激活和摘要”屏幕上,将“连接状态”设置为“活动”。

导出 PingFederate 元数据

1

在主屏幕上单击“管理所有 SP”。

2

找到您刚才创建的连接,然后单击“导出元数据”。

3

从下拉列表中选择用于签署导出文件的证书。

4

单击导出

导入 IdP 元数据并在测试后启用单点登录

导出 Cisco Webex 元数据,配置 IdP,并将 IdP 元数据下载到本地系统后,您便准备就绪,可以从 Control Hub 将该元数据导入到 Cisco Webex 组织中。

开始之前

请勿从身份提供程序 (IdP) 界面测试 SSO 集成。 我们仅支持服务商启动(SP 启动)的流程,因此您必须将 Control Hub SSO 测试用于此集成。

1

选择一种:

  • 回到浏览器中的“Cisco Webex Control Hub - 导出目录元数据”页面,然后单击下一步
  • 如果 Control Hub 在浏览器标签页中不再是打开状态,请依次从 https://admin.webex.com 中的客户视图转至设置,滚动至验证,选择集成第三方身份提供程序(高级),然后在受信任元数据文件页面中单击下一步(因为您之前已完成)。
2

在“导入 IdP 元数据”页面中,将 IdP 元数据文件拖放到该页面,或使用文件浏览器选项来找到和上传该元数据文件。 单击下一步

如果元数据未签名、使用自签名证书签名或由私有企业证书颁发机构 (CA) 签名,我们建议您使用要求在元数据中使用由证书颁发机构签名的证书(安全级别较高)。 如果是自签名证书,您需要选择安全级别较低的选项。

3

选择测试 SSO 连接,当新的浏览器标签页打开时,登录并使用 IdP 进行验证。


 

如果您收到验证错误,可能是凭证有问题。 请检查用户名和密码并重试。

Webex Teams 错误往往意味着 SSO 设置有问题。 在此情况下,请再检查一遍操作步骤,特别是将 Control Hub 元数据复制粘贴到 IdP 设置中的步骤。

4

返回到 Control Hub 浏览器标签页。

  • 如果测试成功,选择“测试成功”。 启用“单点登录”选项并单击“下一步”。
  • 如果测试失败,选择“测试失败”。 禁用“单点登录”选项并单击“下一步”。

下一步做什么

您可以按照阻止自动电子邮件中的过程禁用发送给组织中新 Webex Teams 用户的电子邮件。 文档中还包含向组织中用户发送通信的最佳实践。