
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.
- 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.