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
-
Un proveedor de OIDC .
-
Un token de identificación de OIDC de su proveedor de OIDC registrado.
-
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- Utiliceurn:ietf:params:oauth:grant-type:token-exchangepara 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- Usourn:ietf:params:oauth:token-type:id_tokenque identifica susubject_tokencomo 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>.