
Minilição 12 de 30 · Contas e acesso
Escolha o que precisa de proteção
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.
Privado significa indisponível para um visitante não autorizado, não apenas oculto.
Objetivo desta lição
- 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.
Explicação, exemplo resolvido e prática
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.
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 permitir que as pessoas entrem no seu site
Solicite e use um código real de login.
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.
Entenda a ideia
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
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Que nota você está testando e como verificará que visitantes sem sessão iniciada não conseguem obtê-la?
Mostrar uma solução comentada
Plano ilustrativo: “Minha nota fictícia é um lembrete de reunião de prática. Qualquer usuário de teste autenticado e verificado pode lê-la neste laboratório. Vou solicitar a mesma nota em uma sessão separada sem login e conferir que a resposta não contém a nota.”
A nota deve ficar fora dos arquivos públicos. Ocultar um parágrafo visualmente não impede que o visitante leia o código que baixou.
O que uma boa resposta inclui
- Usa uma nota fictícia apenas no servidor e informa o público autenticado permitido no exercício.
- Planeja uma solicitação direta sem login, em vez de confiar em elemento oculto da página.
Como funciona (opcional)
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/.
Exercício técnico complementar
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.

Etapa 1 · Como manter uma página privada
Conecte a proteção pronta
Deixe o assistente configurar as verificações existentes no servidor.
Explicação, exemplo resolvido e prática
Entenda a ideia
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.
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 etapa de configuração está concluída e que URL real do aplicativo você pode testar?
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.
O que uma boa resposta inclui
- 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.
Como funciona (opcional)
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
Exercício técnico complementar
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.

Etapa 2 · Como manter uma página privada
Teste o público permitido
Decida quem deve poder ler este item específico.
Explicação, exemplo resolvido e prática
Entenda a ideia
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.
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
Quem pode ler sua nota de prática e a solicitação com sessão iniciada correspondeu a essa regra?
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.
O que uma boa resposta inclui
- 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.
Como funciona (opcional)
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.
Exercício técnico complementar
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.

Etapa 3 · Como manter uma página privada
Experimente o mesmo caminho sem sessão iniciada
Uma solicitação direta importa tanto quanto o botão normal.
Explicação, exemplo resolvido e prática
Entenda a ideia
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.
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
O que as tentativas diretas sem e com sessão iniciada retornaram, cada uma?
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.
O que uma boa resposta inclui
- 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.
Como funciona (opcional)
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.
Exercício técnico complementar
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.

Etapa 4 · Como manter uma página privada
Proteja mais um valor de teste
Repita as mesmas verificações após uma pequena alteração.
Explicação, exemplo resolvido e prática
Entenda a ideia
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.
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 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.
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.
O que uma boa resposta inclui
- 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.
Como funciona (opcional)
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.
Exercício técnico complementar
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.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.