Repolode
heartcombo

heartcombo/devise

Solução flexível de autenticação para Rails baseada em Warden, com recursos modulares como login com banco de dados, confirmação, recuperação de senha e bloqueio de contas.

Estrelas
24,350
Forks
5,470
Issues abertas
243
Último commit
mês passado

O que é?

Devise é uma biblioteca de autenticação para Ruby on Rails. Ela é baseada em Warden, um framework de autenticação para Rack, e é distribuída como uma engine Rails que fornece os controllers, as views e as rotas necessárias para um sistema completo de login.

As funcionalidades são divididas em módulos que você ativa por modelo, para incluir apenas o que precisa. Os módulos disponíveis abrangem login com senha armazenada no banco de dados, login social com OmniAuth, confirmação por e-mail, recuperação de senha, cadastro de usuários, cookies para manter a sessão ativa, rastreamento de atividade, limites de tempo para sessões, validações e bloqueio de contas após várias tentativas de login malsucedidas. É possível manter vários modelos, como User e Admin, conectados ao mesmo tempo.

Por padrão, Devise oferece suporte a ActiveRecord e também pode usar Mongoid como ORM alternativo. Os generators instalam um initializer de configuração e criam o modelo e as rotas. Helpers como authenticate_user! e current_user ficam disponíveis nos controllers e nas views.

Recursos principais

  • 01Recursos de autenticação modulares que você ativa por modelo.
  • 02Login com senha armazenada no banco de dados e suporte a HTTP Basic Authentication.
  • 03Integração com OmniAuth para provedores de login de terceiros.
  • 04Fluxos de confirmação por e-mail, recuperação de senha e desbloqueio de contas.
  • 05Vários modelos de usuário conectados ao mesmo tempo.
  • 06Controllers e views personalizáveis, além da sanitização de parâmetros permitidos.

Casos de uso

  • Adicionar cadastro e login a uma aplicação Rails nova ou existente.
  • Separar os logins de administradores e usuários finais usando modelos diferentes.
  • Adicionar login social a contas com e-mail e senha.
  • Proteger endpoints de API com HTTP Basic Authentication no modo Rails API.

Início rápido

  1. 1

    Adicione Devise ao Gemfile do Rails

    bundle add devise
  2. 2

    Execute o gerador de instalação do Devise

    rails generate devise:install
  3. 3

    Gere um modelo de usuário com módulos do Devise

    rails generate devise MODEL
  4. 4

    Execute as migrações do banco de dados

    rails db:migrate

Antes de usar

  • É necessário ter um bom conhecimento de Rails; o README recomenda que iniciantes aprendam primeiro os fundamentos da autenticação do zero.
  • A versão 5 é voltada para Rails 7 em diante, então aplicações Rails mais antigas precisam de uma versão anterior do Devise.

Em coleções

Tópicos

Perguntas frequentes

O que é devise?
Solução flexível de autenticação para Rails baseada em Warden, com recursos modulares como login com banco de dados, confirmação, recuperação de senha e bloqueio de contas. Devise é uma biblioteca de autenticação para Ruby on Rails. Ela é baseada em Warden, um framework de autenticação para Rack, e é distribuída como uma engine Rails que fornece os controllers, as views e as rotas necessárias para um sistema completo de login.
devise é gratuito? Qual é a licença?
devise é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
devise ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de devise foi em 6 de out. de 2026.
Para que posso usar devise?
Adicionar cadastro e login a uma aplicação Rails nova ou existente. Separar os logins de administradores e usuários finais usando modelos diferentes. Adicionar login social a contas com e-mail e senha. Proteger endpoints de API com HTTP Basic Authentication no modo Rails API.
Como instalar devise?
Adicione Devise ao Gemfile do Rails: bundle add devise Execute o gerador de instalação do Devise: rails generate devise:install Gere um modelo de usuário com módulos do Devise: rails generate devise MODEL Execute as migrações do banco de dados: rails db:migrate
Onde consigo devise?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/heartcombo/devise

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados