Minilição · Português

Como permitir que as pessoas entrem no seu site

Conecte a página de login pronta a um serviço gerenciado de contas e teste códigos por e-mail, saída e tentativas com falha.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem quer login de contas num pequeno site. Um serviço gerenciado e o aplicativo fornecido cuidam da implementação; você pode trabalhar com um assistente de programação sem escrever código de autenticação.

Antes de começar

Seu próprio projeto Supabase de prática e uma caixa de teste permitida ou remetente configurado. Use a página fornecida por HTTP local ou na sua própria hospedagem HTTPS. Um assistente de programação pode orientar a configuração e os códigos por e-mail.

Tempo estimado: 20–32 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. A entrega de e-mail e a configuração da conta podem acrescentar espera. Confira as restrições do provedor e os tempos de duração das sessões na conta usada no exercício.

O que você vai aprender

  • Solicite e use um código real de login.
  • Verifique os estados de sessão iniciada e encerrada.
  • Mantenha códigos errados e mensagens ausentes como falhas honestas.

Arquivos da oficina

Etapa 1

Entenda o percurso de login

Receber um código e estar conectado são momentos diferentes.

Use a página pronta com seu assistente. A pessoa informa um endereço, recebe um código e o envia antes de o serviço estabelecer o login.

Uma página dizer “Verifique sua caixa de entrada” significa que uma solicitação foi feita, não que o visitante está autenticado.

Um exemplo concreto

Um endereço de e-mail sozinho não comprova que seu proprietário concluiu o login.

Use o aplicativo de login Supabase fornecido. Oriente-me a configurar os códigos por e-mail no provedor com minha própria caixa de teste permitida, coloque apenas valores publicáveis do projeto na configuração pública e execute a página por HTTP. Ajude a testar solicitação de código, inserção, recarga e saída. Um código inválido ou e-mail ausente não deve virar um estado fictício de sessão iniciada.

Supabase: códigos de acesso por e-mail · Supabase: tipos de chave de API

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Acrescente uma sessão real de acesso

A autenticação verifica uma identidade; exibir um endereço de e-mail não basta.

Usaremos o Supabase Auth para enviar um código de uso único por e-mail e estabelecer uma sessão após a verificação. O SDK do navegador gerencia o armazenamento e a renovação da sessão; não implementamos um banco de senhas.

Uma solicitação aceita pelo endpoint de e-mail não significa que o usuário entrou. A sessão só aparece depois de uma verificação válida. Autorizar acesso a dados privados é outra verificação, separada e posterior.

Exemplo resolvido

Digitar o e-mail de outra pessoa em um campo não deve conceder o acesso dela. O código enviado à caixa de entrada é a etapa de verificação.

Supabase: códigos de acesso por e-mail · Supabase: tipos de chave de API

Extra implementation exercise

A página aceitou um e-mail e diz “Check your inbox” (verifique sua caixa de entrada). O visitante já está autenticado?

Mostrar uma solução comentada

Não. A solicitação de acesso começou. Verifique o código e examine a sessão resultante antes de mostrar um estado conectado.

  • Mantém separados os estados de solicitação e verificação.
  • Exige uma verificação bem-sucedida e uma sessão.

Etapa 2

Prepare o provedor e a página

Escolha o fluxo de código esperado pelo formulário fornecido.

Antes de testar, peça ao assistente para conferir quatro itens obrigatórios: o projeto Supabase correto, uma caixa permitida pelas configurações do remetente, um modelo de e-mail com código e a página fornecida rodando por HTTP. O modelo deve corresponder à interface de código, em vez de conter apenas um link mágico.

Somente a URL do projeto e a chave publicável pertencem a public/config.js. Mantenha chaves secretas/service-role fora dos arquivos públicos. Essas verificações do provedor e da aplicação são obrigatórias; ler ou reescrever a implementação de autenticação é opcional.

Um exemplo concreto

Um link de e-mail funcional ainda pode ser o percurso errado para uma página que pede que você digite um código.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Configure o provedor e o cliente do navegador

O modelo de e-mail e o tipo de chave precisam corresponder ao fluxo de códigos fornecido.

Em um projeto Supabase separado, ative a autenticação Email. Confira se o remetente consegue entregar à sua caixa de teste; configure um SMTP compatível quando necessário. No modelo de e-mail Magic Link, inclua {{ .Token }} para a mensagem fornecer o código que esta página espera.

Coloque a URL do projeto e a chave publicável em config.js. Essa chave identifica a aplicação; ela não é uma sessão de usuário nem um segredo administrativo. Nunca coloque uma chave secreta ou service-role nesse arquivo de navegador. Sirva public/ por HTTP/HTTPS para as importações de módulos funcionarem.

A página espera um código por e-mail (OTP) digitado. No modelo do provedor, {{ .Token }} gera esse código; um modelo que contém apenas uma variável de link de confirmação não fornece à interface o código solicitado. Use o guia atual de e-mail sem senha para localizar o modelo em vez de adivinhar o nome de uma configuração.

O guia oficial “With OTP” do Supabase explica explicitamente que os códigos por e-mail compartilham a implementação Magic Link: altere o modelo Magic Link para incluir {{ .Token }}. O nome não significa que esta página deva receber uma mensagem contendo apenas um link. Siga o guia se os textos do painel forem diferentes; não invente uma configuração de modelo sem relação.

Exemplo resolvido

O método do SDK se chama signInWithOtp, mas o e-mail pode conter um link ou um código, dependendo do modelo. Nossa interface espera a versão com código.

Extra implementation exercise

Sua página pede um código, mas o e-mail contém apenas um link mágico. O que você deve verificar?

Mostrar uma solução comentada

Confira o valor Token no modelo configurado e repita a solicitação depois de alinhá-lo à interface de códigos. Siga a documentação atual do provedor para seu projeto.

  • Verifica o modelo de e-mail e o fluxo pretendido.
  • Não inventa um código nem afirma que a mensagem foi verificada.

Etapa 3

Conclua um login real

Use a mensagem de e-mail em vez de um código inventado.

Comece sem login em uma nova sessão privada. Peça um código para sua caixa controlada e digite primeiro um incorreto de propósito. Verifique que ele é rejeitado e a página continua informando que não há conta autenticada. Depois peça um código novo, use o valor real do e-mail e confira a conta identificada.

Um código rejeitado não deve criar um login. Se começar já autenticado, um código errado pode deixar a sessão existente intacta; é outra situação e não testa a prevenção de uma sessão nova. Se nenhum e-mail chegar, registre essa etapa exata.

Um exemplo concreto

Uma mensagem simpática de sucesso após um código rejeitado representaria incorretamente o estado da conta.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Solicite e verifique um código

Cada botão corresponde a uma transição diferente de estado.

Leia public/app.js. A primeira ação chama signInWithOtp com o e-mail informado; a segunda chama verifyOtp com esse e-mail e o token recebido. Um resultado bem-sucedido inclui uma sessão.

Use sua própria caixa de entrada e copie exatamente o código atual. Um código errado, expirado ou já usado deve deixar o usuário sem sessão. Não registre códigos nem tokens de acesso em um relatório compartilhado.

Exemplo resolvido

A interface usa textContent para o estado e os textos da conta. Ela não interpreta um endereço de e-mail como HTML.

const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }

Extra implementation exercise

Um código incorreto retorna um erro, mas a aplicação mostra “Signed in” (conectado) mesmo assim. Qual condição precisa mudar?

Mostrar uma solução comentada

Mostre o estado conectado apenas quando a verificação tiver sucesso e existir uma sessão. Não use o clique no botão como prova.

  • Verifica o erro retornado e a sessão.
  • Mantém a falha separada da autenticação bem-sucedida.

Etapa 4

Verifique recarga e saída

Confirme que o estado visível acompanha a sessão real.

Recarregue depois de entrar e confira a conta exibida. Use Sign out e verifique a identidade novamente. Para uma sessão independente, use outro perfil do navegador ou feche todas as janelas privadas antes de abrir uma nova: janelas privadas adicionais podem compartilhar a sessão privada existente.

O projeto inicial mostra o estado da conta; não contém um documento protegido para testar. Se adicionar conteúdo privado depois, um servidor precisa verificar o acesso antes de entregá-lo. Esconder um botão não oferece essa proteção.

Um exemplo concreto

Uma página sem sessão iniciada não deve continuar agindo como a conta anterior só porque uma identificação permaneceu.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Verifique a persistência e a saída

Teste mais do que o primeiro código bem-sucedido.

Depois de entrar, atualize a página e examine o estado da conta. Em seguida saia e atualize novamente. Use uma janela privada para verificar se outro navegador não herda a sessão automaticamente.

Sair limpa a sessão deste cliente; isso não significa que todos os tokens copiados em qualquer lugar param de funcionar instantaneamente. A duração e o comportamento de revogação dos tokens de acesso importam ao criar endpoints protegidos de servidor.

Exemplo resolvido

Uma interface desconectada não deve manter a exibição privada da conta nem anexar automaticamente um token antigo a uma nova solicitação. Endpoints privados ainda precisam de verificação no servidor.

Extra implementation exercise

Esconder o botão Sign in seria suficiente para proteger um documento privado?

Mostrar uma solução comentada

Não. O servidor precisa verificar quem chama antes de retornar conteúdo protegido. A próxima lição sobre páginas privadas implementa esse limite.

  • Separa o estado da interface da autorização do servidor.
  • Exige verificações de acesso na solicitação do documento.

Etapa 5

Registre o percurso completo da conta

Conclua com observações reproduzíveis, não só uma captura de sucesso.

Repita o percurso endereço–e-mail–código após qualquer correção. Salve um registro com dados sensíveis ocultados de login, recarga, saída e uma tentativa relevante com falha.

Se restrições de remetente ou limites da conta bloquearem o teste, relate essa etapa com precisão. Não substitua um código realmente entregue por uma simulação local.

Um exemplo concreto

Um relato útil distingue falta de e-mail, código errado e verificação bem-sucedida.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: verificar o percurso completo da conta

Documente os estados de solicitação, falha, sessão iniciada e sessão encerrada.

Teste um código errado antes de concluir um acesso válido. Confira a atualização, a saída e uma janela privada. Use apenas caixas de entrada que você controla.

Melhore uma mensagem pouco clara sem mudar sua veracidade: um código solicitado está pendente e um erro não é uma sessão bem-sucedida.

Exemplo resolvido

O relatório deve identificar os estados observados sem expor o código recebido, o token bearer ou informações privadas do perfil.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Extra implementation exercise

Complete o percurso da conta e explique o que cada estado observado comprova.

Mostrar uma solução comentada

Configure a URL do projeto e a chave publicável e depois um modelo contendo {{ .Token }} para a mensagem trazer o código esperado pela página. Solicite um código para sua própria caixa de entrada. Um e-mail solicitado não é uma sessão verificada.

Digite um código errado e confirme que nenhuma sessão de usuário é criada. Use um código válido novo, verifique a identidade mostrada, recarregue e observe a sessão. Saia e confirme que a aba não informa mais uma sessão.

Repita em uma janela privada: ela não pode herdar o estado de acesso da primeira. Esconder um botão não tem relação com proteger um documento; o servidor deve verificar a autorização antes de retornar conteúdo privado.

  • Os casos de código errado e sessão encerrada continuam não autenticados.
  • Uma sessão válida persiste conforme a configuração e a saída do cliente é verificada com honestidade.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições