Uma entrada muda o arquivo acessado
O path traversal é uma falha que permite acessar arquivos ou diretórios fora da pasta autorizada pela aplicação. Ela ocorre quando uma entrada externa participa da construção de um caminho e consegue alterar seu destino. O sistema acaba acessando outro local ao resolver os componentes desse caminho.
A sequência ../ costuma indicar a pasta superior. Ao concatenar uma pasta permitida com um nome recebido pela aplicação, você pode produzir um caminho que retorna à pasta superior. O destino precisa ser conferido após a resolução desses componentes.
Um download fora da pasta de relatórios
Neste exemplo didático em um sistema Unix, um serviço deveria ler apenas arquivos de /srv/app/relatorios/. Ele recebe ../privado.txt como nome e monta /srv/app/relatorios/../privado.txt. A resolução de .. leva a /srv/app/privado.txt, fora da pasta de relatórios.
A leitura só terá sucesso se esse arquivo existir e o processo tiver permissão para abri-lo. O exemplo mostra por que conferir apenas o começo do texto do caminho falha: a string começa pela pasta esperada, mas o destino resolvido está fora dela.
Limitar o destino da operação
A aplicação pode receber um identificador de relatório e escolher internamente o arquivo correspondente, evitando aceitar um caminho livre. Para aceitar caminhos, precisa conferir o destino resolvido e sua permanência na área autorizada. Um link simbólico pode apontar para fora dessa área, por isso a verificação também deve considerar o arquivo alcançado por ele.
Você precisa conferir o arquivo aberto pela função de download, incluindo sua localização após a resolução do caminho. A mesma falha numa função de escrita pode permitir alterar arquivos alcançáveis pelo processo. Uma sessão autenticada também precisa respeitar a autorização de acesso a cada arquivo.
Dúvidas frequentes
Perguntas frequentes sobre path traversal
- O path traversal depende sempre da sequência ../?
- Não. Ela é uma forma comum de apontar para a pasta superior. Caminhos absolutos também podem alcançar arquivos fora da área permitida, conforme a construção usada pela aplicação.
- A falha permite apenas ler arquivos?
- A consequência depende da função exposta e das permissões do processo. Uma função de download pode revelar arquivos, enquanto uma função de gravação pode permitir alterá-los.
- Uma sessão autenticada evita path traversal?
- A autenticação confirma a identidade apresentada no acesso ao serviço. A aplicação ainda precisa autorizar o arquivo solicitado e limitar o destino real da operação à área permitida.
Para continuar
Recursos relacionados
Documentação
MITRE: CWE-22 e limitação de caminhos
Definição da CWE-22, com exemplos de caminhos relativos e absolutos e orientações para limitar o acesso a arquivos.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão prática para você revisar a construção de caminhos e testar o acesso a arquivos no projeto.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar funções de upload e download, você precisa conferir quais arquivos a aplicação permite acessar.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.