🔐 Conceptos básicos de autenticación
El servicio Odac.Auth es tu guardia de acceso, encargado de gestionar quién entra y quién se queda fuera. Administra por ti las sesiones de inicio de sesión de los usuarios.
Dejar entrar a un usuario
Odac.Auth.login(userId, userData)
userId: Un ID único para el usuario (como su ID en la base de datos).userData: Un objeto con cualquier información del usuario que quieras recordar, como su nombre de usuario o rol.
Cuando llamas a este método, Auth crea una sesión segura para el usuario.
💡 Seguridad empresarial: ODAC gestiona automáticamente la rotación de tokens cada 15 minutos (configurable) e incluye protección CSRF integrada para todos los formularios. Las sesiones son persistentes entre reinicios del navegador por defecto.
Comprobar la lista de invitados
await Odac.Auth.check(): ¿El usuario actual ha iniciado sesión? Devuelvetrueofalse.Odac.Auth.user(): Obtiene el objeto completo del usuario que ha iniciado sesión.Odac.Auth.user('id'): Obtiene un campo específico del objeto de usuario (por ejemplo, su ID).Odac.Auth.token(): Obtiene el registro completo de la sesión de autenticación desde la tabla de tokens.Odac.Auth.token('id'): Obtiene el ID de la sesión de autenticación desde la tabla de tokens.
Cerrar la sesión de un usuario
Odac.Auth.logout(): Finaliza la sesión del usuario y cierra su sesión.
Ejemplo: Un flujo de inicio de sesión
// Controller for your login form
module.exports = async function (Odac) {
const { username, password } = Odac.Request.post
const loginSuccess = await Odac.Auth.login({ username, password })
if (loginSuccess) {
return Odac.direct('/dashboard')
} else {
return Odac.direct('/login?error=1')
}
}
// A protected dashboard page
module.exports = async function (Odac) {
if (!await Odac.Auth.check()) {
return Odac.direct('/login')
}
const username = Odac.Auth.user('username')
const authId = Odac.Auth.token('id') // Auth session ID from token table
return `Welcome back, ${username}! (Session: ${authId})`
}