Guía · Exposición del lado del cliente

¿Qué es la exposición de source maps?

La exposición de source maps ocurre cuando los source maps (mapas de código fuente) que las herramientas de compilación generan para depurar quedan publicados en un sitio en producción. Cualquiera puede usarlos para reconstruir tu código front-end original, con sus comentarios, nombres de archivo y rutas internas. Es fácil de revisar y, por lo general, rápido de corregir.

01 Por qué importa

Lo que revela un source map expuesto

El JavaScript minificado es público, pero difícil de leer. Un source map deshace la minificación y convierte la ingeniería inversa en una simple lectura.

  • Código fuente legible

    Archivos originales, estructura de carpetas, nombres de variables y comentarios de los desarrolladores, a menudo incluso partes de archivos que el bundle no incluyó.

  • Un mapa de tu back-end

    Rutas de API, nombres de host internos, rutas de administración y feature flags que menciona el front-end, a veces incluso funciones que todavía no lanzaste.

  • Secretos que no deberían estar ahí

    Las claves y los tokens escritos directamente en el código front-end son públicos de todos modos. Un source map hace que sea mucho más fácil encontrarlos.

  • Tus dependencias

    Las rutas de los archivos empaquetados muestran qué paquetes de código abierto usas, y a veces sus versiones, que un atacante puede comparar con los CVE publicados.

02 Cómo ocurre

Cómo llegan los source maps a producción

Las herramientas de compilación empaquetan y minifican el JavaScript y el CSS antes de publicar una versión. Para que ese código se pueda depurar, también pueden generar un archivo .map por cada bundle: un documento JSON, en un formato estandarizado como ECMA-426, que vincula cada parte del resultado minificado con el archivo y la línea originales. Cuando su campo sourcesContent está completo, el mapa contiene todo el código fuente original, no solo los nombres de archivo.

Los navegadores encuentran un mapa mediante un comentario en la última línea del bundle, como //# sourceMappingURL=app.4f9c2.js.map, o mediante el encabezado de respuesta SourceMap. Las herramientas para desarrolladores lo cargan para cualquier persona que las abra.

La exposición suele venir de hábitos comunes de compilación y despliegue:

  • la compilación de producción genera mapas, y algunas configuraciones lo hacen por defecto;
  • el paso de despliegue copia toda la carpeta de compilación, mapas incluidos, al servidor web, la CDN o el bucket de almacenamiento;
  • los mapas pensados para un servicio de monitoreo de errores se suben allí y además quedan en el sitio;
  • los bundles antiguos y sus mapas siguen accesibles después de una corrección, porque los archivos con hash no siempre se eliminan.
03 Revísalo tú

Cómo revisar tu propio sitio de forma segura

Haz estas revisiones solo en sitios y aplicaciones que te pertenecen o que tienes autorización para probar. Cada una usa solicitudes normales, como las que haría un navegador.

  1. Busca la referencia

    Abre un archivo JavaScript de tu sitio en producción y revisa si su última línea contiene sourceMappingURL. Revisa también si sus encabezados de respuesta incluyen SourceMap o X-SourceMap.

  2. Solicita el mapa

    Descarga la URL referenciada, o la URL del bundle con .map al final. Si recibes un JSON con una lista sources, el mapa es público; si sourcesContent tiene contenido, tu código fuente también lo es.

  3. Abre las herramientas para desarrolladores

    En las herramientas para desarrolladores de tu navegador, abre el panel que muestra las fuentes de la página. Si ves tus carpetas originales y archivos legibles, cualquier visitante también puede verlos.

  4. Revisa el pipeline

    Confirma si las compilaciones de producción generan mapas, qué sube el paso de despliegue y si las compilaciones antiguas en tu CDN o almacenamiento todavía los sirven.

04 Corrígelo

Cómo corregirlo y evitar que vuelva a pasar

  • Deja de publicar mapas. Desactívalos en las compilaciones de producción, o genéralos sin la referencia sourceMappingURL y mantenlos fuera del artefacto de despliegue.
  • Mantén la depuración en privado. Si tu servicio de monitoreo de errores necesita los mapas, súbelos desde tu pipeline de compilación en lugar de servirlos desde tu sitio.
  • Elimina lo que ya está publicado. Borra los archivos .map publicados de servidores, CDN y almacenamiento, purga las cachés y revisa las compilaciones antiguas.
  • Trata lo filtrado como público. Revisa lo que revelaron los mapas y rota cualquier secreto que haya aparecido en ellos. Los secretos van en el servidor, no en el código front-end.
  • Agrega un control. Haz que el despliegue falle cuando un archivo .map o un comentario sourceMappingURL llegue al artefacto de producción.
05 Nuestra cobertura

Cómo cubre NorthBound la exposición de source maps

La exposición de código del lado del cliente es parte de nuestra inteligencia de exposición. En los dominios que verificaste, buscamos source maps públicos y reconstruimos el código fuente que exponen. Las mismas revisiones cubren archivos de configuración públicos como .env y .git/config, que aceptamos como hallazgos solo cuando el contenido de la respuesta coincide con un archivo de configuración real. Los valores secretos se enmascaran en los hallazgos y los reportes, y la evidencia completa queda en un almacenamiento privado con control de acceso. Nuestro equipo analiza cada resultado y les indica a tus ingenieros qué corregir primero.

06 Preguntas frecuentes

Preguntas sobre la exposición de source maps

¿Un source map expuesto es una vulnerabilidad?

No por sí solo. Expone información que hace más rápido encontrar vulnerabilidades reales. Su gravedad depende de lo que revele: una clave de API activa importa mucho más que el código de un formulario de contacto.

Nuestro código front-end es público de todos modos. ¿Por qué importa?

El código minificado es público, pero difícil de leer. Un mapa recupera nombres, comentarios, estructura y rutas de archivos, y puede incluir partes de archivos que el bundle nunca publicó.

¿Podemos conservar los source maps para el monitoreo de errores?

Sí. Súbelos de forma privada a tu servicio de monitoreo desde el pipeline de compilación, y no los sirvas desde tu sitio público.

Ya borramos los mapas. ¿Terminamos?

Todavía no. Revisa las cachés de la CDN y las compilaciones antiguas, y rota cualquier secreto que los mapas hayan expuesto. Asume que todo lo que fue público ya fue copiado.

Encuéntralo antes que un atacante.

Cuéntanos qué necesitas cubrir. Te responderemos desde contact@northboundintelligence.com para coordinar una reunión de alcance.

Datos de esta página verificados el 11 de noviembre de 2026.