Segurança de uploads de arquivo: como não abrir a porta para o atacante
Upload de arquivo é vetor clássico de ataque. Veja como validar tipo, tamanho e conteúdo, isolar o armazenamento e servir arquivos com segurança.
Neste artigo
Permitir que usuários enviem arquivos parece uma funcionalidade banal: uma foto de perfil, um anexo, um documento. Mas poucos recursos concentram tantos vetores de ataque quanto o upload. Ao aceitar um arquivo, você está permitindo que um estranho coloque conteúdo arbitrário dentro da sua infraestrutura, e a partir daí uma cadeia de decisões erradas pode transformar essa cortesia numa porta de entrada para comprometimento total. Upload mal feito já rendeu execução de código no servidor, roubo de sessões, negação de serviço e distribuição de malware através de sistemas legítimos.
Este texto trata de como aceitar arquivos sem abrir essa porta. A ideia geral é tratar todo arquivo enviado como potencialmente hostil, do primeiro byte até o momento em que ele é servido de volta, e aplicar validação, isolamento e cuidado em cada etapa. Nenhuma medida isolada basta; é a combinação que segura o ataque.
Por que upload é tão perigoso
Vale entender a variedade de estragos possíveis, porque cada um pede uma defesa. O pior de todos é o upload que vira código executável no servidor. Se um atacante consegue enviar um arquivo de script e depois fazer o servidor executá-lo, ele obtém uma webshell, um ponto de controle remoto dentro da sua máquina. Isso acontece quando o arquivo enviado cai numa pasta de onde o servidor executa código e o atacante consegue acessá-lo pela web.
Há também o path traversal, em que o atacante manipula o nome do arquivo para escapar da pasta de destino e sobrescrever arquivos importantes do sistema, usando sequências que sobem de diretório. Existe o cross-site scripting via arquivo: um SVG ou um HTML enviado como imagem pode conter script que executa no navegador de quem abrir, especialmente se servido do mesmo domínio da aplicação. Existe a bomba de descompressão, um arquivo pequeno que ao ser expandido consome toda a memória e o disco, uma negação de serviço. E existe o uso do seu sistema como distribuidor de malware, hospedando arquivos maliciosos que ganham a legitimidade do seu domínio. Cada um desses ataques explora uma suposição ingênua sobre o arquivo recebido.
Nunca confie na extensão nem no tipo declarado
O primeiro instinto de muitos desenvolvedores é olhar a extensão do arquivo ou o tipo de conteúdo que o cliente declara. Ambos são controlados pelo cliente e, portanto, mentíveis. Um atacante renomeia um script para terminar em uma extensão de imagem, ou declara um tipo de conteúdo inofensivo enquanto envia bytes maliciosos. A extensão e o cabeçalho de tipo não são evidência de nada; são apenas afirmações de quem enviou.
A validação confiável olha o conteúdo real do arquivo. Os primeiros bytes de muitos formatos contêm uma assinatura característica, os chamados números mágicos, que identificam o tipo verdadeiro. Verificar essa assinatura, e idealmente validar que o arquivo é de fato um exemplar bem formado do tipo esperado, é muito mais forte do que confiar na extensão. Mesmo assim, tratar o número mágico como prova absoluta também tem limites, porque alguns formatos permitem conteúdo poliglota, então combine a checagem de conteúdo com o reprocessamento que veremos adiante.
Use uma allowlist restrita de tipos
Decida explicitamente quais tipos de arquivo a funcionalidade aceita e recuse todo o resto. Uma foto de perfil precisa aceitar alguns formatos de imagem e nada mais; não há razão para permitir arquivos executáveis, scripts ou formatos exóticos. Allowlist é sempre mais segura do que blocklist: em vez de tentar enumerar tudo o que é perigoso, uma lista sempre incompleta, você enumera o pequeno conjunto do que é seguro para aquele caso e nega o universo restante. Quanto mais estreita a allowlist, menor a superfície de ataque.
Limite tamanho e taxa
Todo endpoint de upload precisa impor um limite de tamanho, tanto por arquivo quanto no total, recusando o que exceder antes de consumir recursos. Sem isso, um atacante envia arquivos gigantescos e esgota disco, memória e banda, uma negação de serviço trivial de executar. Some limites de taxa, restringindo quantos uploads um mesmo cliente pode fazer num intervalo, para impedir que alguém inunde o sistema com muitos arquivos pequenos. Esses limites são a mesma disciplina de contenção de recursos que protege qualquer entrada da aplicação.
Gere o nome do arquivo no servidor
O nome do arquivo enviado pelo cliente é dado hostil e nunca deve ser usado diretamente para gravar em disco. É por ele que entra o path traversal, com sequências que sobem de diretório para escrever fora da pasta pretendida, e também colisões e caracteres problemáticos. A defesa é ignorar o nome original para fins de armazenamento e gerar você mesmo, no servidor, um nome novo, aleatório e sem significado, guardando o nome original apenas como um dado associado se você precisar exibi-lo. Assim o atacante perde o controle sobre onde e como o arquivo é gravado. Esse cuidado com dado vindo do cliente é a mesma cautela que sustenta o princípio do menor privilégio: o arquivo recebe o mínimo de poder e confiança necessário.
Armazene fora do webroot ou em storage de objetos
Onde o arquivo é guardado determina boa parte do risco. Se ele cai dentro da árvore de diretórios de onde o servidor web serve e executa conteúdo, você corre o risco de um upload virar código executável acessível pela web. A prática segura é guardar os arquivos fora do webroot, num local de onde o servidor jamais executa nada, ou melhor ainda, em um serviço de armazenamento de objetos separado. Nesse modelo, o arquivo nunca fica no mesmo sistema de arquivos que roda a aplicação, e servi-lo de volta passa por um caminho controlado, o que reduz drasticamente a chance de execução acidental.
Reprocesse o conteúdo para remover payloads
Para imagens, uma defesa poderosa é não guardar o arquivo original, mas reprocessá-lo: decodificar a imagem e recodificá-la do zero no servidor. Esse re-encode descarta metadados escondidos, trechos maliciosos anexados e conteúdo poliglota, porque a nova imagem é construída apenas a partir dos pixels válidos, deixando para trás qualquer payload embutido. É uma das formas mais eficazes de neutralizar imagens armadas. Para outros formatos, considere passar por bibliotecas que normalizam e validam o conteúdo, sempre partindo do princípio de que o arquivo recebido pode estar armado.
Sirva os arquivos com cuidado
O momento de devolver o arquivo ao navegador é tão delicado quanto o de recebê-lo. Sirva sempre com o tipo de conteúdo correto e explícito, para o navegador não adivinhar o tipo e acabar executando como HTML algo que deveria ser tratado como download. Use o cabeçalho que força o download em vez da exibição para tipos que não precisam ser abertos no navegador. E, sobretudo, sirva conteúdo enviado por usuários de um domínio separado, isolado do domínio principal da aplicação. Assim, mesmo que um arquivo consiga executar script, ele roda num contexto sem acesso aos cookies e à sessão da aplicação principal, contendo o dano. Esse isolamento é uma das defesas mais eficazes contra o cross-site scripting por meio de arquivos enviados.
Escaneie, restrinja permissões e nunca execute
Complemente com verificação antivírus dos arquivos recebidos, especialmente se eles serão baixados por outros usuários, para não transformar o seu sistema em vetor de distribuição de malware. Grave os arquivos com permissões restritas, sem bit de execução, de modo que mesmo que algo escape, o sistema operacional se recuse a executá-lo. E jamais, em nenhuma circunstância, execute, interprete ou inclua como código um arquivo que veio de upload. Todas essas medidas se apoiam: o antivírus pega o conhecido, as permissões e o isolamento contêm o desconhecido, e a regra de nunca executar remove a possibilidade mais grave.
O caso especial do avatar e da imagem de perfil
Vale examinar de perto o caso mais comum de upload, a foto de perfil ou avatar, porque nele se concentram vários dos riscos e ele parece inofensivo justamente por ser corriqueiro. Aceitar uma imagem de perfil soa trivial, mas cada suposição ingênua abre uma porta. Confiar que o arquivo é uma imagem porque termina numa extensão de imagem permite que um script disfarçado passe. Guardar a imagem com o nome que o usuário mandou permite path traversal e colisões. Servir a imagem do mesmo domínio da aplicação permite que um arquivo que contenha script executável no navegador rode com acesso à sessão da vítima.
A implementação correta desse caso simples ilustra toda a disciplina. O servidor recebe o arquivo, verifica pelos bytes iniciais que ele é de fato uma imagem de um dos formatos permitidos, e recusa qualquer outra coisa. Impõe um limite de tamanho generoso mas real, para não permitir que alguém envie um arquivo enorme. Em vez de guardar o original, decodifica a imagem e a recodifica do zero num tamanho padronizado, o que serve a dois propósitos ao mesmo tempo: normaliza as dimensões para a interface e descarta qualquer payload embutido, metadados escondidos ou conteúdo poliglota que viajava junto. Gera um nome novo e aleatório para o arquivo resultante, sem qualquer relação com o nome enviado. Guarda o arquivo num serviço de armazenamento separado, fora da árvore de onde a aplicação executa código. E serve a imagem de um domínio isolado, com o tipo de conteúdo correto e explícito, de modo que mesmo um arquivo malicioso que sobrevivesse ao reprocessamento não teria acesso aos cookies da aplicação principal.
Note como um recurso aparentemente banal exige quase toda a pilha de defesa. É por isso que tratar upload como território hostil não é paranoia: mesmo o caso mais inocente concentra vetores suficientes para comprometer a aplicação se qualquer etapa for negligenciada. Quem faz o avatar corretamente já internalizou o método que serve para qualquer upload mais arriscado, como documentos, anexos e arquivos que outros usuários vão baixar.
Conclusão
Segurança de upload é uma cadeia de decisões, e basta uma elo fraco para a porta se abrir. Trate todo arquivo como hostil: valide pelo conteúdo real e não pela extensão, aceite apenas uma allowlist estreita de tipos, imponha limites de tamanho e taxa, gere o nome no servidor para barrar path traversal, guarde fora do webroot ou em storage de objetos, reprocesse imagens para remover payloads, sirva com tipo correto e de um domínio isolado, escaneie e nunca execute o que foi enviado. Cada medida cobre um vetor específico, e é a soma delas que transforma uma funcionalidade perigosa numa que aceita arquivos sem entregar o controle da sua infraestrutura a quem os envia.
