Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Identity and Access Management/ Referência de API/ Primeiros passos/ Autenticação federada para contas empresariais
Atualizado em 2024-08-31 GMT+08:00

Autenticação federada para contas empresariais

Cenário

Empresas com várias contas na nuvem pública podem acessar os recursos sob essas contas por meio de seu próprio sistema de IdP. Para atingir esse objetivo, elas podem chamar APIs para configurar a autenticação de identidade federada.

Esta seção descreve como implementar a autenticação automática federada chamando APIs.

Pré-requisitos

Somente administradores podem executar as operações de registro e importação descritas nesta seção. Certifique-se de que a função Security Administrator tenha sido atribuída a você.

Procedimento geral

Execute as etapas a seguir para configurar a autenticação de identidade federada para várias contas na nuvem:

  1. Registre um provedor de identidade.
  2. Registre um mapeamento.
  3. Registre um protocolo.
  4. Importe um arquivo de metadados.
  5. Efetue logon como um usuário federado.

As seguintes APIs serão usadas neste exemplo:

Etapa 1: registrar um provedor de identidade

URI: PUT /v3/OS-FEDERATION/identity_providers/{id}

Para obter detalhes sobre a API, consulte Criação de um provedor de identidade.

  • Exemplo de solicitação
    PUT https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/{id}

    {
         "identity_provider":{
             "description":"Stores ACME identities.",
             "enabled":true
         }
     }
  • Exemplo de resposta
    {
        "identity_provider": {
            "remote_ids": [],
            "enabled": true,
            "id": "ACME",
            "links": {
                "self": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME",
                "protocols": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME/protocols"
            },
            "description": "Stores ACME identities."
        }
    }

Etapa 2: registrar um mapeamento

URI: PUT /v3/OS-FEDERATION/mappings/{id}

Para obter detalhes sobre a API, consulte Registro de um mapeamento.

  • Exemplo de solicitação
    PUT https://iam.myhuaweicloud.com/v3/OS-FEDERATION/mappings/{id}
    {
         "mapping":{
             "rules":[
                 {
                     "local":[
                         {
                             "user":{
                                 "name":"LocalUser"
                             }
                         },
                         {
                             "group":{
                                 "name":"LocalGroup"
                             }
                         }
                     ],
                     "remote":[
                         {
                             "type":"UserName"
                         },
                         {
                             "not_any_of":[
                                 "Contractor",
                                 "Guest"
                             ],
                             "type":"orgPersonType"
                         }
                     ]
                 }
             ]
         }
     }
  • Exemplo de resposta
    {
         "mapping":{
             "id":"ACME",
             "links":{
                 "self":"https://iam.myhuaweicloud.com/v3/OS-FEDERATION/mappings/ACME"
             },
             "rules":[
                 {
                     "local":[
                         {
                             "user":{
                                 "name":"LocalUser"
                             }
                         },
                         {
                             "group":{
                                 "name":"LocalGroup"
                             }
                         }
                     ],
                     "remote":[
                         {
                             "type":"UserName"
                         },
                         {
                             "not_any_of":[
                                 "Contractor",
                                 "Guest"
                             ],
                             "type":"orgPersonType"
                         }
                     ]
                 }
             ]
         }
     }

Etapa 3: registrar um protocolo

URI: PUT /v3/OS-FEDERATION/identity_providers/{idp_id}/protocols/{protocol_id}

Para obter detalhes sobre a API, consulte Registro de um protocolo.

  • Exemplo de solicitação
    PUT https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/{idp_id}/protocols/{protocol_id}
    {
         "protocol":{
             "mapping_id":"ACME"
         }
     }
  • Exemplo de resposta
    {
         "protocol":{
             "id":"saml",
             "links":{
                 "identity_provider":"https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME",
                 "self":"https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME/protocols/saml"
             },
             "mapping_id":"ACME"
         }
     }

Etapa 4: importar um arquivo de metadados

URI: POST /v3-ext/OS-FEDERATION/identity_providers/{idp_id}/protocols/{protocol_id}/metadata

Para obter detalhes sobre a API, consulte Importação de um arquivo de metadados.

  • Exemplo de solicitação
    POST https://iam.myhuaweicloud.com/v3-ext/OS-FEDERATION/identity_providers/{idp_id}/protocols/{protocol_id}/metadata
    {
         "domain_id":"d78cbac186b744899480f25bd022....",
         "metadata":"$metadataContent",
         "xaccount_type":""
     }
  • Exemplo de resposta
    {
         "message":"Import metadata successful"
     }

Etapa 5: efetuar logon como um usuário federado

Configure a autenticação federada. Para obter detalhes, consulte Provedores de identidade.