​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:

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:

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:

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:controllers users

Luego incorpora el controlador que quieras sobreescribir en config/routes.rb de la siguiente manera:

devise_for :users, :controllers => { registrations: 'users/registrations' }

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