Skip to main content
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.
El estándar en el que se basa es OAuth 2.0 con autenticación de cliente JWT mediante clave privada (RFC 7523). 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.
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.

​
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.
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.