Updated on 2024-07-11 GMT+08:00

Step 1: Create an IdP Entity

To establish a trust relationship between an enterprise IdP and Huawei Cloud, upload the metadata file of Huawei Cloud to the enterprise IdP, and then create an IdP entity and upload the metadata file of the enterprise IdP on the IAM console.

Establishing a Trust Relationship Between the Enterprise IdP and Huawei Cloud

Configure the metadata file of Huawei Cloud on the enterprise IdP to establish a trust.

  1. Download the metadata file of Huawei Cloud.

    Visit https://auth-intl.huaweicloud.com/authui/saml/metadata.xml (Google Chrome is recommended). Download the Huawei Cloud metadata file and set the file name, for example, SP-metadata.xml.

  2. Upload the metadata file to the enterprise IdP server. For details, see the help documentation of the enterprise IdP.
  3. Obtain the metadata file of the enterprise IdP. For details, see the help documentation of the enterprise IdP.

Creating an IdP Entity on Huawei Cloud

To create an IdP entity on the IAM console, do as follows:

  1. Log in to the IAM console, choose Identity Providers from the navigation pane, and click Create Identity Provider in the upper right corner.

    Figure 1 Creating an IdP entity

  2. Specify the name, protocol, SSO type, status, and description of the IdP entity.

    Figure 2 Setting IdP parameters
    Table 1 Basic parameters of an IdP

    Parameter

    Description

    Name

    IdP name, which must be unique globally. You are advised to use the domain name.

    Protocol

    IdP protocol. Huawei Cloud supports SAML and OpenID Connect protocols. For details about OpenID Connect-based identity federation, see Virtual User SSO via OpenID Connect.

    SSO Type

    IdP type. An account can have only one type of IdP. The following describes the IAM user type.

    IAM user SSO: After a federated user logs in to Huawei Cloud, the system automatically maps the external identity ID to an IAM user so that the federated user has the permissions of the mapped IAM user. An account can have only one IdP of the IAM user type. If you select the IAM user SSO, ensure that you have created an IAM user and set the external identity ID. For details, see Creating an IAM User.

    Status

    IdP status. The default value is Enabled.

  3. Click OK.

Configuring the Metadata File of the Enterprise IdP on Huawei Cloud

You can upload the metadata file or manually edit metadata on the IAM console. For a metadata file larger than 500 KB, manually configure the metadata. If the metadata has been changed, upload the latest metadata file or edit the existing metadata to ensure that the federated users can log in to Huawei Cloud successfully.

For details about how to obtain the metadata file of an enterprise IdP, see the help documentation of the enterprise IdP.

  • Upload a metadata file.
    1. Click Modify in the row containing the IdP.
      Figure 3 Modifying an IdP
    2. Click Select File and select the metadata file of the enterprise IdP.
      Figure 4 Uploading a metadata file
    3. Click Upload. The metadata extracted from the uploaded file is displayed. Click OK.
      • If the uploaded metadata file contains multiple IdPs, select the IdP you want to use from the Entity ID drop-down list.
      • If a message is displayed indicating that no entity ID is specified or the signing certificate has expired, check the metadata file and upload it again, or configure the metadata manually.
    4. Click OK to save the settings.
  • Manually configure metadata.
    1. Click Manually configure.
      Figure 5 Manually configuring metadata
    2. In the Configure Metadata dialog box, set the metadata parameters, such as Entity ID, Signing Certificate, and SingleSignOnService.

      Parameter

      Mandatory

      Description

      Entity ID

      Yes

      The unique identifier of an IdP. Enter the value of entityID displayed in the enterprise IdP's metadata file.

      If the metadata file contains multiple IdPs, choose the one you want to use.

      Protocol

      Yes

      Protocol used for identity federation between an enterprise IdP and SP.

      The protocol is selected by default.

      NameIdFormat

      No

      Enter the value of NameIdFormat displayed in the IdP metadata file.

      It specifies the username identifier format supported by the IdP, which is used for communication between the IdP and federated user.

      If you configure multiple values, Huawei Cloud uses the first value by default.

      Signing Certificate

      Yes

      Enter the value of <X509Certificate> displayed in the IdP metadata file.

      A signing certificate is a public key certificate used for signature verification. For security purposes, enter a public key containing at least 2,048 bits. The signing certificate is used during identity federation to ensure that assertions are credible and complete.

      If you configure multiple values, Huawei Cloud uses the first value by default.

      SingleSignOnService

      Yes

      Enter the value of SingleSignOnService displayed in the IdP metadata file.

      This parameter defines how SAML requests are sent during SSO. It must support HTTP Redirect or HTTP POST.

      If you configure multiple values, Huawei Cloud uses the first value by default.

      SingleLogoutService

      No

      Enter the value of SingleLogoutService displayed in the IdP metadata file.

      This parameter indicates the address to which federated users will be redirected after logging out their sessions. It must support HTTP Redirect or HTTP POST.

      If you configure multiple values, Huawei Cloud uses the first value by default.

      The following example shows the metadata file of an enterprise IdP and the manually configured metadata.

      Figure 6 Metadata file of an enterprise IdP
      Figure 7 Manually configuring metadata
    3. Click OK to save the settings.