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/ Provedores de identidade/ Criação de um provedor de identidade

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

Ver PDF

Criação de um provedor de identidade

Função

Esta API é fornecida para o administrador criar um provedor de identidade. Depois de criar um provedor de identidade, registre um protocolo e modifique a configuração do provedor de identidade.

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

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

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

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
identity_provider	Sim	Object	Informações do provedor de identidade.

**Tabela 4** identity_provider
Parâmetro	Obrigatório	Tipo	Descrição
sso_type	Não	string	Tipo de provedor de identidade. Os dois tipos a seguir são suportados: virtual_user_sso: o usuário federado é mapeado para um usuário virtual depois que o logon é redirecionado. iam_user_sso: o usuário federado é mapeado para um usuário do IAM depois que o logon é redirecionado. Se você selecionar esse tipo, certifique-se de ter criado um usuário do IAM na Huawei Cloud. O valor padrão é virtual_user_sso.
description	Não	String	Descrição do provedor de identidade.
enabled	Não	Boolean	Status de ativação do provedor de identidade. true indica que o provedor de identidade está ativado. false indica que o provedor de identidade está desativado. O valor padrão é false.

Parâmetros de resposta

**Tabela 5** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
identity_provider	Object	Informações do provedor de identidade.

**Tabela 6** identity_provider
Parâmetro	Tipo	Descrição
sso_type	string	Tipo de provedor de identidade.
id	String	ID do provedor de identidade.
description	String	Descrição do provedor de identidade.
enabled	Boolean	Status de ativação do provedor de identidade. true indica que o provedor de identidade está ativado. false indica que o provedor de identidade está desativado. O valor padrão é false.
remote_ids	Array of strings	Lista de IDs de usuários federados configurados para o provedor de identidade.
links	Object	Link de recurso do provedor de identidade.

**Tabela 7** identity_provider.links
Parâmetro	Tipo	Descrição
self	String	Link de recurso do provedor de identidade.
protocols	String	Link de recurso de protocolo.

Exemplo de solicitação

Solicitação para criar um provedor de identidade e ativá-lo

PUT https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/{id}

{
    "identity_provider": {
        "description": "Stores ACME identities.",
        "enabled": true
    }
}

Exemplo de resposta

Código de status: 201

A solicitação foi bem-sucedida.

{
    "identity_provider": {
        "remote_ids": [],
        "enabled": true,
        "id": "ACME",
        "sso_type": "iam_user_sso",
        "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."
    }
}

Códigos de status

Código de status	Descrição
201	A solicitação foi bem-sucedida.
400	Parâmetros inválidos.
401	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
405	O método especificado na solicitação não é permitido para o recurso solicitado.
409	Ocorre um conflito de recursos.
413	A entidade de solicitação é muito grande.
500	A entidade de solicitação é muito grande.
503	Serviço indisponível.