Republicar un WMS externo en GeoServer es una solución eficaz para evitar problemas de CORS y garantizar el correcto funcionamiento de capas WMS en aplicaciones web GIS.
En aplicaciones web basadas en tecnologías como Laravel, React y OpenLayers, es habitual consumir servicios WMS externos para complementar la información geográfica. Sin embargo, no todos los servicios WMS se comportan igual cuando se accede a ellos desde un navegador y, en muchos casos, una capa correctamente configurada simplemente no se visualiza.
¿Qué es CORS y por qué afecta a los WMS?
CORS (Cross-Origin Resource Sharing) es una política de seguridad implementada por los navegadores que regula desde qué dominios se pueden realizar peticiones a un servicio web. En el caso de los servicios WMS, esta política es especialmente relevante cuando se consumen directamente desde aplicaciones web.
Algunos servicios WMS permiten explícitamente este tipo de peticiones, mientras que otros las bloquean cuando el origen de la solicitud no coincide con el del servicio remoto. Cuando esto sucede, el navegador impide el acceso a la respuesta del servicio, lo que provoca que la capa no llegue a renderizarse en el visor, aunque la URL sea correcta y el servicio esté operativo.
Este comportamiento no depende de la aplicación cliente ni de la librería utilizada, sino exclusivamente de cómo esté configurado el servidor que publica el WMS.
Antes de optar por la republicación del servicio en un GeoServer propio, suelen plantearse otras alternativas para sortear esta limitación, que conviene conocer junto con sus principales inconvenientes.
Soluciones habituales
Proxy en backend
Una solución habitual es crear un proxy en el backend (por ejemplo, en Laravel) que actúe como intermediario entre el visor y el servicio remoto.
Aunque puede funcionar en algunos casos, presenta varios inconvenientes:
- Dificulta el mantenimiento y la escalabilidad.
- Añade complejidad al backend.
- Incrementa la carga del servidor.
- No siempre es viable para servicios pesados o con muchas peticiones.
Modificar cabeceras HTTP
Otra posibilidad sería modificar las cabeceras HTTP para permitir peticiones cross-origin. El problema es que:
- No es una solución que dependa de la aplicación cliente.
- Las cabeceras CORS dependen del servidor que publica el WMS.
- Si no se tiene control sobre ese servicio, no es posible cambiarlas.
En conjunto, estas opciones no siempre son aplicables y suelen verse afectadas por cambios en el servicio de origen, ya que dependen de configuraciones sobre las que no se tiene control directo. Además, no aportan un control real sobre el WMS consumido y, por tanto, tampoco garantizan un comportamiento estable en el tiempo, motivo por el que no suelen ser la opción más adecuada en entornos de producción.
Solución recomendada: republicar el WMS en GeoServer
La solución más estable es republicar el WMS externo en un GeoServer propio y consumirlo desde ahí.
GeoServer actúa como intermediario entre la aplicación web y el servicio externo, evitando el bloqueo por CORS y permitiendo tratar la capa como si fuera propia.
Ventajas de este enfoque
- Evita problemas de CORS.
- Unifica el consumo de capas WMS.
- Permite controlar versiones, estilos y proyecciones.
- Mejora la estabilidad del visor a medio y largo plazo.
- No requiere cambios en el frontend.
Entendidas las ventajas de republicar servicios WMS en GeoServer, resulta útil ver cómo aplicar este enfoque en un caso real. A continuación se muestra un ejemplo práctico en el que se republica un WMS externo y se integra correctamente en un visor web, evitando problemas de CORS.
Ejemplo práctico: republicar el WMS de Espacios Protegidos de MITECO
Con GeoServer en funcionamiento y acceso a su panel de administración, se puede proceder a la republicación de un servicio WMS externo. En este ejemplo se utilizará el servicio de Espacios Protegidos proporcionado por el MITECO.
1. Creación del workspace
Para mantener una estructura ordenada en GeoServer, el primer paso es crear un workspace específico:
- Acceder al panel de administración de GeoServer.
- Ir al menú Espacios de trabajo.
- Pulsar en Agregar un nuevo espacio de trabajo.
- Rellenar los campos:
- Name:
miteco - Namespace URI:
https://miteco.gob.es
- Name:
- Guardar los cambios.


Este workspace agrupará las capas republicadas desde el servicio de MITECO.
2. Creación del almacén WMS
Una vez creado el workspace, se configura el acceso al servicio WMS externo mediante un almacén WMS en cascada.
Para ello, se siguen los siguientes pasos:
- Acceder al menú Almacenes de datos.
- Pulsar en Agregar nuevo almacén.
- Seleccionar el tipo WMS.
- Elegir el workspace creado previamente (
miteco).


En la pantalla de configuración del almacén WMS se rellenan los siguientes campos:
- Espacio de trabajo:
miteco - Nombre del origen WMS:
miteco_wms - Almacén WMS en cascada:
https://wms.mapama.gob.es/sig/Biodiversidad/ENP - URL del documento Capabilities:
https://wms.mapama.gob.es/sig/Biodiversidad/ENP?service=WMS&request=GetCapabilities

El resto de opciones pueden dejarse con los valores por defecto, ya que el servicio no requiere autenticación.
Una vez completada la configuración, se guarda el almacén. GeoServer consultará el documento de capacidades del servicio remoto y dejará creado el almacén WMS, desde el cual será posible acceder al listado de capas disponibles y proceder a su publicación.

miteco_wms creado y listo para la publicación de capas3. Publicación de la capa
Una vez creado el almacén WMS, el siguiente paso consiste en publicar una de las capas disponibles en el servicio remoto. En el caso de los WMS en cascada, la publicación de capas se realiza desde el menú específico de capas.
Para publicar la capa:
- Acceder al menú Capas.
- Pulsar en Agregar una nueva capa.
- Seleccionar el almacén WMS creado (
miteco:miteco_wms). - GeoServer mostrará el listado de capas disponibles en el servicio remoto.
- Localizar la capa
PS.ProtectedSitey pulsar en Publicación y en la pantalla de configuración de la capa, revisar los parámetros básicos:- En el apartado de Sistema de referencia de coordenadas y Encuadres, utilizar la opción Calcular desde los datos para asegurar una correcta definición espacial.
- Guardar la configuración.



Una vez guardada esta configuración, la capa queda publicada en GeoServer y disponible como un WMS propio dentro del workspace, lista para su comprobación y posterior uso en la aplicación web.

miteco:PS.ProtectedSite publicada4. Comprobación desde la previsualización de capas
Antes de utilizar la capa en una aplicación web, es recomendable comprobar que el servicio responde correctamente desde GeoServer y que la capa se visualiza sin errores, para ello:
- Accede al menú Previsualización de capas y localiza la capa publicada (
miteco:PS.ProtectedSite). - Selecciona una de las opciones de previsualización WMS, como WMS (PNG) o WMS (JPEG).
- Verifica que la capa se renderiza correctamente en el visor de previsualización.


Si la capa se visualiza sin errores, significa que el WMS externo se está consumiendo correctamente a través de GeoServer y que la capa está lista para su uso en la aplicación. Desde esta misma pantalla es posible copiar la URL generada por GeoServer, que puede utilizarse como referencia para integrar la capa en el visor web junto al resto de servicios del proyecto.
Con este procedimiento se consigue integrar servicios WMS externos en aplicaciones web de forma estable, evitando los problemas habituales de CORS y manteniendo un mayor control sobre las capas consumidas. GeoServer actúa como intermediario, permitiendo tratar servicios externos como capas propias y facilitando su gestión e integración en visores web.
¿Quieres comentarnos algo? Adelante!