> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación de máquina a máquina

> Resumen del acceso máquina a máquina (M2M) a la API de Credit Benchmark mediante pares de claves ES256 y autenticación de cliente JWT con clave privada OAuth 2.0.

La API de Credit Benchmark utiliza autenticación de máquina a máquina (M2M). Registramos máquinas, no personas. Una máquina puede ser un servidor en su centro de datos o en la nube, o el ordenador portátil de alguien. Cada una de ellas obtiene su propia identidad con nosotros, y nadie necesita introducir un nombre de usuario ni una contraseña para que se conecte.

Dicha identidad es un par de claves digitales que usted genera en el equipo:

* La **clave privada** permanece en el equipo y demuestra que es este el que realiza las solicitudes.
* La **clave pública** es la mitad que le corresponde. Usted nos la envía, nosotros la registramos y la utilizamos para comprobar que cada solicitud procede realmente de su equipo.

Dado que la clave privada nunca se comparte, no existe contraseña ni secreto compartido que pueda perderse.

> [!NOTE]
>
> El estándar en el que se basa es OAuth 2.0 con autenticación de cliente JWT mediante clave privada ([RFC 7523](https://datatracker.ietf.org/doc/html/rfc7523)). Su máquina firma una solicitud de corta duración con su clave privada; nosotros verificamos la firma con la clave pública que ha registrado y, a continuación, emitimos un token de acceso. Las claves utilizan el algoritmo ES256 sobre la curva elíptica P-256.

## Incorporación de un vistazo

**1. Generar un par de claves**

Genere un par de claves ES256 en el equipo que vaya a llamar a la API. Consulte [Configuración del par de claves](/api-reference/authentication/key-pair-setup).

**2. Envíenos la clave pública**

Envíe únicamente `es256-public.pem`, junto con la huella digital y sus datos de incorporación, a su persona de contacto en Credit Benchmark.

**3. Reciba su paquete de incorporación**

Registramos la clave y le enviamos un paquete de incorporación con los datos de su cliente y scripts de ejemplo ejecutables.

**4. Solicitar tokens de acceso**

Su máquina firma una aserción de cliente de corta duración con su clave privada y la envía al punto final de tokens. Verificamos la firma con la clave pública registrada a su nombre `KID` y devolvemos un token de acceso. Consulte [Solicite un token de acceso](/api-reference/authentication/request-token).

## Lo que recibirá a cambio

Una vez registrada su clave pública, le enviaremos un paquete de incorporación. Contiene tres datos que convierten su clave en un inicio de sesión operativo, además de scripts de ejemplo en Python y Node.js. Ninguno de estos datos es confidencial, pero guárdelos junto con la configuración de su integración.

| Detalle | Qué es | Dónde se utiliza |
| - | - | - |
| `OAuthClientId` | Su identificador de cliente, un GUID aleatorio que identifica a su organización en nuestro sistema | El `iss` y `sub` reivindicaciones de su solicitud firmada, así como el `OAuthClientId` campo del formulario |
| `KID` | El identificador de la clave pública que nos ha enviado, para que sepamos qué clave debemos comprobar | El `kid` encabezado de su solicitud firmada |
| Punto final de tokens | La dirección web que entrega los tokens de acceso | Dónde se envía la solicitud de token |

> [!TIP]
>
> El punto final del token es `https://gateway.creditbenchmark.com/api/security/token` y el valor de «audience» es `cb-gateway-m2m-blue`. Su paquete de incorporación incluye ambos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.