Obtención de un token de usuario mediante autenticación de contraseña

Función

Esta API se utiliza para obtener un token de usuario utilizando el nombre de usuario y la contraseña. Un token es una credencial de acceso emitida a un usuario de IAM para llevar su identidad y permisos. Al llamar a las API de IAM u otros servicios en la nube, puede usar esta API para obtener un token de usuario para la autenticación.

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

Enlaces rápidos

Obtención de un token como usuario de IAM

Obtención de un token mediante una cuenta maestra

Obtención de un token con un ID de HUAWEI

Obtención de un token con una cuenta de Huawei Cloud

Obtención de un token como usuario del sistema de terceros

Período de validez de un token

Preguntas frecuentes sobre cómo obtener un token

Operaciones relacionadas

• Obtención de un token como usuario de IAM

  Consulte Parámetros de solicitud.

• Obtención de un token mediante una cuenta maestra

  Comprueba si tu cuenta se ha actualizado de Huawei Cloud a HUAWEI ID consultando ¿Cómo sé si he iniciado sesión con un HUAWEI ID o una cuenta de Huawei Cloud?

• Obtención de un token con un ID de HUAWEI

  No puede usar directamente un ID de HUAWEI para obtener un token. Debe crear un usuario de IAMasignar permisos a los usuarios y utilizar el usuario para obtener un token.

• Obtención de un token con una cuenta de Huawei Cloud

  Consulte Parámetros de solicitud.

• Obtención de un token como usuario del sistema de terceros

  Si usted es un usuario del sistema de un sistema de terceros, no puede obtener un token utilizando el nombre de usuario y la contraseña que utiliza para la autenticación de identidad federada. En su lugar, debe ir a la página de inicio de sesión de Huawei Cloud, haga clic en Forgot password haga clic en Reset HUAWEI CLOUD account password y establecer una contraseña.

• Período de validez de un token
  • El período de validez de un token es de 24 horas. Almacenar en caché el token para evitar llamadas frecuentes a la API. Asegúrese de que el token es válido mientras lo usa. El uso de un token que caducará pronto puede provocar fallos en las llamadas a la API. La obtención de un nuevo token no afecta a la validez del token existente.
  • El token no será válido si se produce alguna de las siguientes situaciones:
    • El usuario de IAM se elimina o deshabilita.
    • Se cambia la contraseña o la clave de acceso del usuario de IAM.
    • Se cambian los permisos del usuario de IAM . (debido a pagos pendientes, aprobación de la solicitud OBT o modificación del permiso).
  • Si The token must be updated se devuelve cuando se utiliza un token para llamar a una API de servicio en la nube, el token ha caducado. Necesita obtener un nuevo token.
• Preguntas frecuentes sobre cómo obtener un token

  Nombre de usuario o contraseña incorrectos: Compruebe si el nombre de usuario y la contraseña introducidos son correctos. Si el nombre de usuario y la contraseña son correctos pero el error persiste, compruebe si ha utilizado un ID de HUAWEI para obtener un token. Un ID de HUAWEI no se puede utilizar directamente para obtener un token. Es necesario crear un usuario de IAM, conceder permisos al usuario y utilizar el usuario para obtener un token.

  Sin permisos de acceso a la API: antes de llamar a una API, asegúrese de que ha habilitado el acceso programático habilitado para acceso programático.

• Operaciones relacionadas
  • Si se ha habilitado la protección de inicio de sesión y el método de verificación se ha establecido en un dispositivo MFA virtual, obtenga un token como usuario de IAM siguiendo las instrucciones proporcionadas en Obtención de un token de usuario mediante contraseña y autenticación MFA virtual.
  • Para obtener un token con permisos de Security Administrator, consulte Cómo obtengo un token con permisos de administrador de seguridad?
  • Para obtener detalles sobre cómo obtener un token usando Postman, consulte ¿Cómo obtengo un token de usuario usando Postman?

URI

POST /v3/auth/tokens

Parámetros de solicitud

Ejemplo de solicitud

• Solicitud de obtención de un token para el usuario IAMUser de IAM (contraseña: IAMPassword; nombre de cuenta: IAMDomain; alcance: interfaz de proyecto ap-southeast-1) sin mostrar información de catálogo en la respuesta

  POST https://iam.myhuaweicloud.com/v3/auth/tokens?nocatalog=true

  {
      "auth": {
          "identity": {
              "methods": [
                  "password"
              ],
              "password": {
                  "user": {
                      "domain": {
                          "name": "IAMDomain"        // Name of the account to which the IAM user belongs.
                      },
                      "name": "IAMUser",             // IAM user name.
                      "password": "IAMPassword"      // IAM user password.
                  }
              }
          },
          "scope": {
              "project": {
                  "name": "ap-southeast-1"               //Project name
              }
          }
      }
  }

• Solicitud de obtención de un token para el usuario de IAM IAMUser (contraseña: IAMPassword; nombre de cuenta: IAMDomain; ámbito: domain)

  POST https://iam.myhuaweicloud.com/v3/auth/tokens

  {
      "auth": {
          "identity": {
              "methods": [
                  "password"
              ],
              "password": {
                  "user": {
                      "domain": {
                          "name": "IAMDomain"        // Name of the account to which the IAM user belongs.
                      },
                      "name": "IAMUser",             // IAM user name.
                      "password": "IAMPassword"      // IAM user password.
                  }
              }
          },
          "scope": {
              "domain": {
                  "name": "IAMDomain"        // Name of the account to which the IAM user belongs.
              }
          }
      }
  }

Parámetros de respuesta

Ejemplo de respuesta

Código de estado: 201

La solicitud se ha realizado correctamente.

• Respuesta a la solicitud de obtención de un token para el usuario IAMUser (contraseña: IIAMPassword; nombre de cuenta: IAMDomain; alcance: interfaz de proyecto ap-southeast-1) sin mostrar información de catálogo en la respuesta

  Parameters in the response header (obtained token)
  X-Subject-Token:MIIatAYJKoZIhvcNAQcCoIIapTCCGqECAQExDTALB...

  Parameters in the response body
  {
      "token": {
          "catalog": [],
          "expires_at": "2020-01-04T09:05:22.701000Z",
          "issued_at": "2020-01-03T09:05:22.701000Z",
          "methods": [
              "password"
          ],
          "project": {
              "domain": {
                  "id": "d78cbac186b744899480f25bd022f...",
                  "name": "IAMDomain"
              },
              "id": "aa2d97d7e62c4b7da3ffdfc11551f...",
              "name": "ap-southeast-1"
          },
          "roles": [
              {
                  "id": "0",
                  "name": "te_admin"
              },
              {
                  "id": "0",
                  "name": "op_gated_OBS_file_protocol"
              },
              {
                  "id": "0",
                  "name": "op_gated_Video_Campus"
              }
          ],
          "user": {
              "domain": {
                  "id": "d78cbac186b744899480f25bd022f...",
                  "name": "IAMDomain"
              },
              "id": "7116d09f88fa41908676fdd4b039e...",
              "name": "IAMUser",
              "password_expires_at": ""
          }
      }
  }

• Respuesta a la solicitud de obtención de un token para el usuario IAMUser de IAM (contraseña: IAMPassword; nombre de cuenta: IAMDomain; ámbito: domain)

  Parameters in the response header (obtained token)
  X-Subject-Token:MIIatAYJKoZIhvcNAQcCoIIapTCCGqECAQExDTALB...

  Parameters in the response body
  {
      "token": {
          "catalog": [
              {
                  "endpoints": [
                      {
                          "id": "33e1cbdd86d34e89a63cf8ad16a5f...",
                          "interface": "public",
                          "region": "*",
                          "region_id": "*",
                          "url": "https://iam.myhuaweicloud.com/v3.0"
                      }
                  ],
                  "id": "100a6a3477f1495286579b819d399...",
                  "name": "iam",
                  "type": "iam"
              },
              {
                  "endpoints": [
                      {
                          "id": "29319cf2052d4e94bcf438b55d143...",
                          "interface": "public",
                          "region": "*",
                          "region_id": "*",
                          "url": "https://bss.sample.domain.com/v1.0"
                      }
                  ],
                  "id": "c6db69fabbd549908adcb861c7e47...",
                  "name": "bssv1",
                  "type": "bssv1"
              }
          ],
          "domain": {
              "id": "d78cbac186b744899480f25bd022f...",
              "name": "IAMDomain"
          },
          "expires_at": "2020-01-04T09:08:49.965000Z",
          "issued_at": "2020-01-03T09:08:49.965000Z",
          "methods": [
              "password"
          ],
          "roles": [
              {
                  "id": "0",
                  "name": "te_admin"
              },
              {
                  "id": "0",
                  "name": "secu_admin"
              },
              {
                  "id": "0",
                  "name": "te_agency"
              }
          ],
          "user": {
              "domain": {
                  "id": "d78cbac186b744899480f25bd022f...",
                  "name": "IAMDomain"
              },
              "id": "7116d09f88fa41908676fdd4b039e...",
              "name": "IAMUser",
              "password_expires_at": ""
          }
      }
  }

Código de estado: 400

Parámetros no válidos.

{
    "error": {
        "code": 400,
        "message": "The request body is invalid",
        "title": "Bad Request"
    }
}

Código de estado: 401

Error de autenticación.

• Si es usuario de un sistema de terceros, no puede obtener un token utilizando el nombre de usuario y la contraseña que utiliza para la autenticación de identidad federada. Vaya a la página de inicio de sesión de Huawei Cloud, haga clic en Forgot password, haga clic en Reset Huawei Cloud account password y establezca una nueva contraseña.
• Si su cuenta de Huawei Cloud se ha actualizado a un ID de HUAWEI, no puede obtener un token con el ID de HUAWEI. En su lugar, puede crear un usuario de IAM, conceder al usuario los permisos necesarios y obtener un token como usuario.

{
    "error": {
        "code": 401,
        "message": "The username or password is wrong.",
        "title": "Unauthorized"
    }
}

Códigos de estado

Códigos de error

Ninguno