Gema Devise: gestión de usuarios en Ruby on Rails
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
- Añade la gema y ejecuta el instalador.
- Haz la configuración que te pide el instalador.
- Genera el modelo de usuarios y migra.
- 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_outresponde 404. Usabutton_to … method: :delete. undefined method 'downcase' for nilal 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:viewsantes: vuelve a generarlas condevise: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_optionsen el entorno, sobre todo en producción. - Has cerrado toda la aplicación y la portada pide login. Con
authenticate_user!enApplicationController, abre lo público conskip_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 authenticationsi 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
- Asocia los datos de cada usuario con asociaciones en Ruby on Rails (por ejemplo,
has_many :pedidos). - Deja que cada usuario suba su avatar: subir archivos en Ruby on Rails.
- 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
IntegrationHelpersy 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:viewsy 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.