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
- O usuário clica em "Sign up" no seu app
- Seu app redireciona para a página de cadastro hospedada do Clowk
- O usuário informa email e senha
- O Clowk cria a conta do usuário e gera um JWT
- 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ção | Padrão | Descrição |
|---|---|---|
allow_email_signin | true | Permite login com email |
allow_email_signup | true | Permite cadastro com email |
allow_password_signin | true | Permite login com senha |
require_password_signup | true | Exige senha no cadastro |
min_password_length | 8 | Tamanho 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
- O usuário pede a redefinição de senha na página hospedada do Clowk
- O Clowk envia um link de redefinição para o email do usuário
- O usuário clica no link e define uma nova senha
- Limite de 3 tentativas por minuto por email
Como funciona
Como funciona a autenticação do Clowk, do redirect ao JWT assinado: modelo broker, providers OAuth, credenciais próprias, entrega e verificação do token.
Configure o login com Google no Clowk: crie credenciais OAuth 2.0 no Google Cloud Console, adicione a redirect URI e receba um JWT com email verificado.