LiçõesComo permitir que usuários enviem imagens

Minilição 14 de 30 · Contas e acesso

Entenda o que a prévia comprova

Para quem é esta lição?

Para quem quer permitir que visitantes enviem imagens. Você pode usar o projeto pronto e um assistente de programação sem escrever políticas de armazenamento ou código de upload.

Um nome de arquivo selecionado, um upload salvo e uma imagem legível são três observações diferentes.

Objetivo desta lição

  • Distinga uma prévia local de um upload armazenado.
  • Teste os arquivos fornecidos que devem ser aceitos e rejeitados.
  • Verifique exclusão apenas pelo proprietário e os limites de outra conta.
Explicação, exemplo resolvido e prática

Antes de começar

Um projeto Supabase de prática separado com duas contas de teste controladas. Os arquivos pequeno, grande demais e não aceito são fornecidos. Peça ao assistente para preparar o armazenamento privado avatars e as políticas fornecidas nesse projeto descartável.

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

    Solicite e use um código real de login.

Tempo estimado: 25–42 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 laboratório aborda armazenamento restrito e propriedade de imagens. Verificações do cliente e configurações MIME não são um processo completo de validação de conteúdo e malware para envios públicos arbitrários.

Entenda a ideia

Abra a aplicação fornecida com o assistente e escolha fixtures/avatar-small.webp. Antes de pressionar Upload image, o controle mostra o nome escolhido. Este exemplo não cria uma prévia local ao selecionar; a imagem aparece só depois de upload e acesso assinado funcionarem.

Outras aplicações podem mostrar uma imagem local sem armazená-la. Aqui também selecionar um nome não comprova upload remoto. Separe seleção, armazenamento no provedor e leitura posterior da imagem.

Um exemplo concreto

Selecionar avatar-small.webp pode mostrar o nome antes de configurar a conta de armazenamento. Para comprovar o armazenamento remoto depois, encontre o objeto no provedor e confira a prévia assinada que o lê.

Use a oficina completa de upload de imagens e meu projeto Supabase descartável. Ajude a configurar login, um bucket avatars privado, o limite declarado de 2 MB e os formatos de imagem permitidos com as políticas fornecidas. Mantenha chaves privadas fora dos arquivos públicos. Execute a página e oriente testes com arquivo pequeno, grande demais e não aceito e verificações de exclusão por contas separadas. Cuide das alterações de código para mim.

Arquivos desta etapa

fixtures/avatar-small.webp
fixtures/avatar-small.webpBaixar este arquivo

Comece aquiArquivos da oficina

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

Experimente

Selecione a imagem pequena fornecida sem enviá-la. O que o controle mostra e quais provas de armazenamento/leitura ainda faltam?

Mostrar uma solução comentada

Observação ilustrativa antes do upload: “Selecionar avatar-small.webp mostrou seu nome no controle. O exemplo ainda não exibiu uma imagem enviada. Não pressionei Upload image nem encontrei um objeto salvo.”

Ainda preciso enviar, localizar o objeto no provedor e verificar sua prévia de curta duração. Outras aplicações podem mostrar a imagem local antes do envio; essa prévia também não comprovaria armazenamento remoto.

O que uma boa resposta inclui

  • Relata o nome selecionado separadamente da imagem retornada depois do upload.
  • Identifica o objeto no provedor e a leitura posterior bem-sucedida como provas ainda necessárias.
Como funciona (opcional)

Armazene a imagem, não apenas uma prévia local

Uma prévia criada de um arquivo selecionado não prova que um serviço de armazenamento o recebeu.

O navegador primeiro mantém o arquivo escolhido. O envio manda os bytes para um serviço de armazenamento de objetos, que atribui um caminho e aplica regras de acesso.

Usaremos um bucket privado Supabase com uma pasta de proprietário por conta. A aplicação envia o arquivo e depois pede uma URL assinada de prévia com curta duração. Ela não torna todo envio publicamente legível.

Exemplo resolvido

Uma prévia local blob: pode funcionar sem solicitação de rede. Nosso teste examinará o objeto real e o obterá por uma rota autorizada.

Exercício técnico complementar

A imagem selecionada aparece instantaneamente por uma URL blob. O envio necessariamente aconteceu?

Mostrar uma solução comentada

Não. Verifique a operação de armazenamento e o objeto correspondente antes de afirmar um envio.

  • Separa prévia local de armazenamento remoto.
  • Verifica o resultado do envio e o objeto armazenado.

Etapa 1 · Como permitir que usuários enviem imagens

Prepare armazenamento privado de teste

Use as configurações fornecidas e um assistente para a preparação.

Explicação, exemplo resolvido e prática

Entenda a ideia

No projeto descartável, peça ao assistente para configurar o bucket avatars privado, limites de tamanho e formato e policies.sql. Inicie o aplicativo completo de login e upload por HTTP.

Confirme que o bucket é privado e a conta e o projeto são os pretendidos. Não remova proteções de armazenamento para fazer uma solicitação com falha ter sucesso.

Um exemplo concreto

A interface do visitante pode ajudar a rejeitar um arquivo, mas o serviço de armazenamento também precisa impor suas próprias regras.

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 configurações de armazenamento foram aplicadas e sua conta de teste consegue abrir o aplicativo em execução?

Mostrar uma solução comentada

Registro ilustrativo de configuração: “O assistente preparou o bucket privado avatars no projeto descartável, definiu os limites de 2 MB e formatos PNG/JPEG/WebP e aplicou as políticas de pasta do dono. A aplicação HTTP abre e A consegue entrar.”

Se o upload falhar antes de concluir essas verificações, registre qual etapa falta. Tornar o bucket público ou remover regras de propriedade não é um atalho válido.

O que uma boa resposta inclui

  • Identifica o projeto descartável, o bucket privado avatars e os limites de formato/tamanho configurados.
  • Registra a aplicação de login/upload em execução e qualquer bloqueio, sem enfraquecer as proteções de armazenamento.
Como funciona (opcional)

Crie um bucket privado e regras de proprietário

A configuração do bucket e as políticas de acesso aplicam partes diferentes da tarefa.

Crie avatars como privado. Configure limite de 2MB e tipos MIME permitidos e aplique policies.sql. Os papéis do navegador só devem inserir e ler caminhos sob seu ID verificado de usuário.

O atributo accept é uma conveniência, não uma verificação de segurança. As regras de tamanho, tipo e propriedade também se aplicam a solicitações diretas. Rótulos MIME sozinhos não provam que conteúdo arbitrário é seguro; não apresente o laboratório como serviço completo de análise.

Para USER_A/avatar-1.webp, storage.foldername(name) retorna os componentes da pasta; [1] seleciona o primeiro neste array PostgreSQL. Ele precisa corresponder ao ID autenticado. USER_B/avatar-1.webp falha para A. Esta regra de armazenamento é diferente do seletor de arquivos e da pré-verificação MIME do navegador.

O primeiro segmento continua sendo o ID mesmo com subpastas: USER_A/subfolder/avatar.webp ainda tem USER_A como componente [1]. Um caminho subfolder/USER_A/... não corresponde. Mantenha o ID primeiro; não afrouxe a política para acomodar um caminho errado.

Exemplo resolvido

O prefixo vem do usuário conectado, enquanto a política o compara com auth.uid(). Trocar o caminho no navegador pela pasta de outra pessoa não deve conceder permissão.

create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);

Supabase: controle de acesso ao armazenamento

Exercício técnico complementar

Por que verificar a extensão só em JavaScript não basta?

Mostrar uma solução comentada

Quem chama pode enviar uma solicitação direta com outros metadados ou caminho. Aplique as regras de bucket e proprietário no limite do serviço.

  • Reconhece que quem chama pode ignorar JavaScript.
  • Exige restrições e autorização no serviço de armazenamento.

Etapa 2 · Como permitir que usuários enviem imagens

Envie a imagem pequena de teste

Verifique o objeto armazenado além da imagem visível.

Explicação, exemplo resolvido e prática

Entenda a ideia

Entre como conta A e envie a imagem pequena fornecida. Encontre seu objeto no provedor e use a prévia resultante ou o caminho de acesso assinado.

Se o armazenamento funcionar mas a prévia falhar, investigue leitura e prévia antes de enviar outra cópia. Guarde a referência registrada do objeto.

Um exemplo concreto

Uma prévia ausente não significa necessariamente que o próprio upload falhou.

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 imagem pequena foi armazenada e pôde ser lida depois?

Mostrar uma solução comentada

Registro ilustrativo de upload: “A enviou avatar-small.webp. O provedor mostrou um objeto na pasta de A; guardei sua referência sem dados sensíveis. A imagem então apareceu pela prévia assinada de curta duração.”

Um resultado parcial poderia dizer: “O objeto existe, mas o acesso à prévia falhou.” Isso pede verificar a leitura/acesso do mesmo objeto, não enviar cópias repetidas sem saber se o armazenamento funcionou.

O que uma boa resposta inclui

  • Relaciona o upload bem-sucedido de A à referência real do objeto armazenado.
  • Registra separadamente se a prévia assinada conseguiu ler esse objeto.
Como funciona (opcional)

Envie para um caminho único do proprietário

Use um nome gerado em vez de confiar no caminho de quem chama ou sobrescrever um arquivo.

Depois de entrar, a aplicação escolhe um caminho com o ID verificado e um nome aleatório. Verifica tamanho e tipo antes de pedir o envio, mas isso não substitui a aplicação das regras pelo provedor.

O envio não ativa upsert. Se armazenar funciona, mas criar a URL assinada falha, a interface informa as duas observações separadamente. Nunca diz “nada enviado” quando o objeto talvez já exista.

Exemplo resolvido

Um nome gerado evita colisões acidentais com outra foto chamada photo.jpg. Ele não é um mecanismo de autorização por si só.

Exercício técnico complementar

O objeto existe, mas criar a prévia falhou. Você deve enviar outra cópia imediatamente?

Mostrar uma solução comentada

Verifique primeiro o caminho e a política de leitura. Reenviar pode criar duplicatas sem corrigir a prévia.

  • Mantém o envio bem-sucedido separado da autorização da prévia.
  • Investiga a política de leitura e o caminho antes de criar duplicatas.

Etapa 3 · Como permitir que usuários enviem imagens

Experimente os casos de falha fornecidos

O exercício inclui arquivos que não devem ser enviados.

Explicação, exemplo resolvido e prática

Entenda a ideia

Use fixtures/avatar-too-large.png e fixtures/not-an-image.txt. Registre como a página e o armazenamento respondem. Peça ao assistente para examinar uma rejeição confusa ou um arquivo inválido que passou.

Arquivos rejeitados não devem se tornar objetos armazenados. Uma URL assinada válida pode permitir ao portador ver uma imagem durante sua validade; isso, por si só, não prova que o bucket se tornou público.

Um exemplo concreto

Uma restrição do seletor de arquivos e a aplicação real de regras no armazenamento são verificações diferentes.

Arquivos desta etapa

fixtures/avatar-small.webp
fixtures/avatar-small.webpBaixar este arquivo

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 aconteceu com os arquivos grande demais e não aceito e qual caminho de acesso você realmente testou?

Mostrar uma solução comentada

Registro ilustrativo de rejeição: “O PNG grande demais foi rejeitado e nenhum objeto novo apareceu. O arquivo de texto também foi rejeitado; o assistente ajudou a testá-lo se o seletor ocultou formatos não aceitos.”

“A URL assinada da imagem permitida abriu durante sua curta validade. Isso mostrou acesso por essa URL, não que o bucket privado se tornou público.” O filtro do seletor, sozinho, não é um teste direto dos limites do provedor.

O que uma boa resposta inclui

  • Registra separadamente a rejeição e o estado do armazenamento para os dois arquivos inválidos fornecidos.
  • Distingue leitura temporária por link assinado de acesso público irrestrito ao bucket.
Como funciona (opcional)

Verifique a rejeição e o acesso temporário

Teste as regras do serviço e entenda o que um link assinado concede.

Envie fixtures/avatar-small.webp com a conta A. Verifique o caminho de armazenamento e abra a prévia assinada autorizada. Depois teste fixtures/avatar-too-large.png, acima de 2MiB, e fixtures/not-an-image.txt, de tipo não permitido: ambos devem ser rejeitados. Os três arquivos são fornecidos.

Use B para pedir um link assinado do caminho de A; a política deve negar. Uma URL emitida legitimamente a A pode ser usada por qualquer pessoa que a obtenha até expirar. Sair da conta não revoga instantaneamente todas as URLs emitidas.

Exemplo resolvido

Um bom relatório registra um caminho sem dados sensíveis e o prazo de expiração, não a URL temporária completa.

Exercício técnico complementar

Alguém abre a imagem sem entrar usando uma URL assinada válida. Isso sozinho prova que a política do bucket privado falhou?

Mostrar uma solução comentada

Não. Teste se uma conta não autorizada consegue criar a URL ou ler sem uma permissão autorizada. Trate os links emitidos como sensíveis até expirarem.

  • Reconhece URLs assinadas como permissões temporárias para quem as possui.
  • Distingue acesso pela URL de permissão para criá-la.

Etapa 4 · Como permitir que usuários enviem imagens

Adicione exclusão apenas pelo proprietário

Verifique quem pode remover o objeto enviado.

Explicação, exemplo resolvido e prática

Entenda a ideia

Peça ao assistente para adicionar o comportamento de exclusão pelo dono fornecido. Como A, exclua o primeiro objeto X e confira que ele sumiu do armazenamento. Depois envie um novo objeto Y como A; guarde sua referência sem dados sensíveis para o próximo teste.

Na sessão separada de B, peça ao assistente para tentar excluir Y diretamente. Registre autor B, alvo Y e resultado no provedor; depois confira que Y de A continua existindo. Ver só um botão oculto, ou tentar excluir X já ausente, não comprova essa fronteira de propriedade.

Um exemplo concreto

Remover uma imagem da tela não é o mesmo que excluir o objeto armazenado.

Arquivos desta etapa

fixtures/avatar-small.webp
fixtures/avatar-small.webpBaixar este arquivo

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 exclusão pelo proprietário e a tentativa da segunda conta com os resultados reais dos objetos.

O que entregar: O resultado de upload e exclusão e as verificações reais de arquivo válido, grande demais, não aceito e entre contas.

Mostrar uma solução comentada

Registro ilustrativo de exclusão: “A excluiu X e o provedor confirmou sua ausência. A enviou então Y novo. A sessão separada de B tentou excluir Y; A conferiu que Y continuava lá.”

O assistente deve identificar autor B e alvo Y antes do teste isolado. Tentar excluir X outra vez testaria um objeto já ausente, não a proteção de exclusão exclusiva do dono.

O que uma boa resposta inclui

  • Exclui o primeiro objeto de A como dono e verifica que esse objeto exato foi removido.
  • Envia um novo objeto de A, tenta atingi-lo como B e verifica que continua armazenado.
Como funciona (opcional)

Sua tarefa: acrescentar exclusão apenas pelo proprietário

Uma operação nova precisa de sua própria política e testes negativos.

Acrescente um controle de exclusão do objeto e uma política DELETE restrita à pasta do proprietário. Não transforme o bucket em uma área pública compartilhada.

Verifique se A consegue remover o objeto de A e B não. Mantenha o estado do armazenamento consistente com a interface depois de uma falha ao excluir.

Exemplo resolvido

As políticas originais permitem apenas inserção e leitura de propósito. Exclusão não é autorizada automaticamente pela permissão de envio.

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

Implemente exclusão exclusiva do proprietário e demonstre tentativas permitidas e proibidas.

Mostrar uma solução comentada

Use um bucket avatars privado com configurações de tamanho e tipo aplicadas no armazenamento e políticas para as pastas de cada proprietário. Envie uma imagem permitida com a conta A; examine o resultado retornado pelo armazenamento e depois abra a prévia por uma URL assinada de curta duração. Uma prévia blob, sozinha, não comprova que houve envio ao serviço remoto.

Tente arquivo não aceito ou grande demais e tente enviar ou ler sob a pasta de B. A não deve ganhar acesso apenas mudando um caminho nas ferramentas. URLs assinadas concedem acesso temporário intencionalmente até expirar.

Para excluir, acrescente DELETE com a mesma condição de bucket e pasta e chame remove com o caminho exato armazenado. Verifique se o objeto está ausente depois e se uma exclusão entre proprietários deixa o objeto alheio intacto. O módulo de referência é separado para você examinar caminho e política antes de integrar.

  • A permissão de exclusão verifica o bucket e a pasta do proprietário verificado.
  • Tentativas que falham não removem o objeto de outra conta nem limpam falsamente a interface.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.