Auth proporciona autenticación y autorización para su aplicación, incluyendo la gestión de usuarios, gestión de grupos, registro de usuarios, inicio de sesión y funciones relacionadas. Se instala automáticamente cuando se crea el proyecto.
El nombre de usuario y la contraseña del administrador por defecto son los siguientes:
- Login: [email protected]
- Password: appmaster
Los ajustes del módulo se pueden configurar de la siguiente manera:
- SignUp Groups: define la lista de grupos donde el usuario puede registrarse
- SignUp: permite a los usuarios registrarse y obtener cuentas en la aplicación
- Session timeout (minutes): define el tiempo después del cual la sesión actual del usuario terminará si el usuario está inactivo; por defecto 60 min;
- Failed login delay (in ms): define el tiempo de retardo para las respuestas después de los intentos fallidos de inicio de sesión; por defecto 0ms;
- Email confirmation required: define si el usuario tiene que confirmar el registro por correo electrónico;
- Signed-Up User Active: establece active=true para cada objeto de usuario recién creado si está habilitado;
- Groups ficha permite crear y configurar una lista de grupos de usuarios;
User y User Session se crean automáticamente una vez instalado el módulo Auth. Puede encontrarlos en la pestaña Data Design ficha. No es posible configurar los atributos por defecto de estos modelos, pero sí es posible añadir otros nuevos.
User, User Session y Auth Module relacionados con BPs
Los procesos de negocio preinstalados relacionados con User y User Session son los siguientes:
User Modelo
- DB: Delete User: borra el objeto User de la base de datos basándose en su ID;
- DB: Update Userrestablece todos los campos de un objeto modelo dado en la base de datos y los actualiza con los valores dados (DB: Patch User debe utilizarse para cambiar sólo los campos proporcionados y mantener los demás tal y como están);
- DB: Create User: crea un registro en la base de datos y devuelve el objeto modelo User (requiere el uso de Make User para crear el objeto User objeto modelo de acuerdo con los campos de entrada);
- DB: Soft Delete User: actualiza el campo DeletedAt campo del objeto modelo User en lugar de eliminar todo el registro como hace DB: Delete User hace;
- DB: Bulk Delete User: elimina de forma masiva el conjunto de User registros del objeto modelo con el IDs (ids array); failed_ids - un array de usuarios IDs que no serán borrados;
- DB: Patch UserActualiza los campos seleccionados del User objeto modelo en la base de datos (DB: Update User tiene que ser utilizado para restablecer todos los campos);
- DB: Search User: busca uno o varios User objetos modelo en la base de datos en función de sus campos y los devuelve;
- DB: GetOne User: encuentra el User objeto modelo en función de su ID y lo devuelve;
- Expand Userdevuelve todos los campos del objeto modelo seleccionado User objeto modelo seleccionado;
- Make User: hace que el User objeto modelo basado en los campos de entrada (es necesario utilizar DB: Create User para hacer el registro en la base de datos);
User Session
- DB: Delete User Session: borra el objeto User Session objeto de la base de datos en función de su ID;
- DB: Update User Session: restablece todos los campos de un objeto modelo dado en la base de datos, y los actualiza con los valores dados (DB: Patch User Session tiene que ser utilizado para cambiar los campos proporcionados solamente);
- DB: Create User Sessioncrea un registro en la base de datos y devuelve el User Session objeto modelo (requiere el uso de Make User Session para crear el objeto modelo User objeto modelo según los campos introducidos);
- DB: Soft Delete User Session: actualiza el campo DeletedAt campo del objeto modelo User Session objeto modelo;
- DB: Bulk Delete User Session: borra en bloque el conjunto de User Session registros del objeto modelo con el IDs (ids array); failed_ids array define el conjunto de IDs que serán ignorados en el proceso de borrado;
- DB: Patch User SessionActualiza los campos seleccionados del User Session objeto modelo en la base de datos (DB: Update User Session tiene que ser utilizado para restablecer todos los campos);
- DB: Search User Session: busca uno o varios User Session objetos modelo en la base de datos en función de sus campos y los devuelve;
- DB: GetOne User Session: encuentra el User Session objeto modelo en función de su ID y lo devuelve;
- Expand User Sessiondevuelve todos los campos del objeto modelo seleccionado User Session objeto modelo seleccionado;
- Make User Session: hace que el User Session objeto modelo basado en los campos de entrada (es necesario utilizar DB: Create User Session para hacer el registro en la base de datos);
Auth Module
- Auth: Generate Auth Token: genera un token de autorización (Auth Token) de la longitud dada;
- Auth: Registration: registra un nuevo usuario;
- Auth: Authorization: comprueba si un determinado Auth Token existe y devuelve el usuario asociado a él;
- Auth: Authentification: comprueba el nombre de usuario y la contraseña y devuelve Auth Token;
- Auth: Logout: finaliza la sesión del usuario actual basándose en el Auth Token;
- Auth: Get current user: devuelve el objeto modelo User objeto modelo;
- Auth: Remove user from group: elimina un usuario del grupo seleccionado basándose en su ID;
- Auth: Add user to group: añade un usuario al grupo seleccionado en función de su ID;
- Auth: Hash Password: convierte la cadena de contraseñas en un hash;
- Auth: Restore Password: restaura la contraseña basándose en el inicio de sesión del usuario
- Auth: Change Password: cambia la contraseña del usuario;
- Auth: Probe Password: comprueba la asociación entre la contraseña y el hash;
Auth Module, User y User Session endpoints
Preinstalado Endpoints de los modelos Auth Module y User y User Session se generan automáticamente una vez que se crea el proyecto.
Auth Module
| Tipo de solicitud | Endpoint | Proceso de negocio asociado |
 | /logout/ | Auth: Logout |
 | /auth/ | Auth: Authentification |
 | /register/ | Auth: Registration |
 | /confirm/ | Auth: Get Current User |
 | /user/change-password/ | Auth: Change Password |
 | /user/restore-password/ | Auth: Restore Password |
 | /user/profile/ | Auth: Get Current User |
Usuario
| Tipo de solicitud | Endpoint | Proceso de negocio asociado |
 | /user/:id/ | DB: Update User |
 | /user/:id/ | DB: Delete User |
 | /user/:id/ | DB: GetOne User |
 | /user/ | DB: Search User |
 | /user/:id/ | DB: Patch User |
 | /user/ | DB: Create User |
User Session
| Tipo de solicitud | Endpoint | Proceso de negocio asociado |
 | /user-session/:id/ | DB: Delete User Session |
 | /user-session/:id/ | DB: GetOne User Session |
 | /user-session/ | DB: Search User Session |
 | /user-session/:id/ | DB: Patch User Session |
 | /user-session/ | DB: Create User Session |
 | /user-session/:id/ | DB: Update User Session |
Auth Token
Auth Token se utiliza como token de sesión de un usuario autorizado. Es posible interactuar con el Auth Token, en los procesos de negocio de la aplicación web:
- Get Auth Token devuelve la sesión del usuario actual Auth Token;
- Set Auth Token reescribe la sesión del usuario actual Auth Token;
- Remove Auth Token elimina la sesión del usuario actual Auth Token;
Cómo obtener el usuario actual
1. Vaya a la pestaña Business logic y arrastre el bloque Auth: Get current user bloque.
2. Vaya a la pestaña Endpoints y amplíe la sección User sección. A continuación, cree un GET método de tipo para el proceso de negocio creado en el paso 1. La URL endpoint sería /user_current.
3. Vaya a la pestaña Web Apps y cree un nuevo proceso de negocio con Server request GET /user_current para obtener el usuario actual del proceso de negocio de la aplicación web.
