
Minilição · Português
Como manter uma página privada
Use um projeto de login pronto para manter uma nota de prática privada e teste tanto acesso permitido quanto negado.
Para quem é esta lição?
Para quem quer disponibilizar uma página ou nota só após o login. Um assistente de programação pode conectar a proteção fornecida; programação de servidor não é a exigência de aprendizagem.
Antes de começar
A configuração de login fornecida ou acesso Supabase equivalente, um projeto separado de hospedagem de funções e um assistente de programação. Use uma PRIVATE_NOTE fictícia mantida apenas no ambiente do servidor, nunca conteúdo privado real.
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. Este exemplo permite todos os usuários válidos do projeto de prática. Registros por usuário e papéis exigem regras adicionais de autorização.
O que você vai aprender
- Mantenha conteúdo privado fora da página pública.
- Teste o mesmo caminho sem e com sessão iniciada.
- Verifique uma falha de acesso sem revelar a nota.
Etapa 1
Escolha o que precisa de proteção
Privado significa indisponível para um visitante não autorizado, não apenas oculto.
Use a nota fictícia fornecida e o projeto pronto. Peça ao assistente para manter a nota no servidor em vez de dentro da página pública baixada.
Um visitante pode examinar arquivos públicos mesmo quando um elemento está oculto. Não coloque informações privadas reais no exercício.
Um exemplo concreto
Um parágrafo escondido pelo estilo da página ainda faz parte do arquivo público.
Use esta oficina completa de nota privada e meu projeto de prática de login gerenciado. Mantenha PRIVATE_NOTE apenas no ambiente privado do servidor e preserve as verificações de acesso fornecidas. Ajude a executar o aplicativo e depois compare acesso direto sem sessão iniciada com login verificado. Não trate esconder um parágrafo como proteção nem exponha dados de outra pessoa.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)
Proteja a resposta, não apenas o botão
O conteúdo privado não deve ser enviado a um navegador não autorizado desde o início.
Esconder por CSS e desativar botões mudam a interface, não a resposta. Qualquer pessoa pode examinar arquivos públicos e fazer uma solicitação direta a um endpoint.
Nosso servidor lê uma anotação do ambiente e a retorna apenas depois de verificar um token de usuário. A anotação fictícia serve para o laboratório; dados privados reais pertencem a uma fonte protegida, não a um repositório público.
Exemplo resolvido
Um arquivo JavaScript público com uma anotação “escondida” continua sendo uma cópia pública. O exemplo mantém o valor fora de public/.
Extra implementation exercise
A página esconde um parágrafo até o acesso, mas ele está no HTML de origem. Ele é privado?
Mostrar uma solução comentada
Não. Controle a resposta do servidor antes de enviar o conteúdo. Esconder um valor recebido não pode torná-lo secreto.
- Reconhece que o navegador já o recebeu.
- Coloca o controle de acesso antes da resposta protegida.
Erro comum
Equiparar um elemento DOM oculto a uma autorização.
Etapa 2
Conecte a proteção pronta
Deixe o assistente configurar as verificações existentes no servidor.
Siga run-locally.txt com o assistente. Antes de testar, confirme o projeto de autenticação, os valores públicos no navegador, as configurações privadas do servidor e a PRIVATE_NOTE fictícia. Inicie o projeto completo e abra a URL real do proxy; uma visualização de arquivo não executa essa proteção.
As verificações de conta/servidor são obrigatórias. Ler a implementação da função é opcional. O serviço deve verificar a sessão antes de retornar a nota; alguém digitar o ID de outra conta na solicitação não é prova de identidade.
Um exemplo concreto
Uma identidade informada pelo usuário não é o mesmo que uma sessão de conta confirmada.
Supabase: obter um usuário verificado · Node.js: estado de suporte das versões
Experimente
Qual etapa de configuração está concluída e que URL real do aplicativo você pode testar?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro ilustrativo de preparação: “A aplicação fornecida roda na URL do proxy exibida pelo servidor. O projeto de autenticação de prática e a nota fictícia estão configurados. A nota não está nos arquivos públicos.”
Um registro bloqueado poderia dizer: “A página abre, mas o servidor mostra Auth not configured; o assistente precisa conferir o ambiente privado antes do teste de acesso.” Abrir a página, sozinho, não comprova proteção do servidor.
- Identifica o endereço da aplicação em execução e as configurações concluídas de servidor/provedor.
- Relata um bloqueio concreto sem publicar a nota privada nem credenciais.
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)
Envie um token de sessão ao servidor
O cliente fornece um token bearer; o servidor verifica de forma independente.
Configure os arquivos de acesso e o ambiente do servidor conforme START-HERE.txt. O cliente obtém sua sessão atual e envia o token de acesso no cabeçalho Authorization ao solicitar o endpoint privado.
O servidor chama o endpoint de usuário do provedor com esse token e a chave publicável de aplicação do projeto. Rejeita tokens ausentes ou inválidos e diferencia uma indisponibilidade do provedor de uma identidade aceita. Decodificar um token sem verificar não basta.
Acompanhe a solicitação em ordem: o navegador envia seu token de usuário → o servidor pergunta ao provedor de identidade se o token representa um usuário → apenas um resultado verificado permite retornar a anotação. A chave publicável identifica a aplicação; sozinha, não identifica nem autoriza a pessoa.
Para a sequência local completa, abra run-locally.txt: prepare o ambiente privado da raiz, vincule apenas o projeto de prática e inicie o proxy de funções do Netlify. server-env.example.txt lista nomes de variáveis sem segredos reais. Abrir apenas o HTML não executa o servidor.
Exemplo resolvido
Um campo userId fornecido por quem chama não prova que a pessoa possui esse ID. Use a identidade retornada pela verificação.
const r=await fetch('/.netlify/functions/mini-private-note', {
headers:{Authorization:'Bearer '+session.access_token}
});Supabase: obter um usuário verificado · Node.js: estado de suporte das versões
Extra implementation exercise
O servidor poderia autorizar uma solicitação confiando no userId do JSON do navegador?
Mostrar uma solução comentada
Não. O navegador pode alterar esse campo. Verifique a credencial e use a identidade verificada.
- Trata declarações de identidade do cliente como não confiáveis.
- Usa um token verificado e a identidade resultante.
Erro comum
Verificar apenas se existe um texto de token.
Etapa 3
Teste o público permitido
Decida quem deve poder ler este item específico.
Entre com sua conta de teste controlada e solicite a nota fictícia. Neste laboratório, a regra permite qualquer usuário com login verificado; peça ao assistente para preservar esse escopo declarado.
Se depois você armazenar dados da conta de uma pessoa, essa regra mais ampla não basta. Declare o público em vez de presumir que todos os dados privados têm permissões idênticas.
Um exemplo concreto
Uma nota compartilhada de membros e um registro individual de conta precisam de decisões de acesso diferentes.
Experimente
Quem pode ler sua nota de prática e a solicitação com sessão iniciada correspondeu a essa regra?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro ilustrativo de acesso: “A conta A foi verificada e recebeu a nota fictícia dos membros. A regra permite qualquer usuário autenticado e verificado, então outro membro de teste verificado também pertence ao público permitido.”
Essa é uma regra para conteúdo compartilhado entre membros. Não basta para o perfil pessoal de A, que precisa ficar restrito a A; essa outra fronteira exige teste de propriedade.
- Informa que o laboratório permite qualquer usuário autenticado e verificado, não só o dono de uma nota.
- Registra o resultado da conta permitida sem estender essa regra a dados pessoais de conta.
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)
Retorne apenas os dados protegidos pretendidos
Uma identidade válida não concede acesso automaticamente aos registros de todos os usuários.
Este pequeno exemplo concede a todos os usuários válidos do projeto acesso a uma anotação compartilhada. É uma regra explícita de autorização, não uma definição universal de conteúdo privado.
A resposta usa private, no-store para que um cache compartilhado não retenha a anotação. Uma lição posterior de perfil usa regras de propriedade para registros por usuário. Não amplie este manipulador para um dump global do banco.
Exemplo resolvido
O viewerId do servidor deriva da verificação. A anotação vem do ambiente, não de dados fornecidos na solicitação.
Extra implementation exercise
Se a anotação fosse substituída pelos dados de conta de outra pessoa, “qualquer usuário conectado” continuaria sendo uma regra adequada?
Mostrar uma solução comentada
Não. Acrescente uma regra que relacione a identidade autenticada ao registro solicitado ou papel. Entrar na conta, por si só, não concede acesso a outra conta.
- Distingue autenticação de autorização por registro.
- Exige propriedade ou um papel adequado para dados individuais.
Erro comum
Usar uma regra compartilhada de página privada para registros individuais sensíveis.
Etapa 4
Experimente o mesmo caminho sem sessão iniciada
Uma solicitação direta importa tanto quanto o botão normal.
Use um perfil realmente sem login ou saia e confira o estado da conta; depois peça ao assistente para solicitar a mesma nota diretamente. Uma janela privada extra pode compartilhar uma sessão privada existente. Repita com login verificado.
O resultado sem sessão iniciada não deve conter a nota; a sessão permitida deve recebê-la. Uma falha de solicitação deve continuar sendo erro sem vazar conteúdo.
Um exemplo concreto
Remover um link do menu não protege o endereço que ele abria.
Experimente
O que as tentativas diretas sem e com sessão iniciada retornaram, cada uma?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro ilustrativo de solicitação direta: “Sem login: a rota devolveu Sign in required e nenhuma nota. Autenticado como A: a mesma rota retornou a nota fictícia. O assistente ajudou a inspecionar essas respostas sem compartilhar tokens.”
Se a resposta sem login contém a nota, a proteção falhou mesmo que a página a esconda. Se o serviço de autenticação estiver indisponível, registre essa falha separadamente de uma solicitação normalmente negada.
- Compara a mesma rota de nota em uma solicitação sem login e outra autenticada e permitida.
- Verifica que respostas negadas ou com erro não contêm o texto privado.
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)
Experimente o endpoint sem a interface
Um teste real de acesso se dirige diretamente à solicitação de dados.
Solicite a URL da função em uma nova janela sem cabeçalho Authorization; ela não deve retornar a anotação. Tente um token bearer malformado e depois use a interface conectada para fazer uma solicitação autorizada.
Saia e verifique se a aplicação limpa a anotação exibida e não envia novamente um token. Um token emitido anteriormente pode continuar válido até a expiração configurada; revogação global imediata é um requisito separado.
Exemplo resolvido
Uma solicitação direta negada demonstra mais do que a captura de um botão de acesso. Guarde no registro o status da resposta e se o texto protegido estava presente.
Extra implementation exercise
Uma solicitação direta retorna 401 sem anotação, enquanto uma sessão verificada a recebe. Que limite você testou?
Mostrar uma solução comentada
Você testou que este endpoint verifica a identidade antes de retornar a anotação compartilhada. Outros endpoints e regras de propriedade precisam dos próprios testes.
- Identifica o limite da resposta do servidor.
- Não afirma revogação universal de tokens nem autorização individual além do exemplo.
Erro comum
Testar apenas o caminho bem-sucedido pelos botões do navegador.
Etapa 5
Proteja mais um valor de teste
Repita as mesmas verificações após uma pequena alteração.
Peça ao assistente para adicionar um segundo valor fictício exclusivo do servidor usando a mesma regra de público pretendida. Não mova nenhum dos valores para arquivos públicos por conveniência.
Repita observações de acesso permitido, negado e falha. Oculte dados sensíveis na entrega e identifique qualquer teste não realizado.
Um exemplo concreto
Adicionar outro campo não deve tornar pública, por acidente, a nota privada original.
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 a proteção do novo valor e os resultados observados de acesso.
O que entregar O caminho de prática funcional e as verificações observadas de acesso sem sessão, com sessão e com erro.
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro ilustrativo de extensão: “Adicionei um local fictício de reunião ao lado da nota original. Um membro verificado recebeu os dois; a solicitação direta sem login não recebeu nenhum. Com a autenticação deliberadamente indisponível no projeto descartável, a resposta continuou sendo erro e não continha nenhum valor.”
A entrega pode identificar os dois campos e esses resultados sem reproduzir seu conteúdo. Se um caso de falha não foi executado, marque-o assim, em vez de usar um teste autenticado como prova de todas as fronteiras.
- Mantém os dois valores fictícios só no servidor, sob a regra de membros informada.
- Repete respostas permitidas, negadas e de falha do serviço para o valor adicionado.
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: acrescentar um segundo valor protegido
Mantenha o novo valor fora dos arquivos públicos e aplique as mesmas verificações de servidor.
Acrescente outro valor de prática no ambiente do servidor, retorne apenas após a verificação e exiba com segurança como texto. Mantenha a resposta sem armazenamento em cache.
Repita os testes de token ausente, token inválido e sessão válida. Pesquise nas fontes públicas para confirmar que nenhum valor privado foi incorporado ali.
Exemplo resolvido
A tarefa amplia a resposta protegida, não a quantidade de dados enviada antes do acesso.
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
Proteja um segundo valor e forneça evidências positivas e negativas de acesso.
Mostrar uma solução comentada
Chame diretamente o endpoint private-note sem cabeçalho Authorization: espere 401 e nenhuma anotação. Um token bearer inventado também precisa falhar. O userId do navegador ou um botão oculto não satisfaz a verificação de identidade do servidor.
Com seu token real de sessão verificada no seu projeto de prática, espere a anotação configurada e Cache-Control: private, no-store. Mantenha a anotação fora do HTML e JavaScript públicos. Não cole um token bearer real em um relatório compartilhado.
Após sair, a interface deve limpar o conteúdo privado e parar de fazer solicitações autenticadas. Um token já copiado pode continuar utilizável até expirar: o comportamento de saída da interface não garante revogação instantânea. Este laboratório compartilhado autoriza usuários conectados; a propriedade individual é o exercício separado de perfil.
- Os dois valores permanecem no servidor até a autorização ter sucesso.
- Solicitações diretas não autorizadas não contêm nenhum valor; acesso válido e comportamento no-store são verificados.
Erro comum
Acrescentar o segundo valor como uma constante do navegador por conveniência.
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 permitir que as pessoas entrem no seu site
- 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