Autenticação pelo endereço recebido
Um link mágico é um endereço com uma credencial temporária que permite entrar numa aplicação ao abri-lo. No uso por email, você informa seu endereço na tela de entrada e recebe o link na caixa de entrada. O serviço verifica a credencial para concluir a autenticação, sem exigir que você digite uma senha da aplicação.
Ao abrir o endereço, o navegador apresenta a credencial ao serviço de autenticação. A verificação confere sua validade e permite concluir o fluxo que estabelece a sessão na aplicação. Por isso, o recebimento do email ainda não significa que a entrada foi concluída.
Um fluxo de entrada no Supabase
No Supabase Auth, o método signInWithOtp envia um link mágico por padrão, apesar do nome mencionar código de uso único. Neste exemplo, um cliente Supabase já configurado inicia a entrada para o email informado:
const { error } = await supabase.auth.signInWithOtp({ email: 'ana@example.com', options: { shouldCreateUser: false, },})A opção shouldCreateUser: false evita o cadastro automático de um endereço novo. Você deve tratar um eventual error na aplicação. O sucesso dessa chamada inicia o envio do link, mas ainda exige sua abertura e verificação para concluir a entrada.
Uso único, expiração e retorno à aplicação
Os links mágicos do Supabase são de uso único e têm prazo de expiração configurável. Os destinos de retorno também precisam estar entre os endereços permitidos na configuração de URLs do projeto. Em um teste, confira o caminho completo até a sessão, incluindo o endereço aberto depois da verificação.
Trate o link como uma credencial de acesso e evite compartilhá-lo. A entrada depende do acesso ao email que o recebe. A documentação do Supabase Auth apresenta os fluxos de verificação, inclusive as diferenças entre abrir um link e digitar um código.
Dúvidas frequentes
Perguntas frequentes sobre link mágico
- O envio do email já cria uma sessão autenticada?
- O envio inicia a autenticação. Você ainda precisa abrir o link e concluir sua verificação para que o fluxo estabeleça a sessão.
- Posso reutilizar um link mágico do Supabase?
- Os links mágicos do Supabase são de uso único. Eles também expiram conforme o prazo configurado no serviço.
- Qual é a diferença para um código enviado ao email?
- No link mágico, você abre o endereço recebido. No método por código, você digita o código na aplicação para que o serviço faça a verificação.
Para continuar
Recursos relacionados
Documentação
Supabase: entrada por link mágico e código por email
Mostra o envio do link, sua verificação e as configurações de expiração e redirecionamento no Supabase Auth.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Uma sessão de Desenvolvimento Colaborativo permite investigar com orientação técnica o envio do email e o retorno à aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver a autenticação, você precisa conferir o envio do link e a criação da sessão como etapas distintas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.