<aside> 💡 A partir de 2024-08-01, la forma recomendada de autenticación para las aplicaciones Keirón es a través de token de integración permanente.
Este token se utiliza igualmente como header Authorization tipo Bearer token tal como se detalla en el apartado “Descripción” de esta página, con la única diferencia de no necesitar llamar al endpoint de login.
El token permanente puede ser solicitado por el cliente a su contraparte Keirón y únicamente será entregado por email a 1 destinatario definido por el cliente. Cualquier otro traspaso de token quedan en manos de quien lo recibió.
</aside>
Endpoint para obtener el token de autenticación de usuario que se utilizará en el resto de solicitudes. La respuesta incluye el token de acceso, el tipo de token, su duración y los detalles del usuario.
El token proporcionado en la respuesta (accessToken) debe ser utilizado en las siguientes solicitudes que requieran autenticación en forma de header Authorization tipo Bearer token.
| Nombre del dato | Tipo Dato | Descripción | Valores |
|---|---|---|---|
| Authorization | String | JWT (JSON Web Token) temporal generado para el usuario | Bearer <token> |
La duración del token (expiresIn) es de 86,400 segundos, lo que equivale a 24 horas. Después de ese tiempo, se requerirá iniciar sesión nuevamente.
/authentication/login
POST
| Parámetro | Tipo | Descripción |
|---|---|---|
email |
string | Correo electrónico del usuario. |
password |
string | Contraseña del usuario. |
application |
string | ID de la aplicación. Para la API de CRM el valor es 99a48b97-168a-4b3a-8556-4f59bf9c6e98 |
{
"email": "[email protected]",
"password": "xxxxxxxxxx",
"application": "99a48b97-168a-4b3a-8556-4f59bf9c6e98"
}
{
"data": {
"accessToken": "[TOKEN]",
"tokenType": "bearer",
"expiresIn": "86400",
"user": {
"uuid": "5be29bbf-7ae2-xxxx-xxxx-xxxxxxxxxxxx",
"firstName": "firstname",
"lastName": "lastname",
"email": "[email protected]",
"roles": [
{
"uuid": "52a787d9-b5ac-xxxx-xxxx-xxxxxxxxxxxx",
"application": {
"uuid": "99a48b97-168a-4b3a-8556-4f59bf9c6e98"
}
}
]
}
},
"success": true
}