Guía de inicio

Para hacer uso de las APIs se requiere la generación de un token, donde se debe cumplir con ciertas precondiciones que a continuación se detallan:

• Generación de JWKS

El cliente deberá entregar a Banco Security un componente público de un JWKS para generar sus credenciales de acceso API.

• Disponibilidad de Plataforma o Desarrollo para Generar Tokens JWT

En su entorno de trabajo cada cliente deberá firmar un token JWT con el componente privado del mismo JWKS compartido a Banco Security para garantizar su identidad.

Referencias

https://openid.net/developers/jwt-jws-jwe-jwk-and-jwa-implementations/
https://datatracker.ietf.org/doc/html/rfc7517
https://datatracker.ietf.org/doc/html/rfc7519

Ejemplo

URL solicitud de Token

Ambiente productivo
https://idp.bancosecurity.cl/jans-auth/restv1/token

HTTP Method: POST
HTTP Headers (Encabezado de solicitud):
Content-type: application/x-www-form-urlencoded

Input

Para la generación de Token, se requiere ingresar lo siguiente:

A continuación, verás un ejemplo en Postman:

Output

Como resultado, se obtiene un código respuesta HTTP que indica que la solicitud de Token ha resultado exitosa, en este caso Success status: 200

Error status

En caso que la respuesta HTTP a la petición de Token resulte fallida, se visualizará un código de error. A continuación se detallan los Error status:

Ejemplo Output OK

Luego, el token generado debe ser ingresado en el request de la API como Authorization type = Bearer Token.

A continuación, verás un ejemplo en Postman: