Supabase Storage: arquivos privados, URLs assinadas e upsert
Por Mauro Mequelussi · Curso gratuito Supabase sem mistério: banco, auth e RLS · Português (PT-BR)
Resposta direta · O que esta aula resolve
A Aula 5 de 15 ("Supabase Storage: arquivos privados, URLs assinadas e upsert"), parte do módulo "Produtos" do curso gratuito "Supabase sem mistério: banco, auth e RLS" na Escola de Aplicativos (ministrado por Mauro Mequelussi), ensina na prática: o aluno vai entender como o Supabase Storage organiza arquivos em buckets e quais são as diferenças cruciais entre acesso público e privado. Veja como compartilhar documentos confidenciais por tempo limitado via URLs assinadas e aprenda a configurar regras de RLS para upload. Descubra também como evitar a clássica armadilha do upsert ao substituir arquivos.
Crie sua conta grátis para assistir a esta videoaula em HD
O resumo técnico e os capítulos abaixo são abertos para consulta. Crie sua conta 100% gratuita em segundos para liberar todas as 15 videoaulas em HD, controle automático de progresso, Tutor IA e certificado gratuito verificável.
- R$ 0 · Sem cartão de crédito
- Tutor IA tira-dúvidas da aula
- Certificado gratuito incluso
O que você vai aprender
- A diferença estrutural entre buckets públicos e buckets privados.
- Como gerar URLs assinadas para liberar o download temporário de documentos.
- Como aplicar regras de segurança com RLS na tabela storage.objects.
- A armadilha das permissões do upsert ao atualizar ou substituir arquivos existentes.
- Os limites de armazenamento e transferência disponíveis no plano gratuito do Supabase.
Pontos-chave da aula
- Buckets nascem privados por padrão; apenas use buckets públicos para arquivos que qualquer pessoa pode ver.
- A URL assinada expira automaticamente, mas não pode ser cancelada antes do prazo sem acionar o suporte.
- Substituir um arquivo com o mesmo nome exige três permissões distintas: INSERT, SELECT e UPDATE.
- Apagar registros diretamente pelo SQL não remove os arquivos físicos do Storage.
- O plano grátis oferece 1 GB de armazenamento e arquivos de até 50 MB cada.
Capítulos e roteiro técnico da aula
12 capítulos minutados- 00:00
O risco de expor arquivos confidenciais
O dilema de compartilhar propostas em PDF e como a configuração do bucket define se terceiros conseguem abrir o arquivo.
- 00:21
Analogia dos armários: vitrine e cofre
Uma metáfora simples para entender a diferença entre buckets públicos para catálogos e cofres privados com acesso restrito.
- 00:38
O que são buckets no Supabase Storage
Apresentação da área de Storage no painel, separação entre dados e arquivos, além das configurações básicas de cada bucket.
- 01:01
Diferenças entre buckets públicos e privados
Como funciona a leitura em buckets públicos, o cache mais rápido e as duas formas de acessar buckets privados com JWT ou URLs assinadas.
- 01:39
Aplicação prática: foto de perfil versus proposta
Definição do uso de bucket público para imagens do vendedor e bucket privado com link temporário para documentos em PDF.
- 02:09
Políticas de acesso com RLS em storage.objects
Entenda por que uploads são bloqueados por padrão e como restringir pastas isoladas por usuário usando regras de RLS.
- 02:35
A armadilha do upsert ao substituir arquivos
Por que reenviar um arquivo existente exige permissões de INSERT, SELECT e UPDATE, evitando erros silenciosos no app.
- 03:06
Cuidados com exclusão e backups no Storage
A importância de deletar arquivos via API do Storage e o alerta de que o backup do banco de dados não salva arquivos enviados.
- 03:23
Quando não usar URLs públicas ou assinadas
Critérios para saber quando um arquivo jamais deve ser público e por que links assinados não servem para revogação imediata.
- 03:37
Alternativas do mercado e compatibilidade S3
Comparativo do Supabase Storage com Cloudflare R2, Amazon S3 e UploadThing, destacando a compatibilidade com a API S3.
- 03:57
Limites e custos do plano gratuito
Os limites de armazenamento, tamanho máximo por arquivo e cota mensal de transferência de saída no plano grátis.
- 04:10
Conclusão do caso e introdução a Edge Functions
A resposta final sobre o vazamento da proposta e uma prévia da próxima aula sobre automações e segurança de chaves de IA.
Momentos de destaque na prática
Bucket público vs. privado e URLs assinadas
Entenda como entregar documentos confidenciais com links que expiram sozinhos em vez de expor arquivos na vitrine pública.
A pegadinha do upsert ao substituir arquivos
Substituir um arquivo no Supabase falha sem erro aparente? Descubra as três permissões que você precisa liberar.
Cuidados essenciais com exclusão e backups
Apagar dados no SQL não deleta arquivos do Storage: entenda como evitar arquivos órfãos e perdas no app.
Notas de aula e guia de estudo
Arquivos como fotos de catálogo e documentos sigilosos exigem tratamentos completamente diferentes na nuvem. Nesta aula, você descobre como usar o Supabase Storage para armazenar arquivos com segurança, separando o que pode ser público do que precisa de proteção rigorosa. Você também vai dominar o envio de links com prazo de validade e desvendar os erros mais comuns de permissão.
O que você vai aprender
- A diferença estrutural entre buckets públicos e buckets privados.
- Como gerar URLs assinadas para liberar o download temporário de documentos.
- Como aplicar regras de segurança com RLS na tabela storage.objects.
- A armadilha das permissões do upsert ao atualizar ou substituir arquivos existentes.
- Os limites de armazenamento e transferência disponíveis no plano gratuito do Supabase.
Pontos-chave
- Buckets nascem privados por padrão; apenas use buckets públicos para arquivos que qualquer pessoa pode ver.
- A URL assinada expira automaticamente, mas não pode ser cancelada antes do prazo sem acionar o suporte.
- Substituir um arquivo com o mesmo nome exige três permissões distintas: INSERT, SELECT e UPDATE.
- Apagar registros diretamente pelo SQL não remove os arquivos físicos do Storage.
- O plano grátis oferece 1 GB de armazenamento e arquivos de até 50 MB cada.