Nivel inicial12 min de lectura · Publicado el

Gema Devise: gestión de usuarios en Ruby on Rails

Gema Devise en Rails: una portería que da de alta en /users/sign_up, deja entrar en /users/sign_in y despide con DELETE /users/sign_out. Devise: el login, ya hechorubentejera.com /users/sign_upcrear cuenta/users/sign_inentrarDELETE /users/sign_outsalir
Devise es la portería del edificio: en vez de fabricar tú las cerraduras, ella da de alta, deja entrar y despide. Desde Rails 7, salir se hace con button_to y method: :delete.

La gema Devise (en inglés, devise gem) te da hecha la gestión de usuarios en Ruby on Rails: registro, inicio y cierre de sesión, recuperación de contraseña y más. Es como contratar un servicio de portería para tu edificio en lugar de fabricar tú las cerraduras: tú decides qué puertas vigila y la portería se encarga de dar de alta, dejar entrar y despedir.

En esta guía la instalas paso a paso en Rails 8, proteges páginas con authenticate_user!, la configuras, la traduces al español y compruebas con tests que todo funciona. Casi todo el código se ha ejecutado con las versiones actuales; lo que no, se indica en las fuentes, junto a las versiones.

Qué es Devise y qué módulos trae

Devise es una gema, es decir, una librería de Ruby que se instala con Bundler. Está construida sobre Warden, otra gema que hace el trabajo de bajo nivel de la autenticación. Devise 5 funciona con Rails 7 en adelante.

Funciona por módulos: piezas que activas o no según lo que necesite tu aplicación. Son estos diez:

Módulo Qué hace
database_authenticatable Guarda un hash de la contraseña (bcrypt), una huella que no se puede revertir, y comprueba el inicio de sesión.
registerable Registro de cuentas, y editarlas o borrarlas.
recoverable Restablecer la contraseña por email.
rememberable La casilla «Recordarme», con una cookie.
validatable Valida el email y la contraseña.
confirmable Pide confirmar la cuenta desde un email antes de entrar.
lockable Bloquea la cuenta tras varios intentos fallidos.
timeoutable Cierra la sesión tras un rato sin actividad.
trackable Registra cuántas veces y desde qué IP entra cada usuario.
omniauthable Inicio de sesión con terceros (Google, GitHub…) a través de OmniAuth.

El generador activa los cinco primeros. Así queda el modelo:

class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable
end

Instalar la gema Devise en Rails paso a paso

  1. Añade la gema y ejecuta el instalador.
  2. Haz la configuración que te pide el instalador.
  3. Genera el modelo de usuarios y migra.
  4. Pon los enlaces de sesión en la navegación.

Si todavía no tienes una aplicación, créala antes: lo explica crear y arrancar un nuevo proyecto en Ruby on Rails.

1. Añade la gema

bundle add devise
bin/rails generate devise:install

bundle add escribe la línea en el Gemfile (gem "devise", "~> 5.0") y la instala. El instalador crea dos ficheros:

      create  config/initializers/devise.rb
      create  config/locales/devise.en.yml

2. Configura lo que pide el instalador

El propio instalador te dice qué falta. Esta es su salida real:

Depending on your application's configuration some manual setup may be required:

  1. Ensure you have defined default url options in your environments files. Here
     is an example of default_url_options appropriate for a development environment
     in config/environments/development.rb:

       config.action_mailer.default_url_options = { host: 'localhost', port: 3000 }

     In production, :host should be set to the actual host of your application.

     * Required for all applications. *

  2. Ensure you have defined root_url to *something* in your config/routes.rb.
     For example:

       root to: "home#index"
     
     * Not required for API-only Applications *

  3. Ensure you have flash messages in app/views/layouts/application.html.erb.
     For example:

       <p class="notice"><%= notice %></p>
       <p class="alert"><%= alert %></p>

     * Not required for API-only Applications *

  4. You can copy Devise views (for customization) to your app by running:

       rails g devise:views
       
     * Not required *

En la práctica:

a) Correo. Devise envía emails (por ejemplo, el enlace para recuperar la contraseña) y necesita saber la dirección de tu aplicación. En config/environments/development.rb, dentro del bloque configure:

config.action_mailer.default_url_options = { host: "localhost", port: 3000 }

En producción, cambia host por el dominio real de tu aplicación, en config/environments/production.rb.

b) Ruta raíz. En config/routes.rb:

root "pages#inicio"

c) Mensajes flash. Son los avisos de una sola vez, como «Sesión finalizada». Van dentro del <body> de app/views/layouts/application.html.erb:

<body>
  <p class="notice"><%= notice %></p>
  <p class="alert"><%= alert %></p>
  <%= yield %>
</body>

3. Genera el modelo de usuarios

bin/rails generate devise User
bin/rails db:migrate

El generador crea el modelo, la migración y añade esta línea a config/routes.rb:

devise_for :users

La tabla users queda así en db/schema.rb (salida real, sin el campo nombre que se añade más abajo):

  create_table "users", force: :cascade do |t|
    t.string "email", default: "", null: false
    t.string "encrypted_password", default: "", null: false
    t.string "reset_password_token"
    t.datetime "reset_password_sent_at"
    t.datetime "remember_created_at"
    t.datetime "created_at", null: false
    t.datetime "updated_at", null: false
    t.index ["email"], name: "index_users_on_email", unique: true
    t.index ["reset_password_token"], name: "index_users_on_reset_password_token", unique: true
  end

Fíjate en que no hay una columna password: Devise solo guarda encrypted_password: un hash de la contraseña (bcrypt), una huella que no se puede revertir. Pese al nombre de la columna, no está cifrada.

4. Enlaces de sesión en la navegación

<nav>
  <% if user_signed_in? %>
    <%= button_to "Cerrar sesión", destroy_user_session_path, method: :delete %>
  <% else %>
    <%= link_to "Iniciar sesión", new_user_session_path %>
    <%= link_to "Crear cuenta", new_user_registration_path %>
  <% end %>
</nav>

Las rutas de Devise

devise_for :users crea de golpe todas las rutas de la portería. Para verlas, filtra las de user:

bin/rails routes -g user

Estas son las de sesión y registro (salida real, recortada):

        new_user_session GET    /users/sign_in(.:format)       devise/sessions#new
            user_session POST   /users/sign_in(.:format)       devise/sessions#create
    destroy_user_session DELETE /users/sign_out(.:format)      devise/sessions#destroy
cancel_user_registration GET    /users/cancel(.:format)  devise/registrations#cancel
   new_user_registration GET    /users/sign_up(.:format) devise/registrations#new
  edit_user_registration GET    /users/edit(.:format)    devise/registrations#edit
       user_registration PATCH  /users(.:format)         devise/registrations#update
                         PUT    /users(.:format)         devise/registrations#update
                         DELETE /users(.:format)         devise/registrations#destroy
                         POST   /users(.:format)         devise/registrations#create

La primera columna es el nombre del helper: new_user_session te da new_user_session_path, que es lo que usas en link_to. Hay más rutas, por ejemplo las de /users/password para recuperar la contraseña.

Proteger controladores con authenticate_user!

Instalar Devise no protege nada por sí solo: tú decides qué puertas vigila la portería. Para eso está authenticate_user!, un filtro que se ejecuta antes de cada acción. Si no hay sesión, manda al visitante al formulario de inicio de sesión; si la hay, le deja pasar.

Proteger un controlador o unas acciones

class PagesController < ApplicationController
  # Solo el panel exige sesión iniciada; la portada es pública
  before_action :authenticate_user!, only: :panel

  def inicio
  end

  def panel
  end
end

Sin only:, el filtro protege todas las acciones del controlador. Con except: proteges todas menos las que indiques. Si before_action te suena raro, lo tienes explicado en callbacks en Ruby on Rails.

Proteger toda la aplicación

Si casi todo es privado, es más seguro cerrarlo todo y abrir solo lo público. Así, una página nueva nace protegida aunque te olvides de ella:

class ApplicationController < ActionController::Base
  # Toda la aplicación exige sesión, salvo donde se indique lo contrario
  before_action :authenticate_user!
end
class PagesController < ApplicationController
  # La portada es pública
  skip_before_action :authenticate_user!, only: :inicio
end

No hace falta abrir a mano las páginas de inicio de sesión y registro: el filtro no actúa dentro de los controladores de Devise. Se ha comprobado con un test que esas páginas siguen respondiendo con la aplicación entera protegida.

Los helpers que tienes en controladores y vistas

Helper Qué devuelve
user_signed_in? true si hay alguien con la sesión iniciada.
current_user El usuario que ha iniciado sesión, o nil.
user_session La sesión de ese usuario, para guardar datos en ella.

El nombre sale del modelo: si se llamara Member, serían authenticate_member!, member_signed_in? y current_member.

<h1>Bienvenido, <%= current_user.email %></h1>

Configurar Devise: el inicializador

Cuando buscas cómo configurar Devise, casi todo está en un fichero: config/initializers/devise.rb. El instalador lo crea con todas las opciones comentadas. Estas son las que más se tocan, con su valor en el fichero recién generado:

Opción Valor generado Para qué sirve
config.mailer_sender '[email protected]' El remitente de los emails. Cámbialo siempre.
config.password_length 6..128 Longitud mínima y máxima de la contraseña.
config.reset_password_within 6.hours Cuánto dura el enlace para restablecer la contraseña.
config.sign_out_via :delete El método HTTP para cerrar sesión.
config.remember_for 2.weeks (comentada) Cuánto dura «Recordarme».
config.timeout_in 30.minutes (comentada) Inactividad máxima, si activas timeoutable.
config.maximum_attempts 20 (comentada) Intentos fallidos antes de bloquear, si activas lockable.

Tras cambiar el inicializador, reinicia el servidor: los inicializadores solo se leen al arrancar.

Añadir campos al registro

El formulario de registro solo admite email y contraseña. Si quieres pedir, por ejemplo, un nombre, necesitas tres cosas: la columna, el campo en la vista y permiso para recibirlo.

bin/rails generate migration AddNombreToUsers nombre:string
bin/rails db:migrate

Rails descarta los parámetros que no autorizas, por seguridad; lo explica strong params en Ruby on Rails. Con Devise no editas su controlador, sino que le das permiso desde ApplicationController:

class ApplicationController < ActionController::Base
  before_action :configure_permitted_parameters, if: :devise_controller?

  protected

  # Permite el campo extra "nombre" en el formulario de registro
  def configure_permitted_parameters
    devise_parameter_sanitizer.permit(:sign_up, keys: [:nombre])
  end
end

:sign_up es el registro. Si también quieres que se pueda cambiar al editar la cuenta, añade la misma línea con :account_update. El campo en el formulario se añade copiando las vistas, como se ve más abajo. Para comprobar que se ha guardado, puedes consultar el usuario desde la consola de Ruby on Rails.

Traducir los mensajes de Devise al español

Devise trae sus textos en inglés: «You need to sign in or sign up before continuing.», «Signed out successfully.»… Están en config/locales/devise.en.yml. Para traducirlos tienes dos caminos.

La forma rápida: la gema devise-i18n

La wiki de Devise señala la gema devise-i18n como el proyecto para unificar sus traducciones. Trae los mensajes y también las vistas en muchos idiomas, español incluido. Se instala después de Devise:

bundle add devise-i18n

Y le dices a Rails que el idioma por defecto es el español, en config/application.rb:

module Tienda
  class Application < Rails::Application
    config.i18n.default_locale = :es
    # …
  end
end

devise-i18n instala también rails-i18n, que traduce los mensajes de validación de Rails. Con solo eso, la aplicación de prueba pasó a mostrar:

En inglés Con devise-i18n
You need to sign in or sign up before continuing. Tienes que iniciar sesión o registrarte para poder continuar.
Welcome! You have signed up successfully. Bienvenido. Tu cuenta fue creada.
Signed out successfully. Sesión finalizada.
Email can’t be blank Email no puede estar en blanco
Password is too short (minimum is 6 characters) Contraseña es demasiado corto (6 caracteres mínimo)

El formulario de inicio de sesión también sale traducido: «Iniciar sesión», «Contraseña», «Recordarme».

# config/locales/es.yml
es:
  activerecord:
    models:
      user:
        one: "usuario"
        other: "usuarios"
  errors:
    messages:
      not_saved:
        one: "No se ha podido guardar el %{resource}: hay 1 error."
        other: "No se ha podido guardar el %{resource}: hay %{count} errores."

Con ese fichero, un registro con el email vacío y una contraseña corta muestra:

No se ha podido guardar el usuario: hay 2 errores.
Email no puede estar en blanco
Contraseña es demasiado corto (6 caracteres mínimo)

La traducción de devise-i18n es genérica. Si quieres otro tono o corregir algo, como ese «demasiado corto», escribe tu versión de la clave en tu config/locales/es.yml: tus ficheros mandan sobre los de la gema. Comprueba cada texto que cambies con el formulario real.

La forma manual: tu propio devise.es.yml

Si no quieres otra gema, copia config/locales/devise.en.yml como config/locales/devise.es.yml, cambia la primera línea en: por es: y traduce los textos. Mantén las claves tal cual: Devise busca los mensajes por su ruta, como devise.failure.unauthenticated. La wiki de Devise enlaza traducciones al español hechas por la comunidad, pero son de versiones distintas: revisa que tengan todas las claves de tu versión. Con este camino las vistas siguen en inglés hasta que las copies y las traduzcas tú.

Si tu aplicación tiene varios idiomas, el README de Devise recuerda que sus controladores heredan de ApplicationController: el idioma de cada petición debe fijarse ahí.

Personalizar las vistas de login y registro

Devise trae sus propias vistas. Para copiarlas a tu proyecto y cambiarlas:

bin/rails generate devise:views

Se crean en app/views/devise, una carpeta por cada parte:

views
├── articles
└── devise
    ├── confirmations
    ├── mailer
    ├── passwords
    ├── registrations
    ├── sessions
    ├── shared
    └── unlocks

Si usas devise-i18n, genera las vistas con su generador, que ya las trae preparadas para traducirse:

bin/rails generate devise:i18n:views

Las vistas copiadas con devise:views llevan los textos en inglés escritos dentro y tapan las de devise-i18n. Si ya las habías copiado, el README de devise-i18n indica que hay que volver a generarlas y aplicar de nuevo tus cambios.

Probar con tests que una página está protegida

Una página privada que se queda abierta por error no se nota a simple vista. Un test lo detecta en segundos. Devise trae Devise::Test::IntegrationHelpers, que te da sign_in y sign_out para no tener que rellenar el formulario en cada test.

Primero, un usuario de prueba en test/fixtures/users.yml:

ana:
  email: [email protected]
  encrypted_password: <%= Devise::Encryptor.digest(User, "secreto123") %>

Y los tests, en test/integration/acceso_test.rb. El panel usa la vista del apartado de helpers, con current_user.email:

require "test_helper"

class AccesoTest < ActionDispatch::IntegrationTest
  include Devise::Test::IntegrationHelpers

  test "sin sesión, el panel manda al formulario de login" do
    get panel_path
    assert_redirected_to new_user_session_path
    follow_redirect!
    assert_equal "Tienes que iniciar sesión o registrarte para poder continuar.", flash[:alert]
  end

  test "con sesión, el panel se ve" do
    sign_in users(:ana)
    get panel_path
    assert_response :success
    assert_select "h1", "Bienvenido, [email protected]"
  end

  test "cerrar sesión necesita DELETE" do
    sign_in users(:ana)
    delete destroy_user_session_path
    assert_redirected_to root_path
    assert_equal "Sesión finalizada.", flash[:notice]
  end
end
bin/rails test test/integration/acceso_test.rb

Última línea de la salida real:

3 runs, 11 assertions, 0 failures, 0 errors, 0 skips

Si los tests en Ruby son nuevos para ti, empieza por la introducción al testing en Ruby. Y si quieres escribir el test antes que el código, mira qué es TDD.

Errores típicos con Devise

  • El enlace de cerrar sesión no hace nada o da un error de ruta. Estás haciendo un GET. La ruta solo acepta DELETE: en la aplicación de prueba, GET /users/sign_out responde 404. Usa button_to … method: :delete.
  • undefined method 'downcase' for nil al registrarse en español. Faltan claves en la traducción; mira el apartado de traducción.
  • Los textos siguen en inglés con devise-i18n. Probablemente copiaste las vistas con devise:views antes: vuelve a generarlas con devise:i18n:views.
  • El campo nuevo del registro llega vacío. Falta permitirlo con devise_parameter_sanitizer.permit.
  • El enlace del email apunta a un sitio raro o falla. Falta default_url_options en el entorno, sobre todo en producción.
  • Has cerrado toda la aplicación y la portada pide login. Con authenticate_user! en ApplicationController, abre lo público con skip_before_action.

Cuándo usar Devise y cuándo no

Esto es interpretación nuestra a partir de la documentación de Devise y de Rails:

  • Usa Devise si necesitas varios de sus módulos (confirmar el email, bloquear cuentas, «Recordarme», OAuth) y prefieres una solución que mantienen otros.
  • Usa bin/rails generate authentication si te basta con iniciar y cerrar sesión y recuperar la contraseña, y quieres que todo el código esté a la vista en tu proyecto.
  • No uses Devise para aprender cómo funciona la autenticación. Su propio README lo desaconseja en una primera aplicación de Rails: oculta muchas piezas y personalizarlo exige conocer bien Rails.

Siguientes pasos

  1. Asocia los datos de cada usuario con asociaciones en Ruby on Rails (por ejemplo, has_many :pedidos).
  2. Deja que cada usuario suba su avatar: subir archivos en Ruby on Rails.
  3. Cubre con tests cada página privada antes de publicarla.

Fuentes

Consultado el 8 de noviembre de 2026:

  • README de Devise: módulos, filtros y helpers, parámetros permitidos, I18n, Turbo, tests con IntegrationHelpers y la recomendación para quien empieza con Rails. Devise 5 funciona con Rails 7 en adelante.
  • Devise en RubyGems: Devise 5.0.4, del 8 de mayo de 2026, es la versión actual.
  • Wiki de Devise: I18n: default_locale, la gema devise-i18n y las traducciones al español de la comunidad.
  • README de devise-i18n: instalación después de Devise, devise:i18n:views y qué hacer si ya habías copiado las vistas.
  • Guía de seguridad de Rails y rubyonrails.org: Rails 8.1.4.1, del 4 de noviembre de 2026.

Qué se ha ejecutado. Con la imagen oficial de Docker ruby:latest (Ruby 4.0.9), Rails 8.1.4.1, Devise 5.0.4 y devise-i18n 1.16.1, en una aplicación creada con rails new --minimal y Action Mailer activado: la instalación y su salida, el modelo, la migración, las rutas, la protección por controlador y la global con skip_before_action, el campo nombre, la traducción con devise-i18n y el error de downcase, y los tests, que pasan. También se ha comprobado que existen devise:views, devise:i18n:views y generate authentication. Las opciones del inicializador son las del fichero generado.

Qué no se ha ejecutado. No se ha probado en un navegador: el comportamiento de Turbo con link_to … method: :delete, el envío real de emails ni la versión manual con devise.es.yml, que se ha comprobado solo en la documentación.

Cambios respecto al original: rake db:migrate pasa a bin/rails db:migrate; se quitan los apartados vacíos sobre Heroku y personalización.