Saltar al contenido principal

Autenticación API OIDC

Las API de Equinix utilizan el protocolo OAuth 2,0 para autenticar las solicitudes de su usuario de OIDC en los puntos finales de API. Para interactuar con las API de Equinix, necesita un token de acceso al portador.

Requisitos previos​

  1. Un proveedor de OIDC .

  2. Un token de identificación de OIDC de su proveedor de OIDC registrado.

  3. Permisos específicos de producto o servicio para especificar el alcance del token de acceso al API. Necesita:

    • ern:<access-policy-ern> dónde <access-policy-ern> se ha concedido una política de acceso único al principal.
    • roleassignments:<org-id> ¿Dónde <org-id> está el ID de organización en el que el principal OIDC tiene asignados roles.
    • projectpolicies:<project-id> Dónde <project-id> hay un ID de proyecto en el que se ha concedido al principal OIDC una política de acceso o políticas de acceso.
    • orgpolicies:<org-id> Dónde <org-id> es un ID de organización en el que se ha concedido al principal una política de acceso o políticas de acceso.
    • orgpolicies:<org-id> roleassignments:<org-id> Dónde <org-id> es un ID de organización en el que se han concedido al principal roles y políticas de acceso.

    Para obtener más información, consulte Alcance del control de acceso .

Solicitar un token de acceso​

Para solicitar un token de acceso al portador, envíe una POST solicitud al /v1/tokenpunto final.

En el cuerpo de la solicitud especifique:

  • grant_type - Utilice urn:ietf:params:oauth:grant-type:token-exchange para recibir un token de acceso.
  • scope (Obligatorio) - Proporcione el alcance. Los permisos concedidos por el token se verifican si se han concedido al principal los roles o las políticas de acceso apropiados. Para obtener más información, consulte Alcance del control de acceso .
  • subject_token - El token de ID de OIDC.
  • subject_token_type - Uso urn:ietf:params:oauth:token-type:id_token que identifica su subject_token como un token de ID de OIDC.

Ejemplo de solicitud cURL:

curl -X POST 'https://sts.eqix.equinix.com/v1/token' \
--data-urlencode 'grant_type=urn:ietf:params:oauth:grant-type:token-exchange' \
--data-urlencode 'subject_token_type=urn:ietf:params:oauth:token-type:id_token' \
--data-urlencode 'scope=<role_or_access_policy>' \
--data-urlencode 'subject_token=<oidc_id_token>'

Uso de tokens de acceso​

Para interactuar con Equinix API, envíe su token de acceso al encabezado de autorización de la solicitud HTTP con Authorization: Bearer <token>.

¿Le ha resultado útil esta página?