ES | EN

Onesait Platform está preparada para trabajar con autenticación OAuth2. A continuación se explica el flujo de gestión de los tokens Oauth2.

1. Parametros de configuración OAuth2 de los Realms

A la hora de crear o modificar un Realm, existen dos parámetros que se pueden configurar asociados a los tokens de autenticación dentro de cada Realm.

Clave (Secret): Se utilizará para la autenticación de los clientes.
Tiempo de validez de token (S): periodo de tiempo configurable (en segundos) durante el que un token generado es válido.

Son atributos opcionales. En caso de no informarse, tomarán valores por defecto definidos en el despliegue de la plataforma (onesaitplatform y 43200 (12 horas)).

2. Generación de Tokens

Hay un endpoint que permite generar tokens Oauth2. Su URL es como esta: https://lab.onesaitplatform.com/oauth-server/oauth/token

Se trata de una petición POST, y debe incluir:

Headers:
- Authorization: (client:secret b64)
- Content-Type: application/x-www-form-urlencoded
Body:
- grant_type: password (para peticiones User/Password)
- username: id de usuario
- password: contraseña de usuario
- clientId: id del cliente que solicita el token
- scope: ambito del token

Utilizando Postman para realizar esta petición:

La respuesta tendrá esté formato:

A destacar:

access_token: Token de acceso
refresh_token: Token de refresco (de un solo uso)
expires_in: Tiempo restante de validez (segundos)
authorities: Roles asignados al usuario

3. Check Token

Servicio que verifica la validez de un token. El endpoint sería como este: https://lab.onesaitplatform.com/oauth-server/openplatform-oauth/check_token

La petición debe incluir:

Headers:
- Authorization: (client:secret b64)
Parameter:
- token: token a validar

Usando postman:

1. Parametros de configuración OAuth2 de los Realms

2. Generación de Tokens

3. Check Token

4. Refresh Token

5. Revoke Token

Browser not supported