Autenticação
Login, renovação de sessão, MFA e recuperação de acesso.
Entrar com e-mail e senha
Autentica por e-mail e senha no plano `organization` (padrão) ou `platform` e devolve um token de acesso, gravando o token de renovação em cookie `HttpOnly`. No plano da plataforma, quem tem TOTP precisa enviar `totp` (`403` `mfa_required` se ausente, `401` `mfa_invalid` se errado); na organização, um dispositivo confiável dispensa o segundo fator. Credenciais inválidas retornam `401`; excesso de tentativas por IP e e-mail retorna `429`. Rota pública.
Renovar token de acesso
Gira o token de renovação do cookie e devolve um novo token de acesso. Exige o token de acesso anterior (pode estar expirado) no cabeçalho `Authorization` para identificar a sessão. Sem cookie ou sessão válida retorna `401`; reapresentar um token de renovação já girado revoga a sessão (`401` `session_revoked`).
Sair da sessão
Revoga a sessão atual, quando houver uma autenticada, e apaga os cookies de renovação. Responde `204` mesmo sem sessão.
Solicitar redefinição de senha
Envia por e-mail um link de redefinição de senha quando o e-mail pertence a uma conta ativa; usa o e-mail de recuperação confirmado, se houver. Sempre responde `204`, sem revelar se a conta existe. Excesso de tentativas retorna `429`. Rota pública.
Redefinir senha com token
Define uma nova senha a partir do token recebido por e-mail e encerra todas as sessões da conta. A senha precisa ter ao menos 12 caracteres (`password_too_short`) e não pode constar em vazamentos conhecidos (`password_pwned`). Token inválido, usado ou expirado retorna `400` `recovery_invalid`. Rota pública.
Aceitar convite
Aceita um convite de membro ou um link de acesso da organização, ativa o vínculo e já devolve um token de acesso com cookie de renovação. Conta nova define `password` (mínimo de 12 caracteres, sem vazamento conhecido); conta existente confirma com `current_password`. Convite inválido ou expirado retorna `400` `invite_invalid`; domínio de e-mail não permitido retorna `400`; senha atual errada retorna `401`. Rota pública com limite de tentativas (`429`).
Pré-visualizar link de acesso
Mostra e-mail, nome, organização e se já existe conta para o portador de um link de acesso da organização, sem consumi-lo. Usa `POST` para que leitores automáticos de links no e-mail não o acionem. Convites de membro não têm pré-visualização e, assim como links inválidos, retornam `400` `invite_invalid`. Rota pública com limite por IP (`429`).
Revelar senha temporária do convite
Consome um convite ou link de acesso e, quando a conta ainda não tem senha, gera e devolve uma senha temporária uma única vez. Conta que já tem senha precisa informar `current_password` (`400` `invite_password_required` se ausente, `401` se errada). Convite inválido retorna `400`. Rota pública com limite de tentativas (`429`).
Listar fatores de autenticação
Lista os segundos fatores cadastrados pela pessoa autenticada (`totp` ou `email`) e se cada um já foi confirmado. Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Cadastrar aplicativo autenticador
Em duas etapas: sem `code`, gera o segredo TOTP, a URL `otpauth` e o QR code em PNG (válidos por 10 minutos); com `code`, confirma o fator, satisfaz o segundo fator da sessão e devolve 8 códigos de recuperação. Com `remember_device`, confia neste dispositivo por 30 dias. Código errado retorna `401` `mfa_invalid`; contas de demonstração recebem `403`; limite de 5 tentativas a cada 10 minutos (`429`). Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Cadastrar segundo fator por e-mail
Em duas etapas: sem `code`, envia um código de 6 dígitos ao e-mail da conta (válido por 10 minutos); com `code`, confirma o fator e satisfaz o segundo fator da sessão. Com `remember_device`, confia neste dispositivo por 30 dias. Código errado retorna `401`; contas de demonstração recebem `403`; envios e tentativas têm limite (`429`). Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Remover fator de autenticação
Remove o fator indicado em `factor_type` (`totp` ou `email`) e revoga todos os dispositivos confiáveis. Se alguma organização ativa da pessoa exige segundo fator, o último fator confirmado não pode ser removido (`400` `cannot_remove_last_mfa`). Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Validar segundo fator da sessão
Satisfaz o segundo fator da sessão atual com um código `totp`, `email` ou de recuperação (`recovery`); com `method` `email` e sem `code`, envia o código por e-mail. Com `remember_device`, confia neste dispositivo por 30 dias. Código errado retorna `401` `mfa_invalid`; limite de 5 tentativas a cada 10 minutos (`429`). Exige uma pessoa autenticada com sessão.
Contar dispositivos confiáveis
Informa quantos dispositivos confiáveis ativos a pessoa tem e por quantos dias a confiança vale (`days`). Apenas a própria pessoa autenticada (chaves de API recebem `403`).
Esquecer dispositivos confiáveis
Revoga todos os dispositivos confiáveis da pessoa: o próximo login em cada um volta a pedir o código. Também apaga o cookie de confiança deste navegador. Apenas a própria pessoa autenticada (chaves de API recebem `403`).