# 创建身份提供商
配置联邦身份认证，需要在企业IdP上传华为云的元数据文件（Metadata文件），并在IAM控制台上创建身份提供商、上传企业IdP的元数据文件，来建立两个系统之间的互信关系。
#### 前提条件
企业管理员已获取企业IdP的帮助文档或了解企业IdP使用方法。由于不同的企业IdP的配置存在较大差异，华为云帮助文档对于企业IdP的配置不做详述，获取企业IdP的元数据文件、华为云元数据上传至企业IdP等具体操作请参考企业IdP的帮助文档。
#### 建立企业IdP对华为云的信任关系
在企业IdP中配置华为云的元数据文件，以建立企业IdP对华为云的信任。常用企业IdP，如Microsoft Active Directory（AD FS）和Shibboleth的配置步骤，请参见：[与华为云集成第三方IdP解决方案提供商示例](https://support.huaweicloud.com/usermanual-iam/iam_08_0252.html#iam_08_0252__zh-cn_topic_0175818705_section620453919417)。
1. 下载华为云系统的元数据文件（metadata文件）。 
   访问网址：<https://auth.huaweicloud.com/authui/saml/metadata.xml>。下载华为云元数据文件，并设置文件名称，例如"SP-metadata.xml"。
   
   
2. 将上述文件上传到企业IdP服务器上。上传方法请参见企业IdP的帮助文档。
3. 获取企业IdP的元数据文件。获取方法请参见企业IdP的帮助文档。
 
#### 在华为云上创建身份提供商
在IAM控制台上创建身份提供商，配置身份提供商的元数据文件后，可以在IAM中建立对企业IdP的信任关系，使得企业用户可以直接访问华为云。
1. 进入[IAM控制台](https://console.huaweicloud.com/iam/?locale=zh-cn#/iam/users)，在左侧导航窗格中，选择"身份提供商"页签，单击右上方的"创建身份提供商"。
   
   图1创建身份提供商   
   ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000001948892777.png "点击放大")
   
   
2. 在"创建身份提供商"窗口中设置名称、协议、类型、状态、描述。 
   图2填写身份提供商参数   
   ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000001948895221.png "点击放大")
   表1身份提供商基本参数 
   | 参数     | 含义                                                                                                                                                   |
   |:---|:---|
   | **名称** | 身份提供商的名称。身份提供商名称在全局范围内不能重复，建议以域名唯一标识命名。                                                                                                              |
   | **协议** | 身份提供商协议。当前华为云支持基于SAML、OIDC的身份提供商，如需创建基于OIDC协议的联邦身份认证，请参考[基于OIDC协议的虚拟用户SSO](https://support.huaweicloud.com/usermanual-iam/iam_08_0022.html)。         |
   | **类型** | 身份提供商类型。一个账号下只能存在一种类型的身份提供商。本章介绍虚拟用户SSO，此处选择虚拟用户SSO。 虚拟用户SSO：该身份提供商中的用户登录华为云后，系统为其自动创建虚拟用户信息。一个账号可以创建多个虚拟用户SSO类型的身份提供商。 |
   | **状态** | 身份提供商的状态。默认设置为"启用"。                                                                                                                                  |
      
   
   
3. 单击"确定"，创建身份提供商成功。
 
#### 在华为云上配置元数据文件
配置元数据文件，即把企业IdP的Metadata文件配置到华为云。IAM支持"上传文件"和"手动编辑"两种配置，选择其中一种即可。如果元数据文件超过500KB，请通过"手动编辑"配置元数据。如果后续元数据有更新，需要用户重新上传或者编辑元数据，否则会影响联邦用户登录华为云。
![](https://support.huaweicloud.com/usermanual-iam/public_sys-resources/note_3.0-zh-cn.png)
企业IdP的Metadata文件获取方法请参考企业IdP提供商的帮助文档。
- **上传元数据** ：
  1. 单击身份提供商列表中"操作"列的"修改"。
     图3修改身份提供商   
     ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000001948904497.png "点击放大") 
  
  2. 单击"上传文件"左侧的"添加文件"，选择获取的企业IdP的元数据文件。
     图4上传元数据文件   
     ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000002546935737.png "点击放大") 
  
  3. 单击"上传文件"。弹出页面显示系统提取到的元数据，单击"确定"。
     - 提示"系统发现您上传的文件中包含多个身份提供商，请选择您本次需要使用的身份提供商"，请在"Entity ID"下拉框中选择您本次需要使用的身份提供商。
     
     - 提示元数据文件中Entity ID为空、签名证书过期等内容时，需要您确认元数据文件的正确性后，重新上传或者通过手动编辑提取元数据。
      
  
  4. 单击"确定"，保存设置信息。
   

- **手动编辑元数据**
  1. 单击"手动编辑"。
     图5手动编辑元数据   
     ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000002515295882.png "点击放大") 
  
  2. 在"手动编辑元数据"页面中，输入从企业IdP元数据文件中获取的"Entity ID"、"签名证书"和"SingleSignOnService"等参数。
     
     | 参数                      | 是否必选 | 含义                                                                                                                                                                                                                 |
     |:---|:---|:---|
     | **Entity ID**           | 是    | 对应IdP元数据文件中"entityID"的值。 企业身份提供商的唯一标识，元数据文件中可能包含多个身份提供商，需要选择对应的身份提供商。                                                                                                                  |
     | **支持的协议**               | 是    | 企业IdP与服务提供商之间，通过SAML协议完成联邦身份认证。 **不需要手动选择，系统自动生成。**                                                                                                                                    |
     | **支持的NameIdFormat**     | 否    | 对应IdP元数据文件中"NameIdFormat"的值。 身份提供商支持的用户名称标识格式。名称标识是身份提供商与联邦用户之间实现通信的一种方式。 **支持配置多个，华为云默认使用第一个。**                                                       |
     | **签名证书**                | 是    | 对应IdP元数据文件中"\<X509Certificate\>" 的值。 签名证书是一份包含公钥用于验证签名的证书，为了确保安全性，建议使用长度大于等于2048位的公钥。IAM通过元数据文件中的签名证书来确认联邦身份认证过程中断言消息的可信性、完整性。 **支持配置多个，华为云默认使用第一个。** |
     | **SingleSignOnService** | 是    | 对应IdP元数据文件中"SingleSignOnService" 的值。 单点登录过程中发送SAML请求的方式。元数据文件中的"SingleSignOnService"需要支持HTTP Redirect或HTTP POST方式。 **支持配置多个，华为云默认使用第一个。**               |
     | **SingleLogoutService** | 否    | 对应IdP元数据文件中"SingleLogoutService" 的值。 服务提供商提供会话注销功能，联邦用户在IAM注销会话后返回绑定的地址。"SingleLogoutService" 需要支持HTTP Redirect或HTTP POST方式。 **支持配置多个，华为云默认使用第一个。**         |
        
     示例：以下为某企业IdP的元数据文件和手动编辑元数据信息时需要填入的内容。
     图6某企业IdP的元数据文件   
     ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000001920026654.png "点击放大")
     图7根据企业IdP元数据文件手动编辑元数据   
     ![](https://support.huaweicloud.com/usermanual-iam/zh-cn_image_0000001949026945.png "点击放大") 
  
  3. 单击"确定"，保存设置信息。
   
 
#### 相关操作
- 查看身份提供商信息：在身份提供商列表中，单击"查看"，可查看身份提供商的基本信息、元数据详情、身份转换规则。
  ![](https://support.huaweicloud.com/usermanual-iam/public_sys-resources/note_3.0-zh-cn.png)
  单击"查看身份提供商"页面下方的"修改身份提供商"，可直接进入"修改身份提供商"界面。
  
- 修改身份提供商信息：在身份提供商列表中，单击"修改"进入"修改身份提供商"界面。可修改身份提供商的状态（"启用"或"停用"）、描述信息、元数据信息和身份转换规则。
- 删除身份提供商：在身份提供商列表中，单击"删除"，删除对应的身份提供商。
 
#### 后续任务
- **配置企业IdP：**在企业IdP系统中配置单点登录相关参数，决定向华为云提供哪些用户信息。
- **配置身份转换规则：** 在"身份转换规则"区域，配置身份转换规则，建立企业管理系统用户与IAM用户组间的映射关系，使得企业管理系统用户登录华为云后，获得对应的华为云操作权限。身份转换规则详情请参见：[配置身份转换规则](https://support.huaweicloud.com/usermanual-iam/iam_08_0004.html)。
- **登录验证：** 在企业管理系统中配置单点登录，使企业用户可以通过企业管理系统中的华为云登录入口直接访问华为云，方法请参考：[登录验证](https://support.huaweicloud.com/usermanual-iam/iam_08_0025.html)。