Docs /
... / Autenticación y seguridad / Autenticación de usuarios

🔐 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? Devuelve true o false.
  • 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})`
}