# Autenticación de usuarios API

Las API de Equinix utilizan el protocolo OAuth 2.0 para autenticar las solicitudes que realiza a los puntos finales de las API. Para interactuar con las API de Equinix, necesita un token de acceso de portador. El portador determina el tipo de esquema de autenticación y forma parte del protocolo OAuth 2.0.

<!-- -->

información

La API Equinix Metal no utiliza el flujo de autenticación descrito aquí. Las claves de la API Metal se gestionan a través de la [consola Metal](/es/metal/identity-access-management/api-keys.md), y su autenticación está documentada en la [Referencia de la API](https://docs.equinix.com/api-catalog/metalv1/#tag/Authentication).

## Requisitos previos[​](#requisitos-previos "Direct link to Requisitos previos")

Interactuar con los productos de Equinix a través de API requiere:

* Una cuenta de Equinix Customer Portal.
* Permisos de creación, modificación y eliminación específicos para cada producto. Póngase en contacto con el administrador principal de su organización y solicite los permisos de acceso.

## Generar ID de cliente y secreto de cliente[​](#generar-id-de-cliente-y-secreto-de-cliente "Direct link to Generar ID de cliente y secreto de cliente")

Un ID de cliente y un Secreto de cliente son necesarios para obtener tokens que autoricen sus solicitudes API. Para generar un ID de cliente y un secreto de cliente, registre su aplicación en la sección *Configuración del desarrollador* del Portal del cliente.

Para registrar una aplicación:

1. Acceda al [Customer Portal](https://portal.equinix.com).

2. En el menú de navegación global, seleccione *Configuración del desarrollador* > *Aplicaciones* para ver los detalles de la aplicación.

   ![](/es/assets/images/auth-dev-menu-a9161ccf9e632050f83ddb969f6d16f2.png)

3. Acuerdo de licencia API - Antes de utilizar la plataforma y las API por primera vez, debe leer y aceptar el acuerdo de licencia API que se muestra.

   ![](/es/assets/images/auth-license-agreement-b3b3306c8dbdc8fa214d34ce7f9874ce.png)

   Una vez que haya aceptado el acuerdo, podrá encontrarlo en la sección *Información adicional*.

   ![](/es/assets/images/auth-additional-info-86c6708fc3c7eb40798e8efd48715ce2.png)

4. Haga clic en **Crear nueva aplicación**.

   ![](/es/assets/images/auth-create_new_app-353d89258181768204be10e122cb9c51.png)

5. Proporcione un *nombre de aplicación*, seleccione *tipo de entorno de aplicación* (Producción) y haga clic en **Crear**.

   ![](/es/assets/images/auth-create_new_app_details-c3850c198a7b8fa6bcba9a3debfaf5c1.png)

6. Haga clic en el mosaico de su aplicación para abrir sus detalles.

7. Haga clic en el icono del ojo para ver su *Clave de Consumidor* y su *Secreto de Consumidor*.

   ![](/es/assets/images/auth-app-details-pane-cd47a19c79e99ab157f7b4cd7addbf48.png)

## Solicitar un token de acceso[​](#solicitar-un-token-de-acceso "Direct link to Solicitar un token de acceso")

Se necesita un token de acceso para autorizar sus solicitudes de API. Para solicitar un token, envíe una solicitud `POST` al punto final [`/oauth2/v1/token`](/es/api-catalog/accesstokenv1#operation/GetOAuth2AccessToken), especificando su ID de cliente y su secreto de cliente en el cuerpo de la solicitud.

Ejemplo de solicitud cURL:

```
curl -X  

POST 'https://api.equinix.com/oauth2/v1/token'  

-H 'content-type: application/json'  

-d '{  

    "grant_type": "client_credentials",  

    "client_id": "<client_id>",  

    "client_secret": "<client_secret>"  

}'
```

Para obtener una lista completa de los parámetros y opciones disponibles, consulte la [Referencia API](/es/api-catalog/accesstokenv1#operation/GetOAuth2AccessToken).

Respuesta de muestra:

```
{  

    "access_token": "<token>",  

    "token_timeout": "3600",  

    "user_name": "john.doe@example.com",  

    "token_type": "Bearer"  

}
```

## Actualizar un token[​](#actualizar-un-token "Direct link to Actualizar un token")

Puede actualizar su token de acceso enviando una solicitud `POST` al punto final [`/oauth2/v1/refreshaccesstoken`](/es/api-catalog/accesstokenv1#operation/RefreshOAuth2AccessToken).

Ejemplo de solicitud curl:

```
curl -X  

POST 'https://api.equinix.com/oauth2/v1/refreshaccesstoken'  

-H 'content-type: application/json'  

-d '{  

    "client_id": "<client_id>",  

    "client_secret": "<client_secret>",  

    "refresh_token": "<token>  

}'‌‌
```

Para obtener una lista completa de los parámetros y opciones disponibles, consulte la [Referencia API](/es/api-catalog/accesstokenv1#operation/RefreshOAuth2AccessToken)

## Uso de tokens de acceso[​](#uso-de-tokens-de-acceso "Direct link to Uso de tokens de acceso")

To interact with Equinix API, send your access token in the Authorization header of the HTTP request with `authorization: Bearer <token>`

Ejemplo de solicitud cURL: un envío entrante desde la API de Colocation:

```
curl -X  

POST "https://api.equinix.com/colocations/v2/orders/shipments"  

-H "content-type: application/json"  

-H "authorization: Bearer <token>"  

-d '{  

    "type": "INBOUND",  

    "requestedDateTime": "2020-11-02T10:45:41Z",  

    "cageId": "AM1:01:000111",  

    "details": {  

    "carrier": "CUSTOMER_CARRIER",  

    "numberOfBoxes": 2  

    }  

}'‌
```