# 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[​](#requisitos-previos "Enlace directo a Requisitos previos") 1. Un [proveedor de OIDC](https://docs.equinix.com/es/iam/oidc/create-oidc-provider.md) . 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:` dónde `` se ha concedido una política de acceso único al principal. * `roleassignments:` ¿Dónde `` está el ID de organización en el que el principal OIDC tiene asignados [roles](https://docs.equinix.com/es/iam/oidc/oidc-for-roles.md). * `projectpolicies:` Dónde `` hay un ID de proyecto en el que se ha concedido al principal OIDC una [política de acceso](https://docs.equinix.com/es/iam/oidc/oidc-access-policies.md) o políticas de acceso. * `orgpolicies:` Dónde `` 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: roleassignments:` Dónde `` 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](https://docs.equinix.com/es/iam/oidc/overview.md#access-control-scopes) . ## Solicitar un token de acceso[​](#solicitar-un-token-de-acceso "Enlace directo a Solicitar un token de acceso") Para solicitar un token de acceso al portador, envíe una `POST` solicitud al [`/v1/token`](https://docs.equinix.com/es/api-catalog/stsv1/v1-pre-auth/generateststoken.md)punto 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](https://docs.equinix.com/es/iam/oidc/overview.md#access-control-scopes) . * `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=' \ --data-urlencode 'subject_token=' ``` ## Uso de tokens de acceso[​](#uso-de-tokens-de-acceso "Enlace directo a 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 `.