Leaflet und Stadia Maps hinter einer strikten CSP

Zwei Korrekturen, mit denen die Foto-Weltkarte in Produktion lief: der Tile-Host in img-src und eine Referrer-Policy origin an den Kacheln.

Artikel Erstellt Aktualisiert Auch auf Englisch: Leaflet and Stadia Maps Behind a Strict CSP

Geprüft von adrian am

Für die Fotoseite wollte ich eine Weltkarte mit allen Aufnahmeorten aus den EXIF-Koordinaten. Technisch unspektakulär: Leaflet mit leaflet.markercluster, Tiles von Stadia Maps (warum Stadia), Marker aus den Sidecar-JSONs neben jedem Foto.

Lokal lief das auf Anhieb. In Produktion kam nur eine graue Fläche mit den Markern darauf. Zwei unabhängige Probleme, beide verursacht von den Security-Headern in Caddy.

Das Setup

  • Seite: ein statischer Astro-Build hinter Caddy (April 2026).
  • Karte: Leaflet und leaflet.markercluster, gestartet von einem Client-Skript beim Laden.
  • Tiles: tiles-eu.stadiamaps.com, Stil alidade_smooth.

Problem 1: img-src 'self' blockt die Tiles

Die CSP in Caddy war bewusst streng:

Content-Security-Policy "default-src 'none'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; script-src 'self'; font-src 'self'; connect-src 'self'; ..."

Leaflet lädt Tiles als normale <img>-Elemente. img-src 'self' data: blockt also jede Kachel, die nicht von meiner eigenen Domain kommt. Die Lösung ist der Stadia-Host in img-src:

- img-src 'self' data:;
+ img-src 'self' data: https://tiles-eu.stadiamaps.com;

connect-src bleibt, wie es ist: Leaflet holt Tiles über <img>-Tags, nicht über fetch oder XHR. Übernommen habe ich es mit Backup, Prüfung und Reload:

sudo cp /etc/caddy/sites/adrian-altner.de.caddy \
        /etc/caddy/sites/adrian-altner.de.caddy.pre-csp-tiles
sudo vim /etc/caddy/sites/adrian-altner.de.caddy   # img-src-Zeile anpassen
sudo caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy

caddy validate liest die ganze Konfiguration, ohne den laufenden Dienst anzufassen. Ein Tippfehler fällt hier auf und nicht erst beim Reload.

Problem 2: Referrer-Policy no-referrer ergibt 401

Nach dem Reload lud die Karte, aber jede Kachel zeigte einen QR-Code und „401 Error · Invalid Authentication“. Stadia Maps gibt die Tiles über die Domain frei und liest dafür den Referer-Header. Genau den hatte meine globale Referrer-Policy "no-referrer" entfernt.

Die globale Policy wollte ich nicht aufweichen, also kommt die Ausnahme nur an die Kachelbilder. Das Attribut referrerpolicy an einem <img> überschreibt die Policy des Dokuments, und Leaflets TileLayer setzt es ab Version 1.9:

L.tileLayer(
    'https://tiles-eu.stadiamaps.com/tiles/alidade_smooth/{z}/{x}/{y}{r}.png',
    {
        attribution: '…',
        maxZoom: 20,
        referrerPolicy: 'origin',
    },
).addTo(map);

'origin' schickt nur https://adrian-altner.de, ohne Pfad und Query. Das reicht Stadia, um die Domain zu prüfen.

Zum Mitnehmen

  • Eine Karte von Dritten braucht ihren Host in img-src. WebGL-Bibliotheken wie MapLibre laden Tiles per fetch und brauchen den Host in connect-src; ihr Web Worker braucht worker-src (blob:, wenn die Bibliothek von einem CDN kommt).1
  • Ein globales no-referrer legt still jeden Dienst lahm, der die Domain per Referer prüft (Stadia Maps, Mapbox, Google Maps). Eine Ausnahme am Element ist der saubere Mittelweg.
  • Stadia Maps und viele andere lassen localhost ohne Prüfung durch, der Fehler zeigt sich erst in Produktion. Teste alles, was mit der CSP zu tun hat, gegen den echten Server.

Beruht auf

  • Leaflet + Stadia Maps hinter strikter CSP: zwei Stolpersteine (raw/2026/2026-04-24/leaflet-stadia-maps-hinter-strikter-csp-zwei-stolpersteine.md) [post]
  • MapLibre GL JS: Migration von v5 auf v6 [maplibre]

Mehr dazu

Thema

  • Webentwicklung Wie diese und andere Websites entstehen und gefunden werden: statische Seiten, Suchmaschinen, IndieWeb und Karten im Browser.

Baut auf

  • Security-Header in Caddy Eine strikte Content Security Policy, HSTS und no-referrer in einem Caddy-Siteblock, geprüft mit Webbkoll, securityheaders.com und dem Mozilla Observatory.

Nutzt

  • Caddy Webserver und Reverse Proxy, der TLS-Zertifikate selbst holt und erneuert, eingerichtet in einem kurzen Caddyfile.
  • Leaflet Kleine JavaScript-Bibliothek für interaktive Karten im Browser, mit Kachelbildern, Markern und Plugins wie dem Marker-Clustering.
  • Stadia Maps Dienst für Kartenkacheln aus OpenStreetMap-Daten, mit EU-Endpunkt und Freigabe über die Domain statt API-Schlüssel.

Im Text erwähnt

In der Graph-Ansicht zeigen