Zum Hauptinhalt springen
Headless-CMS-Vorschau: Entwürfe aus öffentlichen Routen fernhalten
Platform SEOFortgeschritten

Headless-CMS-Vorschau: Entwürfe aus öffentlichen Routen fernhalten

Ein Preview-Parameter ist keine Zugriffskontrolle. Prüfe CMS-Rechte, Vorschau-Einstieg, öffentliche Antworten und Cache-Verhalten getrennt, damit Entwürfe geschützt bleiben.

Matthias RamahiMatthias Ramahi
8 Min. Lesezeit6. November 2026Historische Bewertung: 95/100Aktualisiert 17. Nov. 2026

Ein Artikel steht im CMS auf Entwurf. Die Redaktion kann ihn über einen Vorschau-Link öffnen. Ob damit auch feststeht, dass Besucher ohne Berechtigung den Text nicht bekommen, hängt von der Anwendung ab. Ein Statusfeld im CMS beantwortet diese Frage nicht allein.

Bei einem Headless CMS liegen Inhaltsverwaltung und Website-Ausgabe in unterschiedlichen Teilen des Systems. Die Vorschau verbindet sie. Dabei können CMS-Leserechte, serverseitige Datenabfragen, Vorschau-Cookies und öffentliche Routen zusammenwirken. Für eine belastbare Abnahme musst du die tatsächliche Antwort prüfen.

Dieser Leitfaden beschreibt dafür eine kontrollierte Prüfmatrix. Alle Beispieladressen und Inhalte sind fiktiv. Er berichtet keinen Test der produktiven Crawl-Foundry-Installation oder einer Kundenwebsite. Das Ziel ist ein klarer Nachweis: Berechtigte Personen können arbeiten, während nicht veröffentlichte Inhalte für unberechtigte Abrufe unerreichbar bleiben.

Mit einer kleinen Routenkarte beginnen

Erfasse zunächst den Vorschau-Einstieg, die Zielseite und die öffentliche Artikeladresse. Diese können verschiedene Pfade haben oder dieselbe Route mit unterschiedlichen Sitzungszuständen verwenden. Ergänze die API, aus der der Browser oder Server die Inhalte bezieht.

Ein fiktives Beispiel wäre /api/preview als Einstieg, /preview/artikel-42 als Ziel und /blog/artikel-42 als spätere öffentliche Adresse. In einer anderen Anwendung entscheidet ein Cookie darüber, welche Fassung /blog/artikel-42 zeigt. Beide Modelle brauchen eine eigene Prüfung. Der Name des Pfads beweist keinen Schutz.

Notiere außerdem Sprachen, alternative Hosts und benötigte Mediendateien. Ein geschützter deutscher Vorschaupfad sagt nichts über eine englische Variante aus. Ein nicht öffentlicher Artikel kann Bilder oder Downloads verwenden, deren eigene URLs andere Regeln haben.

Zugriff, Crawling und Indexierung auseinanderhalten

Eine Zugriffskontrolle entscheidet, ob eine Anfrage den Entwurf erhalten darf. Eine robots.txt richtet sich dagegen an Crawler. Sie ist keine Anmeldung und hindert einen normalen HTTP-Client nicht daran, dieselbe URL abzurufen.

Google erklärt in seiner Einführung zu robots.txt, dass eine gesperrte URL trotzdem in Suchergebnissen erscheinen kann, wenn andere Seiten darauf verweisen. Eine schwer zu erratende Adresse ist ebenfalls kein Beleg dafür, dass der Server eine Berechtigung prüft.

Noindex steuert wiederum die Aufnahme in unterstützende Suchmaschinen. Es verhindert keinen Download durch eine Person, die die URL kennt. Laut Googles Dokumentation muss der Crawler die Anweisung abrufen können. Eine gleichzeitige robots-Sperre kann das verhindern.

Für vertrauliche Entwürfe folgt daraus kein Auftrag, den Inhalt für Google freizugeben. Sorge zuerst dafür, dass unberechtigte Anfragen ihn nicht erhalten. Eine zusätzliche Indexierungsanweisung auf einer erlaubten Vorschauantwort kann sinnvoll sein, ersetzt aber diese Berechtigungsprüfung nicht. Lies dafür sowohl das HTML-Metaelement als auch einen möglichen X-Robots-Tag-Header.

CMS-Rechte bis zur Website-Ausgabe verfolgen

Die Directus-Dokumentation zur Live Preview beschreibt eine konfigurierbare Vorschau-URL. Das Frontend muss die Anfrage verarbeiten und die gewünschte Fassung laden. Bei Versionen wird der Versionsschlüssel übergeben; die Anwendung muss ihn tatsächlich beim Datenabruf verwenden.

Eine Kennzeichnung wie preview=true oder version=draft beschreibt deshalb zunächst die gewünschte Darstellung. Ob die anfragende Person diese Fassung sehen darf, ist eine weitere Entscheidung. Ein beliebig gesetzter Parameter darf diese Entscheidung nicht ersetzen.

Verfolge den Datenweg: Welche Identität fragt das CMS ab? Welche Datensätze und Felder darf sie lesen? Gibt das Frontend davon etwas an öffentliche Besucher weiter? Directus erläutert seine Regeln in der Access-Control-Referenz. Prüfe die tatsächlichen Policies und Filter; ein von euch gewählter Statusname besitzt nicht automatisch die gewünschte öffentliche Bedeutung.

Ein Server kann mit eigenen Leserechten Daten erhalten, die ein anonymer CMS-Client nicht bekäme. Darum beweist ein abgewiesener direkter API-Abruf noch nicht, dass die Frontend-Route ebenfalls geschützt ist. Teste beide Wege mit dem passenden Berechtigungsumfang.

Prüfe auch die wirksame Kombination der Rechte. Directus-Policies können Zugriffe additiv erweitern. Eine einschränkende Regel in einer Policy ist deshalb kein ausreichender Nachweis, wenn eine weitere aktive Policy denselben Zugriff umfassender erlaubt. Entscheidend ist die gesamte Berechtigung der tatsächlich verwendeten Identität.

Ein Negativtest macht diese Grenze konkret. In einer fiktiven Collection darf die öffentliche Identität nur Datensätze mit dem vorgesehenen Veröffentlichungsstatus lesen. Teste mit einem erlaubten veröffentlichten Datensatz und dem gesonderten Entwurf. Beide Versuche gehören zusammen: Eine fehlerhafte Abfrage, die grundsätzlich nichts zurückgibt, wäre kein funktionierender Veröffentlichungsweg.

Übertrage den beispielhaften Statusfilter nicht blind auf euer Schema. Sprachfassung, Veröffentlichungszeit und weitere Freigabefelder können zur wirklichen Regel gehören. Notiere genau, welche Bedingungen eure öffentliche Fassung definieren. So bleibt bei einer späteren Schemaänderung erkennbar, welche Tests angepasst werden müssen.

Den Vorschau-Einstieg gesondert absichern

Next.js zeigt in seinem Draft-Mode-Leitfaden einen wichtigen Unterschied: Ein Handler, der Draft Mode ohne Prüfung aktiviert, ist zunächst öffentlich. Das Beispiel ergänzt deshalb eine Prüfung des gemeinsamen Secrets und des angefragten Inhalts, bevor der Modus eingeschaltet wird.

Draft Mode setzt einen Cookie für spätere Abrufe. Das Umschalten ist damit nicht dasselbe wie eine vollständige Benutzer- und Inhaltsberechtigung. Lege fest, wem ein Vorschauzugang erteilt werden darf und welche Inhalte er umfasst. Ein bewusst ausgestellter Freigabelink kann Teil dieses Modells sein; bloßes Benennen einer URL als „Preview“ ist es nicht.

Setze keinen langlebigen Directus-Static-Token in diese URL. Directus warnt, dass Authentifizierung per Query-Parameter offengelegt oder protokolliert werden kann; OWASP erklärt in seiner Dokumentation zur Offenlegung über URL-Query-Strings, dass HTTPS sensible Query-Werte nicht aus Browser-Verlauf, Referrer, Webserver-Logs oder gemeinsam genutzten Systemen heraushält. Wenn die Übergabe eines Tokens unvermeidbar ist, beschränke seine Berechtigungen auf das Nötige, filtere die URL aus Logs heraus und tausche den Token vor der Weiterleitung auf einen bereinigten Pfad gegen eine Sitzung aus. Das Next.js-Beispiel leitet auf den geprüften Artikelpfad weiter und entfernt das Secret so aus der Zieladresse; der erste Request kann trotzdem protokolliert werden. Ein Vorschau-Link ist ein Einstieg, aber kein Beweis dafür, dass ein Entwurf nach dem Kopieren des Links privat bleibt.

Prüfe nach der Aktivierung auch den Zielpfad. Der Next.js-Leitfaden leitet auf den aus dem geprüften Inhalt ermittelten Pfad weiter, statt einen beliebigen Redirect-Parameter zu übernehmen. Passe das Vorgehen an eure Anwendung an. Kopiere keinen Aktivierungs-Handler isoliert aus einem Einführungsbeispiel.

Einen anonymen GET als Ausgangspunkt sichern

Lege in einer geeigneten Testumgebung einen unveröffentlichten Testartikel mit einer eindeutigen, nicht vertraulichen Textmarke an. Im folgenden Beispiel lautet sie ENTWURF-PRUEFUNG-42. Verwende weder echte Geschäftsgeheimnisse noch produktive Zugriffstokens in der Prüfdatei.

Diese Abrufe verwenden keine übergebene Anmeldung und speichern Header und vollständigen Body getrennt:

bashcurl -q --compressed -sS -D preview.headers -o preview.html 'https://example.com/preview/artikel-42'
curl -q --compressed -sS -D public.headers -o public.html 'https://example.com/blog/artikel-42?preview=true&version=draft'

Unter Windows kannst du curl.exe verwenden. Die curl-Dokumentation zu `-q` erklärt, dass die Option als erste curl-Option die Standard-Konfigurationsdatei unterdrückt. Die Befehle folgen Weiterleitungen nicht automatisch. Falls die Antwort zu einem Login führt, halte die Station fest und prüfe das Ziel separat. Eine abschließende Login-Seite mit 200 ist nicht dasselbe wie ein mit 200 ausgelieferter Entwurf.

Lies Status, Header und Body zusammen. Suche die Testmarke auch in eingebetteten Daten, nicht nur im sichtbaren Fließtext. Ein Overlay mit „Bitte anmelden“ schützt nichts, wenn der Entwurf bereits in der Antwort steckt. HEAD allein liefert diesen Nachweis nicht.

Eine hypothetische Abnahmematrix

Der folgende Plan ist nicht an einer realen Installation ausgeführt worden. Er zeigt, welche Fälle ein Team für seinen Testartikel dokumentieren kann. Die vorgesehenen Antworten hängen vom bewusst gewählten Zugriffsmodell ab.

PrüffallZu prüfendes ErgebnisWas dadurch noch nicht bewiesen ist
Ohne Vorschauzugang, Einstieg und Ziel direkt aufrufenKein Entwurf im Body oder in nachgeladenen DatenAndere Hosts, Sprachen und Dateien können abweichen
Parameter ohne gültige Freigabe hinzufügenParameter allein schaltet keine Entwurfsrechte freiDie echte Aktivierungsstrecke muss separat funktionieren
Mit berechtigter Vorschau öffnenRichtige Version für die erlaubte Person sichtbarÖffentliche Abrufe sind dadurch nicht geprüft
Vorschau beenden und erneut aufrufenVorgesehener öffentlicher oder verweigerter ZustandBeenden des Modus ist nicht automatisch Widerruf aller Zugänge
Danach aus einer frischen Sitzung abrufenKein Entwurf aus einer gemeinsamen Cache-AntwortWeitere Cache-Ebenen brauchen gegebenenfalls eigene Belege

Prüfe bei interaktiven Anwendungen zusätzlich die nachgeladenen Antworten im Browser. Wenn das erste HTML keinen Text enthält, kann eine spätere Datenanfrage ihn trotzdem liefern. Dokumentiere dafür dieselben Zustände und die tatsächlich angefragte URL.

Die Draft-Mode-Referenz unterscheidet Aktivieren, Abfragen und Deaktivieren. disable() beendet den Modus über den Cookie. Ob ein zuvor ausgegebener Freigabelink oder eine andere Anmeldesitzung weiterhin gültig ist, entscheidet eure zusätzliche Zugriffslogik.

Vorschau und öffentliche Cache-Antworten trennen

Bei Server-Side Rendering ist die erzeugte Antwort nicht zwangsläufig für alle Empfänger gleich. Besonders wichtig ist deshalb die Reihenfolge: erst berechtigte Vorschau öffnen, danach die öffentliche Adresse ohne diesen Zustand abrufen. So untersuchst du, ob eine vorherige Entwurfsantwort öffentlich wiederverwendet wird.

Die HTTP-Caching-Spezifikation RFC 9111 unterscheidet private, no-cache und no-store. Vereinfacht verhindert unqualifiziertes private die Speicherung in gemeinsamen Caches. no-cache verlangt vor Wiederverwendung eine erfolgreiche Validierung. no-store untersagt Caches das Speichern der betreffenden Antwort. Keine dieser Anweisungen authentifiziert den Besucher.

Halte die tatsächlichen Antwortheader und eure Cache-Regeln fest. Ein Header im Anwendungscode ist kein Beleg dafür, dass eine vorgelagerte Ebene ihn unverändert erhält und berücksichtigt. Eine neue Regel beseitigt außerdem nicht automatisch jede bereits ausgelieferte oder gespeicherte Kopie.

Aktuelle Next.js-Dokumentation beschreibt Cache-Bypass und private Antwortheader für Draft Mode. Überprüfe trotzdem den eingesetzten Build und die gesamte Auslieferungsstrecke. Ein Framework-Verhalten ist kein Test eurer Proxy-, CDN- und Datenquellenkonfiguration.

Öffentliche Entdeckungspfade kontrollieren

Prüfe anschließend Listen, Feeds, Suchfunktionen und die XML-Sitemap. Sie sollten den beabsichtigten Veröffentlichungsbestand ausgeben. Eine nicht verlinkte Vorschau ist jedoch nicht automatisch geschützt. Das Entfernen eines Links ersetzt keine Zugriffskontrolle.

Bei der internen Verlinkung gehören auch Vorschau-Parameter in kopierten Redaktionslinks zur Kontrolle. Veröffentliche nur die vorgesehene öffentliche Adresse. Suche nach Vorschau-Hosts oder Entwurfskennungen in den dafür relevanten eigenen Ausgaben, statt aus einer fehlenden Sitemap-Zeile auf vollständige Trennung zu schließen.

Falls bereits Inhalte öffentlich ausgeliefert wurden, behebe zuerst den Zugriff und prüfe betroffene Kopien. Eine Bereinigung sichtbarer Suchergebnisse ist eine weitere Aufgabe. Öffne vertrauliche Inhalte nicht erneut nur deshalb, damit ein Crawler eine nachträglich ergänzte Anweisung lesen kann.

Freigabe und technische Abnahme verbinden

Beim Veröffentlichen kontrollierst du die öffentliche Fassung nochmals ohne Vorschauzustand. Sie braucht die vorgesehenen Inhalte und Indexierungsregeln. Die SEO-Relaunch-Checkliste hilft bei größeren Umstellungen; für Entwürfe ergänzt du die getrennten Zugriffs- und Sitzungsfälle.

Im Site Audit von Crawl Foundry kannst du den öffentlich zu prüfenden URL-Bestand in den technischen Arbeitsablauf einordnen. Den privaten Vorschau-Test führst du mit eigens festgelegten Berechtigungen und Belegen durch. Ein öffentlicher Crawl ersetzt diese Prüfung nicht.

Für die Übergabe eines Befunds hilft unser Ablauf zur Bearbeitung technischer Audit-Probleme. Notiere Route, Release, Person oder Sitzungszustand, erwartete Fassung und tatsächliche Antwort. Die Abnahme bestätigt anschließend die geprüften Wege. Sie behauptet keine vollständige Sicherheit sämtlicher CMS-, Datei- und Veröffentlichungsfunktionen.

Baue eine Keyword-Datenbank, die dir gehört

Keywords importieren und ordnen, technische Probleme mit Belegen prüfen und alles jederzeit exportieren.

Kostenlos starten
Matthias Ramahi

Matthias Ramahi

Founder, Crawl Foundry

SEOKeyword ResearchTechnical SEO

Matthias Ramahi is the founder of Crawl Foundry and leads the product, its data sources, and its editorial standards. Crawl Foundry is his central software and SEO project.

Crawl Foundry bei Google bevorzugt anzeigen

Lege crawlfoundry.com in deinem Google-Konto als bevorzugte Quelle fest, dann erscheinen unsere Artikel bei Google weiter oben. Freiwillig und jederzeit widerrufbar.

Als bevorzugte Quelle festlegen

You Might Also Like

Website durchsuchen

Finde Produktinformationen, FAQ und Dokumentation mit Links zu den Originalseiten.