Autenticación con Devise

Devise es una gema que facilita la implementación de la autenticación en nuestras aplicaciones.

Los pasos para configurar Devise son los siguientes:

  1. Agregar la gema al Gemfile:

    gem 'devise'
  2. Ejecuta bundle install para instalarla.

  3. Ejecuta el generador de Devise:

    $ rails generate devise:install
  4. El siguiente paso es crear el modelo de o de los usuarios de la aplicación, generalmente User:

    $ rails generate devise User
  5. Ejecuta rails db:migrate para correr las migraciones.

Rutas que crea Devise

Asumiendo que el usuario es User, Devise crea, entre otras, las siguientes rutas:

Ruta

Descripción

GET /users/sign_up

Formulario de registro

POST /users

Registrarse

GET /users/sign_in

Formulario de login

POST /users/sign_in

Login

DELETE /users/sign_out

Salir

Para ver el listado completo ejecuta rails routes. Las demás rutas son, en su mayoría, para el manejo de contraseñas (recuperar, cambiar, etc).

Filtros y helpers de controlador

Devise crea algunos métodos de ayuda y filtros para que puedas manejar la autenticación en tu aplicación.

Asumiendo que tu usuario se llama User, el filtro que puedes agregar sobre los controladores que quieres proteger es el siguiente:

before_action :authenticate_user!

Los métodos de ayuda a los que vas a tener acceso en los controladores y vistas son los siguientes:

Método

Descripción

user_signed_in?

Retorna true si el usuario está autenticado, false de lo contrario

current_user

Retorna el usuario que está autenticado o nil

user_session

Retorna la sesión del usuario

El modelo de usuario

Asumiendo que al usuario lo llamaste User al generarlo, el modelo que genera Devise es el siguiente:

class User < ApplicationRecord
# Include default devise modules. Others available are:
# :confirmable, :lockable, :timeoutable and :omniauthable
devise :database_authenticatable, :registerable,
:recoverable, :rememberable, :trackable, :validatable
end

Este es un modelo normal pero utiliza el método devise que recibe una serie de módulos que puedes activar o desactivar.

Los módulos que vienen activados son los siguientes:

Módulo

Descripción

database_authenticatable

Los usuarios se van a poder autenticar con un nombre de usuario y contraseña almacenado en la base de datos.

registereable

Los usuarios van a poder registrarse, actualizar y eliminar su perfil.

recoverable

Los usuarios van a poder recuperar su contraseña

rememberable

Habilita la opción "Recordarme" en el login

trackable

Habilita el seguimiento al usuario (de dónde se autenticó, cuantas veces, de qué IP, etc.)

validatable

Valida el email y el password

Modificando las vistas

Por defecto no vas a ver vistas ni controladores de Devise en tu aplicación. Sin embargo, si quieres modificarlos puedes decirle a Devise que los genere.

Para generar las vistas utiliza el siguiente comando:

$ rails generate devise:views

Para generar los controladores utiliza el siguiente comando:

$ rails generate devise:views users

De esta forma puedes modificar las vistas y cambiar funcionalidad de Devise.