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
Compartilhar

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.

Códigos de erro

Nenhum

Tópico principal:Provedores de identidade