Minilição · Português

Como permitir que usuários enviem imagens

Envie, reabra e exclua as imagens de teste fornecidas verificando limites de tamanho e propriedade da conta.

Começar a aula interativaLer as notas da aula

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.

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.

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.

O que você vai aprender

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

Arquivos da oficina

Etapa 1

Entenda o que a prévia comprova

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

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 2

Prepare armazenamento privado de teste

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

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.

Supabase: controle de acesso ao armazenamento

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 3

Envie a imagem pequena de teste

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

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 4

Experimente os casos de falha fornecidos

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

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

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 5

Adicione exclusão apenas pelo proprietário

Verifique quem pode remover o objeto enviado.

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

Start hereArquivos da oficina

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

Extra implementation exercise

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.

Continue aprendendo

Explore as outras lições