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.

01 Porque importa

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.

02 Como acontece

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

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.

  1. 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 incluem SourceMap ou X-SourceMap.

  2. Peça o mapa

    Obtenha o URL referenciado, ou o URL do bundle com .map acrescentado. Uma resposta JSON com uma lista sources significa que o mapa é público; um sourcesContent preenchido significa que o seu código-fonte também o é.

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

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

04 Corrija

Como corrigir e manter corrigido

  • Deixe de publicar mapas. Desative-os nos builds de produção, ou gere-os sem a referência sourceMappingURL e 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 .map publicados 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 .map ou um comentário sourceMappingURL chegar ao artefacto de produção.
05 A nossa cobertura

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.

06 FAQ

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.