LiçõesComo permitir que as pessoas entrem no seu site

Minilição 11 de 30 · Contas e acesso

Entenda o percurso de login

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.

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

Objetivo desta lição

  • 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.
Explicação, exemplo resolvido e prática

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.

Confira os conhecimentos iniciais

São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.

  1. Como publicar seu site pelo GitHub

    Conecte um repositório de prática à hospedagem.

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.

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Quais estados visíveis você verificará entre a entrada do endereço e o login real?

Mostrar uma solução comentada

Resposta ilustrativa: “Depois de Send sign-in code, espero uma mensagem de solicitação aceita. Em seguida preciso encontrar o e-mail. Só depois de Verify code funcionar a página deve identificar minha conta autenticada.”

“Check your inbox” é uma mensagem da etapa de solicitação. Ela não comprova que o e-mail chegou nem que existe uma sessão.

O que uma boa resposta inclui

  • Distingue pedir uma mensagem, receber seu código e verificar o login.
  • Identifica a exibição da conta verificada, não a digitação do endereço, como prova de sessão.
Como funciona (opcional)

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

Exercício técnico complementar

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 1 · Como permitir que as pessoas entrem no seu site

Prepare o provedor e a página

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

A configuração do provedor e a mensagem recebida corresponderam ao formulário de código?

Mostrar uma solução comentada

Registro ilustrativo de configuração: “O projeto de prática está selecionado; o modelo de e-mail inclui o código; public/config.js tem somente a URL e a chave publicável; a página abre por HTTP local.”

Um registro bloqueado poderia dizer: “A página abre, mas o e-mail contém só um link. O teste de código está bloqueado até o assistente ajudar a corrigir o modelo.” Nenhum registro inclui chave ou código reutilizável.

O que uma boa resposta inclui

  • Identifica o projeto de prática, o modelo de e-mail com código e a visualização HTTP pronta.
  • Distingue configurações públicas do projeto de chaves secretas e informa qualquer bloqueio.
Como funciona (opcional)

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.

Exercício técnico complementar

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 2 · Como permitir que as pessoas entrem no seu site

Conclua um login real

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Em uma nova sessão sem login, o que aconteceu com um código incorreto e depois com um código real recém-recebido?

Mostrar uma solução comentada

Registro ilustrativo de teste: “Em uma nova sessão privada, o código incorreto mostrou Code was not accepted e a página continuou com No signed-in account. Depois pedi um código novo por e-mail, verifiquei e vi minha conta controlada identificada.”

Se o e-mail nunca chegar, um registro válido é “Solicitação aceita; nenhum código na caixa permitida ou no spam; verificação bem-sucedida não testada”. Um teste de código errado já autenticado não comprova que uma nova sessão foi impedida.

O que uma boa resposta inclui

  • Testa um código incorreto sem sessão autenticada e registra que o login não foi criado.
  • Usa depois um código real novo e verifica a identidade da conta resultante.
Como funciona (opcional)

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 */ }

Exercício técnico complementar

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 3 · Como permitir que as pessoas entrem no seu site

Verifique recarga e saída

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Qual estado da conta apareceu após recarregar, após sair e em uma nova sessão privada?

Mostrar uma solução comentada

Registro ilustrativo de sessão: “Recarregar ainda identificou a conta A. Sign out mudou a identidade para No signed-in account. Outro perfil do navegador também não mostrou nenhuma conta.”

Este exemplo demonstra estado de conta, não um documento privado. Se a sessão continuar após sair, registre a falha; o acesso a conteúdo privado é assunto da aula private-page.

O que uma boa resposta inclui

  • Registra o estado da conta depois de recarregar e depois da ação de sair.
  • Verifica outro perfil do navegador ou uma sessão privada realmente nova, sem presumir que outra janela é independente.
Como funciona (opcional)

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.

Exercício técnico complementar

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 4 · Como permitir que as pessoas entrem no seu site

Registre o percurso completo da conta

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Apresente suas verificações do percurso da conta e tudo que continua bloqueado.

O que entregar: Um breve registro do percurso da conta cobrindo chegada real do código, login, recarga, saída e uma tentativa com falha.

Mostrar uma solução comentada

Registro ilustrativo completo: “A caixa controlada recebeu um código; o incorreto sem login foi rejeitado; um válido novo identificou A; recarregar manteve A; sair limpou a identidade; um perfil independente do navegador não tinha sessão.”

Registro ilustrativo incompleto: “A solicitação de código falhou pelas restrições de remetente do provedor. Recebimento e verificação não foram testados; próximo passo: conferir destinatário permitido e remetente.” Um fluxo bloqueado deve continuar incompleto, não ser substituído por um login local de faz de conta.

O que uma boa resposta inclui

  • Apresenta em ordem as observações de solicitação, e-mail, código errado, código válido, recarga e saída.
  • Aponta qualquer etapa de e-mail/provedor ausente e não inclui códigos ou tokens no registro.
Como funciona (opcional)

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.

Exercício técnico complementar

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.