Integraciones: Autenticación con aplicaciones

1 -Navegue a la página de aplicaciones

Para enumerar las aplicaciones existentes o crear una nueva, navegue hasta la página Administración -> Integraciones -> Aplicaciones.

2 -Crear una nueva aplicación

Haga clic en el botón +Agregar nuevopara crear una nueva aplicación si es necesario.

3 -Consigue las llaves

Edite la aplicación y ahora debería mostrar las claves pública y privada.

En este ejemplo, la clave pública es "58b8d238-3cfc-41a0-aaad-ae6077d7c4e0" y la clave privada es "ca626c20-659d-4553-8647-2337c0a8804d".

3 -Concatenar las claves

Ahora necesitamos concatenar las claves pública y privada en una sola cadena.

const publicKey = "58b8d238-3cfc-41a0-aaad-ae6077d7c4e0";
const privateKey = "ca626c20-659d-4553-8647-2337c0a8804d"
const keysString = publicKey + privateKey;

Esto generará el siguiente string:

keysString = "58b8d238-3cfc-41a0-aaad-ae6077d7c4e0"ca626c20-659d-4553-8647-2337c0a8804d"

4 - Generar el hash de las claves

Utilizando el algorithm SHA-256 generaremos el hash de las claves.

En este caso sería:

sha256KeysString = "1056e1342f844577aff4f99d146e3dcde1364dfa60aafd6a63f9379e0b7e06de"

5 -Concatenar el nombre de la aplicación con el hash generado

A continuación, debemos agregar el nombre de la aplicación a sha256KeysString.

App_name + ":" + sha256KeysString

En este caso sería:

Test:1056e1342f844577aff4f99d146e3dcde1364dfa60aafd6a63f9379e0b7e06de

6 -Codifica el nombre de la aplicación y el hash

A continuación, debemos utilizar el algoritmo base64 para codificar el string generado en el paso anterior.

echo -n "Test:1056e1342f844577aff4f99d146e3dcde1364dfa60aafd6a63f9379e0b7e06de" | base64

El resultado, en este caso sería:

cGFnb2V4cHJlc3M6MTA1NmUxMzQyZjg0NDU3N2FmZjRmOTlkMTQ2ZTNkY2RlMTM2NGRmYTYwYWFmZDZhNjNmOTM3OWUwYjdlMDZkZQ==

6 -Obtener el token de la aplicación

Ahora necesitamos usar el endpoint POST /accounts/applications para autenticarse usando la aplicación.

Al configurar el encabezado de Autorización Basic con el valor del hash generado, debería verse así:

"Authorization": "Basic cGFnb2V4cHJlc3M6MTA1NmUxMzQyZjg0NDU3N2FmZjRmOTlkMTQ2ZTNkY2RlMTM2NGRmYTYwYWFmZDZhNjNmOTM3OWUwYjdlMDZkZQ=="
"X-API-KEY": "58b8d238-3cfc-41a0-aaad-ae6077d7c4e0"
"Content-Type": "application/json"

La respuesta contendrá la clave pública y el token que se utilizará para autenticar la aplicación.

{
  "publicKey": "57d0398c-4705-4d84-a9ad-7e3ca741497b",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJfaWQiOiI2MGE3YjIyMDVjYzkyYzNhOTExMzYzMzAiLCJhY2NvdW50SWQiOiI1OTVmOWM3MDA3ZWUxMjY4NmQwMDAwMzIiLCJ1c2VySWQiOiI2MGE3YjIyMDVjYzkyYzNhOTExMzYzMzAiLCJuYW1lIjoicGFnb2V4cHJlc3MiLCJkZXNjcmlwdGlvbiI6IkFwcGxpY2F0aW9uIGZvciBkYXRhbG9naWMgcGFnbyBleHByZXNzIGludGVncmF0aW9uIiwiaW50ZXJuYWwiOmZhbHNlLCJwcmVtaXVtIjpbXSwiaWF0IjoxNzE2NDAyNjA2LCJleHAiOjE3MTY1NzU0MDYsImF1ZCI6InBhZ29leHByZXNzIiwiaXNzIjoiYnRyei1hcGktYWNjb3VudHMiLCJzdWIiOiJhY2NvdW50X3VzZXJfc2lnbl9pbiJ9.TiBFtHb2Nrkv8tFt-UHk7wNr-VLQZAhdQM7EALaZbag0T_XJTboj67oe7GNkv0YVIAc9ZXXtNsMdoUecM7TjeQ"
}

7 -Utilice el token de aplicación

Ahora puede usar la clave pública y el token para usarlos en endpoints que necesitan la autorización de la aplicación.

"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJfaWQiOiI2MGE3YjIyMDVjYzkyYzNhOTExMzYzMzAiLCJhY2NvdW50SWQiOiI1OTVmOWM3MDA3ZWUxMjY4NmQwMDAwMzIiLCJ1c2VySWQiOiI2MGE3YjIyMDVjYzkyYzNhOTExMzYzMzAiLCJuYW1lIjoicGFnb2V4cHJlc3MiLCJkZXNjcmlwdGlvbiI6IkFwcGxpY2F0aW9uIGZvciBkYXRhbG9naWMgcGFnbyBleHByZXNzIGludGVncmF0aW9uIiwiaW50ZXJuYWwiOmZhbHNlLCJwcmVtaXVtIjpbXSwiaWF0IjoxNzE2NDAyNjA2LCJleHAiOjE3MTY1NzU0MDYsImF1ZCI6InBhZ29leHByZXNzIiwiaXNzIjoiYnRyei1hcGktYWNjb3VudHMiLCJzdWIiOiJhY2NvdW50X3VzZXJfc2lnbl9pbiJ9.TiBFtHb2Nrkv8tFt-UHk7wNr-VLQZAhdQM7EALaZbag0T_XJTboj67oe7GNkv0YVIAc9ZXXtNsMdoUecM7TjeQ"
"X-API-KEY": "57d0398c-4705-4d84-a9ad-7e3ca741497b"