
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.
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.
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
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.
Erro comum
Tratar um campo de e-mail ou um nome armazenado como prova de identidade.
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.
Experimente
A configuração do provedor e a mensagem recebida corresponderam ao formulário de código?
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Usar uma chave privilegiada de servidor porque parece fazer mais solicitações funcionarem.
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.
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?
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Reutilizar uma mensagem de sucesso de uma solicitação anterior depois de uma verificação que falhou.
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.
Experimente
Qual estado da conta apareceu após recarregar, após sair e em uma nova sessão privada?
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Supor que regras de visibilidade no cliente protegem os dados por trás da interface.
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.
Experimente
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
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.
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Entregar uma captura de tela com um token de sessão reutilizável.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar