Email e senha

Adicione cadastro e login com email e senha ao seu app pela página hospedada do Clowk: hash com bcrypt, regras de senha, verificação de email e reset.

Visão geral

O Clowk suporta autenticação por email e senha junto com os provedores OAuth. Os usuários podem se cadastrar com email e senha e depois entrar com as mesmas credenciais.

Todo o fluxo acontece na página hospedada do Clowk. Seu app nunca lida com senhas.

Como funciona

  1. O usuário clica em "Sign up" no seu app
  2. Seu app redireciona para a página de cadastro hospedada do Clowk
  3. O usuário informa email e senha
  4. O Clowk cria a conta do usuário e gera um JWT
  5. O Clowk redireciona de volta para o seu app com o token

O login segue o mesmo padrão: o usuário informa as credenciais, o Clowk verifica e retorna um JWT.

Requisitos de senha

  • Mínimo de 8 caracteres (configurável por instância via min_password_length)
  • As senhas passam por hash com bcrypt (cost factor 12) antes de serem salvas
  • O Clowk nunca salva nem registra em log senhas em texto puro

Configuração da instância

Você controla o comportamento de email/senha por instância no dashboard do Clowk:

ConfiguraçãoPadrãoDescrição
allow_email_signintruePermite login com email
allow_email_signuptruePermite cadastro com email
allow_password_signintruePermite login com senha
require_password_signuptrueExige senha no cadastro
min_password_length8Tamanho mínimo da senha

Verificação de email

Quando um usuário se cadastra com email e senha, o campo email_verified_at fica null até ele verificar o email. Usuários que entram por provedores OAuth (Google, GitHub) têm o email verificado automaticamente.

Payload do JWT

O JWT de usuários de email/senha inclui "provider": "email":

{
  "iss": "clowk",
  "sub": "user-uuid",
  "email": "[email protected]",
  "name": "Jane Doe",
  "provider": "email",
  "instance_id": "inst_abc123",
  "app_id": "app_xyz789",
  "iat": 1711152000,
  "exp": 1711155600
}

Redefinição de senha

  1. O usuário pede a redefinição de senha na página hospedada do Clowk
  2. O Clowk envia um link de redefinição para o email do usuário
  3. O usuário clica no link e define uma nova senha
  4. Limite de 3 tentativas por minuto por email

Nesta página