Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Identity and Access Management/ Referencia de la API/ API/ Gestión de autenticación de identidades federadas/ Proveedores de identidades/ Creación de un proveedor de identidad
Actualización más reciente 2024-08-01 GMT+08:00
Ver PDF
Compartir

Creación de un proveedor de identidad

Función

Esta API se proporciona para que el administrador cree un proveedor de identidad. Después de crear un proveedor de identidad, registre un protocolo y modifique la configuración del proveedor de identidad.

Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.

URI

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

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

Nombre del proveedor de identidad.

Parámetros de solicitud

Tabla 2 Parámetros en el encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

Content-Type

Sí

String

Rellene application/json;charset=utf8 en este campo.

X-Auth-Token

Sí

String

Token de acceso emitido a un usuario para acreditar su identidad y sus permisos.

Para obtener más información sobre los permisos requeridos por el token, consulte Acciones.
Tabla 3 Parámetros en el cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

identity_provider

Sí

Object

Información del proveedor de identidad.
Tabla 4 identity_provider

Parámetro

Obligatorio

Tipo

Descripción

sso_type

No

string

Tipo de proveedor de identidad. Se admiten los dos tipos siguientes:

  • virtual_user_sso: El usuario federado se asigna a un usuario virtual después de redirigir el inicio de sesión.
  • iam_user_sso: El usuario federado se asigna a un usuario IAM después de redirigir el inicio de sesión. Si seleccionas este tipo, asegúrate de haber creado un usuario IAM en Huawei Cloud.

El valor predeterminado es virtual_user_sso.

description

No

String

Descripción del proveedor de identidad.

enabled

No

Boolean

Habilitación del estado del proveedor de identidad. true indica que el proveedor de identidad está habilitado. false indica que el proveedor de identidad está deshabilitado. El valor predeterminado es false.

Parámetros de respuesta

Tabla 5 Parámetros en el cuerpo de respuesta

Parámetro

Tipo

Descripción

identity_provider

Object

Información del proveedor de identidad.
Tabla 6 identity_provider

Parámetro

Tipo

Descripción

sso_type

string

Tipo de proveedor de identidad.

id

String

ID de proveedor de identidad.

description

String

Descripción del proveedor de identidad.

enabled

Boolean

Habilitación del estado del proveedor de identidad. true indica que el proveedor de identidad está habilitado. false indica que el proveedor de identidad está deshabilitado. El valor predeterminado es false.

remote_ids

Array of strings

Lista de ID de usuario federados configurados para el proveedor de identidades.

links

Object

Enlace de recurso del proveedor de identidad.
Tabla 7 identity_provider.links

Parámetro

Tipo

Descripción

self

String

Enlace de recurso del proveedor de identidad.

protocols

String

Enlace de recurso de protocolo.

Ejemplo de solicitud

Solicitud de creación de un proveedor de identidad y habilitarlo

PUT https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/{id}
{
    "identity_provider": {
        "description": "Stores ACME identities.",
        "enabled": true
    }
}

Ejemplo de respuesta

Código de estado: 201

La solicitud se ha realizado correctamente.

{
    "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 estado

Código de estado

Descripción

201

La solicitud se ha realizado correctamente.

400

Parámetros no válidos.

401

Error de autenticación.

403

Acceso denegado.

404

No se puede encontrar el recurso solicitado.

405

El método especificado en la solicitud no está permitido para el recurso solicitado.

409

Se produce un conflicto de recursos.

413

La entidad solicitada es demasiado grande.

500

La entidad solicitada es demasiado grande.

503

Servicio no disponible.

Códigos de error

Ninguno

Tema principal: Proveedores de identidades