使用 PingFederate 的 Cisco Spark 单点登录

Document created by Cisco Localization Team on Feb 4, 2017
Version 1Show Document
  • View in full screen mode
 

单点登录和 Cisco Spark 概述

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

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

 

SAML 2.0 是一个用于在跨域合作伙伴之间安全地处理用户验证、共享用户属性及用户授权的行业协议。

 

有关 SSO 功能的更多信息,请参阅本文。

档案

SAML 2.0 协议支持多种档案,Spark 平台只支持 Web 浏览器 SSO 档案。 在 Web 浏览器 SSO 档案中,Spark 平台支持下列绑定:

 
  • SP 发起的 POST->POST 绑定 


     

  • SP 发起的 REDIRECT->POST 绑定

      


 
      

NameID 格式

为了传达特定用户的信息,SAML 2.0 协议支持多种 NameID 格式。 Cisco Collaboration Cloud 平台支持下列 NameID 格式。

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

在您从 IdP 加载的元数据中,第一个条目是为 Spark 平台应用而配置的。

单点注销

Cisco Collaboration Cloud 支持单点注销档案。 当用户在 Cisco Spark 或 WebEx 应用程序中注销时,系统会使用 SAML 单点注销协议来结束会话并与您的 IdP 确认该注销操作。

集成 Cisco Spark 与 PingFederate 以实现单点登录

执行本文中的任务,以配置 Cisco Spark 服务与使用 PingFederate 作为身份提供程序 (IdP) 的部署之间的单点登录 (SSO) 集成。

    

此集成涵盖了 Cisco Spark 的消息、会议和电话服务的用户。 要启用 Cisco WebEx 的 SSO,则需要进行单独集成。

准备工作 
对于单点登录和 Cisco Spark 服务,IdP 必须遵循 SAML 2.0 规范。 此外,IdP 必须按以下方式进行配置:
  • 将 IdP 配置为使用“基于表单”的验证。

     

  • 将“NameID 格式”属性设为“urn:oasis:names:tc:SAML:2.0:nameid-format:transient”,我们也支持“unspecified”。

     

  • 配置 IdP 声明,以在 SAML 断言中包含以下属性:

     

    • 值映射到用户电子邮件地址的“uid”属性名称。

       

     
     
  

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

        
1    使用完整的管理员凭证登录 Cisco Cloud Collaboration Management
2    选择“设置”,然后选择“验证”部分中的“修改”。
3    选择“集成第三方身份提供程序”。 (高级)并转到下一屏幕。
4    下载可信的元数据文件并将其保存到本地系统上易于查找的位置。  

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

  
5    使 Cisco Cloud Collaboration Management 会话在浏览器标签页中保持打开状态;稍后您需要返回到此会话并上传您的 IdP 元数据。

配置新的服务商连接

  
          
1    转到 PingFederate 管理门户 (https://<PingFederate 的 FQDN>:9999/pingfederate/app)。
2    在“SP 连接”下方选择“新建”。
3    选择“不使用此连接的模板”单选按钮,然后选择“下一步”。
4    选档“浏览 SSO 档案”,然后单击“下一步”。
5    选择“导入元数据”标签页。
6    单击“选择文件”,找到并导入您从 Cisco Cloud Collaboration Management 下载的元数据文件,然后单击“下一步”。
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. 选择“使用一个映射从多个数据存储库检索更多属性”单选按钮,然后单击“下一步”。
  6. 选择“添加属性源”以添加域的 Active Directory 域控制器,然后单击“下一步”。
  7. 指定“基本 DN”并选择根对象类 <显示所有属性>
  8. 在“过滤器”文本框中,输入 LDAP 过滤器,然后单击“下一步”。  

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

      
  9. 选择源和值,以将断言属性映射到 AD 数据存储库所提供的属性。 (不要在“颁发条件”处输入任何信息。)
  10. 确认“断言配置”中的“身份映射”已设为“瞬态”,“属性协议”已设为“mail, uid”,且“适配器实例”已设为“1”。
4    选择“配置协议设置”。
  1. 对于“允许的 SAML 绑定”,仅勾选 POST 和“重定向”复选框。
  2. 对于“签名策略”,请选择“总是对 SAML 断言签名”。

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

  3. 选择“配置凭证”以配置断言的证书。
  4. 选择为 SAML 断言创建好的证书。
5    在“激活和摘要”屏幕上,将“连接状态”设置为“活动”。

导出 PingFederate 元数据

       
1    在主屏幕上单击“管理所有 SP”。
2    找到您刚才创建的连接,然后单击“导出元数据”。
3    从下拉列表中选择用于签署导出文件的证书。
4    单击导出

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

 

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

  
        
1    返回到您登录到 Cloud Collaboration Management 的“导出目录元数据”页面的浏览器或标签页,然后单击“下一步”。
2    在“导入 IdP 元数据”页面中,将 IdP 元数据文件拖放到该页面,或使用文件浏览器选项来找到和上传该元数据文件。

对于使用公开签署的受信任证书的服务商,我们建议您勾选“要求在元数据中提供由认证中心签署的证书(更安全)”。

3    单击“下一步”。
4    选择“测试 SSO 连接”,当打开新的浏览器标签页时,登录并使用 IdP 进行验证。

验证出错的一个常见原因是凭证有问题。 请检查用户名和密码,然后重试。

Cisco Spark 或 Webex 出错往往是因为 SSO 设置有问题。 在此情况下,请再检查一遍操作步骤,特别是将 Cisco Spark 元数据复制粘贴到 IdP 设置中的步骤。

5    返回到 Cisco Cloud Collaboration Management 浏览器标签页。
  • 如果测试成功,选择“测试成功”。 启用“单点登录”选项并单击“下一步”。
  • 如果测试失败,选择“测试失败”。 禁用“单点登录”选项并单击“下一步”。
 

Attachments

    Outcomes