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/ API/ Gerenciamento de autenticação de identidade federada/ Metadados/ Importação de um arquivo de metadados

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Importação de um arquivo de metadados

Função

Essa API é fornecida para que o administrador importe um arquivo de metadados.

Essa API é usada para importar um arquivo de metadados para o IAM para implementar a autenticação de identidade federada. O arquivo de metadados especifica endereços de API e informações de certificado em conformidade com o SAML 2.0 padrão. Para obter o arquivo de metadados do seu IdP empresarial, entre em contato com o administrador empresarial.

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

URI

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

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
idp_id	Sim	String	Nome do provedor de identidade.
protocol_id	Sim	String	ID do protocolo.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 nesse campo.
X-Auth-Token	Sim	String	Token de acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

**Tabela 3** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
domain_id	Sim	String	ID da conta.
xaccount_type	Sim	String	Fonte da conta. Este parâmetro é deixado em branco por padrão.
metadata	Sim	String	Metadados do servidor IdP.

Parâmetros de resposta

**Tabela 4** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
message	String	Resultado da importação.

Exemplo de solicitação

Solicitação para importar um arquivo de metadados

POST https://iam.myhuaweicloud.com/v3-ext/OS-FEDERATION/identity_providers/{idp_id}/protocols/{protocol_id}/metadata

{
    "xaccount_type": "",
    "domain_id": "d78cbac186b744899480f25bd...",
    "metadata": "<md:EntityDescript..."
}

Exemplo de resposta

Código de status: 201

O arquivo de metadados foi importado com sucesso.

{
    "message": "Import metadata successful"
}

Códigos de status

Código de status	Descrição
201	O arquivo de metadados foi importado com sucesso.
400	Parâmetros inválidos.
401	Falha na autenticação.
403	Acesso negado.
500	Erro de servidor interno.