Guia · Exposição do lado do cliente
O que é a exposição de source maps?
Há exposição de source maps quando os ficheiros que as ferramentas de build criam para depuração ficam publicados num site em produção. Qualquer pessoa pode usá-los para reconstruir o código front-end original, com os seus comentários, caminhos de ficheiros e rotas internas. É fácil de verificar e, em regra, rápido de corrigir.
O que um source map exposto revela
O JavaScript minificado é público, mas lento de ler. Um source map desfaz a minificação e transforma a engenharia inversa numa simples leitura.
-
Código-fonte legível
Ficheiros originais, estrutura de pastas, nomes de variáveis e comentários dos programadores, muitas vezes incluindo partes de ficheiros que o próprio bundle deixou de fora.
-
Um mapa do seu back-end
Rotas de API, nomes de host internos, caminhos de administração e feature flags a que o front-end faz referência, por vezes incluindo funcionalidades ainda não lançadas.
-
Segredos que não deviam lá estar
As chaves e os tokens escritos diretamente no código front-end são públicos de qualquer maneira. Um source map torna-os muito mais fáceis de encontrar.
-
As suas dependências
Os caminhos dos ficheiros incluídos no bundle mostram que pacotes de código aberto distribui e, por vezes, as respetivas versões, que um atacante pode comparar com os CVE publicados.
Como é que os source maps chegam a produção
As ferramentas de build agrupam e minificam o JavaScript e o CSS antes de cada lançamento.
Para que esse código continue a poder ser depurado, podem também gerar um ficheiro .map
por cada bundle: um documento JSON, num formato normalizado como ECMA-426, que liga cada
parte do resultado minificado ao ficheiro e à linha originais. Quando o campo
sourcesContent está preenchido, o mapa transporta todo o código-fonte original, e não
apenas os nomes dos ficheiros.
Os browsers encontram um mapa através de um comentário na última linha do bundle, como
//# sourceMappingURL=app.4f9c2.js.map, ou através de um cabeçalho de resposta SourceMap.
As ferramentas de programador carregam-no depois para quem quer que as abra.
A exposição resulta normalmente de hábitos correntes de build e de deploy:
- o build de produção gera mapas, e algumas configurações fazem-no por omissão;
- o passo de deploy copia toda a pasta de build, mapas incluídos, para o servidor web, a CDN ou o bucket de armazenamento;
- os mapas destinados a um serviço de monitorização de erros são enviados para lá e ficam também no site;
- os bundles antigos e os respetivos mapas continuam acessíveis depois de uma correção, porque os ficheiros com hash no nome nem sempre são limpos.
Como verificar o seu próprio site em segurança
Faça estas verificações apenas em sites e aplicações que lhe pertençam ou que esteja autorizado a testar. Todas usam pedidos comuns, como os que um browser faria.
-
Procure a referência
Abra um ficheiro JavaScript do seu site em produção e veja se a última linha contém
sourceMappingURL. Verifique se os cabeçalhos de resposta incluemSourceMapouX-SourceMap. -
Peça o mapa
Obtenha o URL referenciado, ou o URL do bundle com
.mapacrescentado. Uma resposta JSON com uma listasourcessignifica que o mapa é público; umsourcesContentpreenchido significa que o seu código-fonte também o é. -
Abra as ferramentas de programador
Nas ferramentas de programador do browser, abra o painel que lista as fontes da página. Se vir as suas pastas originais e ficheiros legíveis, todos os visitantes também os veem.
-
Verifique o pipeline
Confirme se os builds de produção geram mapas, o que é que o passo de deploy envia e se os builds antigos na sua CDN ou no armazenamento ainda os servem.
Como corrigir e manter corrigido
- Deixe de publicar mapas. Desative-os nos builds de produção, ou gere-os sem a
referência
sourceMappingURLe mantenha-os fora do artefacto de deploy. - Mantenha a depuração privada. Se o seu serviço de monitorização de erros precisar dos mapas, envie-lhos a partir do pipeline de build em vez de os servir a partir do site.
- Remova o que já está cá fora. Apague os ficheiros
.mappublicados dos servidores, da CDN e do armazenamento, limpe as caches e verifique os builds mais antigos. - Trate como público o que foi exposto. Reveja o que os mapas revelaram e faça a rotação de qualquer segredo que neles tenha aparecido. O lugar dos segredos é o servidor, não o código front-end.
- Acrescente uma salvaguarda. Faça o deploy falhar quando um ficheiro
.mapou um comentáriosourceMappingURLchegar ao artefacto de produção.
Como a NorthBound cobre a exposição de source maps
A exposição de código-fonte do lado do cliente faz parte da nossa inteligência de exposição. Nos domínios que verificou, procuramos source maps públicos e reconstruímos o código-fonte que expõem. As mesmas verificações abrangem ficheiros de configuração públicos, como .env e .git/config, que só aceitamos como achados quando o corpo da resposta corresponde a um ficheiro de configuração real. Os valores secretos são mascarados nos achados e nos relatórios, e a evidência completa fica em armazenamento privado, com controlo de acesso. A nossa equipa faz a triagem de cada resultado e indica aos seus engenheiros o que corrigir primeiro.
Perguntas sobre a exposição de source maps
Um source map exposto é uma vulnerabilidade?
Por si só, não. Expõe informação que torna mais rápido encontrar vulnerabilidades reais. A gravidade depende do que o mapa revela: uma chave de API ativa pesa muito mais do que o código-fonte de um formulário de contacto.
O nosso código front-end já é público. Porque é que isto importa?
O código minificado é público, mas lento de ler. Um mapa repõe nomes, comentários, estrutura e caminhos de ficheiros, e pode incluir partes de ficheiros que o bundle nunca chegou a distribuir.
Podemos manter os source maps para a monitorização de erros?
Sim. Envie-os de forma privada para o serviço de monitorização a partir do pipeline de build e não os sirva a partir do site público.
Apagámos os mapas. Está resolvido?
Ainda não. Verifique as caches da CDN e os builds mais antigos, e faça a rotação de qualquer segredo que os mapas tenham exposto. Parta do princípio de que tudo o que esteve público já foi copiado.
Encontre-o antes que um atacante o faça.
Diga-nos o que precisa de cobrir. Responderemos a partir de contact@northboundintelligence.com para marcar uma reunião de âmbito.
Dados desta página verificados a 11 de novembro de 2026.