Alle Artikel Agentur-Praxis

TYPO3: Datenschutzerklärung automatisch aktuell halten mit der Complianty-Extension

Die Datenschutzerklärung einer TYPO3-Seite wird gern einmal geschrieben und dann vergessen. Die Extension Complianty Connector zeigt den Prüfstatus im Backend, startet Scans und gibt die freigegebene Erklärung per Inhaltselement aus, abgeglichen über den Scheduler.

8 Min. Lesezeit
TYPO3: Datenschutzerklärung automatisch aktuell halten mit der Complianty-Extension

In vielen TYPO3-Projekten liegt die Datenschutzerklärung als Text im Seitenbaum, den irgendwann jemand eingefügt hat. Wer sie pflegen soll, ist oft offen, und was die Website tatsächlich lädt, steht in einem anderen Werkzeug. Die Extension Complianty Connector bringt Prüfstatus und Datenschutzerklärung ins TYPO3-Backend: ein Modul für den Status, ein Inhaltselement für die Ausgabe, ein Scheduler-Befehl für den Abgleich. Dieser Artikel zeigt Einrichtung und Betrieb und nennt die Stellen, an denen es in der Praxis hakt.

Das Problem: Ein Text im Seitenbaum, den niemand mehr anfasst

Eine TYPO3-Installation wird oft über Jahre betreut, von der Agentur und von der Redaktion des Kunden. Es kommt ein Tracking-Dienst dazu, ein eingebettetes Video, ein neues Formular. Die Datenschutzerklärung muss die Dienste beschreiben, die auf der Website tatsächlich laufen (Art. 13 DSGVO). Steht sie als Fließtext in einer Seite, ändert sie nur jemand, der daran denkt. Und wer im Backend arbeitet, sieht nicht, was ein Scan der Website zuletzt gefunden hat.

Dazu kommt eine Frage der Zuständigkeit. Die Redaktion pflegt Inhalte, die Agentur den Betrieb, und der Text einer Datenschutzerklärung fällt dazwischen. Mit der Extension wandert die Pflege an eine Stelle: Der Text entsteht und wird freigegeben in Complianty, TYPO3 gibt ihn nur aus.

Was die Extension macht

  • Status im Backend: Unter Admin-Werkzeuge, Complianty (in TYPO3 14 unter Administration) stehen Ampel, die Zahl der offenen kritischen und wichtigen Befunde, der letzte Scan und die offenen Aufgaben mit Priorität.
  • Scan per Klick: Ein Administrator kann einen Scan starten. Das Modul prüft alle 3 Sekunden und zeigt das Ergebnis, sobald der Scan fertig ist.
  • Datenschutzerklärung als Inhaltselement: „Datenschutzerklärung (Complianty)“ gibt die in Complianty freigegebene Fassung aus. Das Element hat keine Felder.
  • Abgleich per Scheduler: Der Befehl complianty:sync-dse holt die Fassung ab. Ändert sich der Text, werden gecachte Seiten geleert.
  • Zustand der Kopie: Das Modul zeigt, ob eine Fassung freigegeben ist, wann zuletzt abgeglichen wurde und ob eine lokale Kopie ausgeliefert wird.

Einrichtung

1. Extension installieren. Die Extension läuft im Composer-Modus mit TYPO3 13.4 oder 14.3 und PHP 8.2 oder neuer:

composer require complianty/typo3-connector
vendor/bin/typo3 extension:setup

2. Verbindungstoken erzeugen. In Complianty beim Mandanten in der Zeile der Website das Symbol „Integrationen“ öffnen, die Integration „TYPO3“ wählen und das Token erzeugen. Es wird genau einmal angezeigt. Das Recht, Scans auszulösen, ist standardmäßig aus und kann nur ein Administrator des Complianty-Kontos zuschalten.

3. Token im Backend eintragen. Unter Admin-Werkzeuge, Complianty das Token einfügen und verbinden. Für Deployments gibt es den Weg ohne Backend, bei dem das Token aus der Umgebung kommt oder über eine versteckte Eingabe abgefragt wird:

COMPLIANTY_TOKEN=clp_site_… vendor/bin/typo3 complianty:connect

4. Site Set und Inhaltselement. Das Site Set „Complianty Connector“ in der Site-Konfiguration unter Sets ergänzen oder in der config.yaml der Site einhängen:

dependencies:
  - complianty/connector

Das Set lädt die Darstellung des Inhaltselements und setzt Fluid Styled Content voraus. Danach das Inhaltselement auf der Datenschutzseite einfügen.

5. Scheduler-Aufgabe. Eine Aufgabe „Execute console commands“ für complianty:sync-dse, alle 6 Stunden, zum Beispiel mit dem Cron-Ausdruck 0 */6 * * *. Ist die Kopie älter als 12 Stunden, warnt das Modul.

Die Verbindung mit Rechten, Widerruf und Ablauf ist in der Produktdokumentation zu Integrationen beschrieben.

Eine Erklärung, die nicht aus der Seite verschwindet

Die Extension gibt nur freigegebene Fassungen aus. Bearbeiten Sie die Erklärung in Complianty, wird die Freigabe zurückgesetzt. Die Website zeigt weiter die zuletzt freigegebene Fassung, und das Backend-Modul meldet, dass die Datenschutzerklärung in Complianty noch nicht freigegeben ist, während es weiter die Auslieferung einer lokalen Kopie anzeigt. Das Inhaltselement gibt nichts aus, solange es noch keine freigegebene Fassung gibt.

  • Besucher lösen bei vorhandener Kopie nie eine Anfrage an Complianty aus. Die Kopie liegt in Ihrer Installation.
  • Das HTML wird beim Speichern und bei der Ausgabe mit einer engen Whitelist gefiltert (HTMLPurifier). Skripte, iframes und Formulare sind nicht möglich.
  • Ändert sich der Text beim Abgleich, werden die gecachten Seiten geleert. Die neue Fassung erscheint also ohne manuelles Leeren des Caches.
  • Scheitert der erste Abruf ohne Kopie, versucht die Extension es nicht bei jedem Seitenaufruf neu, sondern wartet fünf Minuten.
  • Endet das Abonnement, gilt nach der Karenzfrist der neutrale Hinweistext des Dienstes statt der Erklärung.

Wenn etwas nicht klappt

  • „Das Token kann nicht gespeichert werden.“ Die Installation hat keinen encryptionKey. Das Token wird mit einem Schlüssel verschlüsselt, der daraus abgeleitet wird. Einmal das Install Tool durchlaufen oder den Schlüssel in der settings.php setzen.
  • „Das Token wurde abgelehnt.“ Das Token ist widerrufen oder gehört zu einer anderen Integration. Ein neues Token für TYPO3 erzeugen.
  • Das Inhaltselement zeigt nichts. Entweder gibt es noch keine freigegebene Fassung, oder das Site Set fehlt. Das Modul zeigt den Stand der Fassung, die Site-Konfiguration zeigt die Sets.
  • Die Kopie ist alt. Die Scheduler-Aufgabe läuft nicht. Cron und Aufgabe prüfen.
  • „Complianty ist gerade nicht erreichbar.“ Der Server kommt nicht zum Dienst. Firewall und die HTTP-Proxy-Einstellungen der Installation prüfen, die Extension nutzt den HTTP-Client von TYPO3.

Was gesendet wird und wie das Token geschützt ist

  • Vor der Eingabe eines Tokens sendet die Extension nichts.
  • Mit Token gehen das Token und die Version der Extension an Complianty. Keine Besucherdaten, keine Benutzernamen.
  • Das Token liegt verschlüsselt in der Tabelle sys_registry (libsodium secretbox, Schlüssel aus dem encryptionKey der Installation) und geht nie an den Browser, der nur einen kurzen Hinweis wie clp_site_AbC1… bekommt. Die Verschlüsselung schützt vor dem Abfluss der Datenbank allein. Wer auch den encryptionKey hat, kann sie öffnen. Auch deshalb lässt sich ein Token in Complianty jederzeit widerrufen.
  • Antworten des Dienstes werden gegen ein Schema geprüft. Unbekannte Felder werden verworfen, Fehlercodes gegen eine Liste geprüft. Weiterleitungen werden nicht verfolgt.
  • Backend-Modul und Abfrage-Route sind Administratoren vorbehalten, Formulare durch die Route-Tokens von TYPO3 geschützt.

Für Agenturen: Das gehört vorab geklärt

Eine Installation hält eine Verbindung. Betreiben Sie mehrere Sites in einer TYPO3-Installation, kann die Extension die Erklärung nur einer Website ausgeben. Das Backend-Modul ist Administratoren vorbehalten, Redakteure sehen den Status dort nicht. Jede Website bekommt ein eigenes Token, getrennt nach Integration. Verlässt ein Kunde die Agentur, widerrufen Sie genau diese Verbindung. Scans über die Extension zählen auf das gleiche Tagesbudget wie Scans aus Complianty und erscheinen im Compliance-Protokoll des Mandanten.

Vor dem Entfernen der Extension steht complianty:disconnect bereit. Der Befehl löscht das gespeicherte Token und die lokale Kopie. TYPO3 kennt für Composer-Installationen keinen Deinstallations-Hook, deshalb muss er vorher laufen. Für eine neue Umgebung, etwa Staging oder ein frisches Produktivsystem, lässt sich die Verbindung im Deployment herstellen: COMPLIANTY_TOKEN setzen und complianty:connect aufrufen. Das Token landet dort in der Datenbank der jeweiligen Installation.

Ein Token ohne Abruf verfällt derzeit nach 180 Tagen. Vierzehn Tage vorher kommt eine Hinweis-Mail, und in Complianty steht an der Verbindung, seit wann sie nicht benutzt wurde. Jeder Abruf verlängert die Verbindung, auch der automatische Abgleich der Datenschutzerklärung. Eine Verbindung, die im Hintergrund läuft, verfällt also nicht, ein vergessenes Token schon.

Dasselbe Prinzip gibt es für WordPress und Shopware. Eine Übersicht steht auf der Seite Integrationen.

Was die Extension nicht ist

  • Kein Cookie-Banner. Sie blockiert keine Cookies oder Skripte.
  • Kein Reparaturwerkzeug. Sie zeigt Befunde, ändert aber keine Einstellungen Ihrer Website.
  • Keine Rechtsberatung. Die Befunde sind Hinweise zur Prüfung, keine Aussage über die rechtliche Lage.
  • Nur für den Composer-Modus. Installationen im klassischen Modus werden nicht unterstützt.
  • Eine Verbindung je Installation. Bei Multi-Site ist nur eine Website anbindbar.
  • Mit Grenzen des Dienstes. Zwischen zwei Scans einer Website liegt eine Pause, und das Tagesbudget Ihres Tarifs gilt weiter.

Ausprobieren

Den Zustand Ihrer Website sehen Sie vorab mit dem kostenlosen Scan: Er zeigt, ob ein Cookie-Banner erkannt wurde und welche Dienste vor der Einwilligung laden. Für die laufende Anbindung legen Sie die Verbindung in Ihrem Complianty-Konto an.

Extension auf GitHub ansehen →
Jetzt kostenlosen Scan starten →

Häufige Fragen

Welche TYPO3-Versionen unterstützt die Extension?

TYPO3 13.4 LTS und 14.3 LTS mit PHP 8.2 oder neuer, ausschließlich im Composer-Modus. Die Extension nutzt Site Sets, ein Backend-Modul und ein Inhaltselement.

Wie kommt die Datenschutzerklärung auf die Seite?

Über das Inhaltselement „Datenschutzerklärung (Complianty)“, das Sie auf der Datenschutzseite einfügen. Es gibt die in Complianty freigegebene Fassung aus einer lokal gespeicherten, gefilterten Kopie aus. Der Abgleich läuft per Scheduler alle 6 Stunden.

Kann ich mehrere Sites einer TYPO3-Installation anbinden?

Eine Installation hält eine Verbindung. Bei einer Multi-Site-Installation kann deshalb nur die Datenschutzerklärung einer Website ausgegeben werden.

Sendet die Extension Besucherdaten an Complianty?

Nein. Gesendet werden das Verbindungstoken und die Version der Extension, keine Besucherdaten. Vor der Eingabe eines Tokens sendet die Extension nichts. Besucher lösen bei vorhandener Kopie nie eine Anfrage aus.

Warum erscheint die neue Fassung nicht sofort auf der Seite?

Die Kopie wird über den Scheduler-Befehl complianty:sync-dse abgeglichen, empfohlen alle 6 Stunden. Fehlt die Scheduler-Aufgabe oder läuft der Cron nicht, bleibt die alte Kopie stehen. Das Backend-Modul warnt, wenn sie älter als 12 Stunden ist, und bietet „Jetzt abgleichen“ für den sofortigen Abgleich.

Wo bearbeiten Redakteure die Datenschutzerklärung?

In Complianty, nicht in TYPO3. Das Inhaltselement hat keine Felder und gibt nur die freigegebene Fassung aus. Wer den Text ändern darf, entscheiden Sie über die Rechte in Complianty.

Was passiert, wenn Complianty nicht erreichbar ist?

Mit vorhandener Kopie nichts: Besucher bekommen weiter die letzte Fassung. Scheitert ein erster Abruf ohne Kopie, versucht die Extension es erst nach fünf Minuten erneut und nicht bei jedem Seitenaufruf.

Was kostet die Complianty-Extension für TYPO3?

Die Extension ist kostenlos und unter GPL-2.0-or-later veröffentlicht. Für Status, Scans und die Ausgabe der Datenschutzerklärung brauchen Sie ein Complianty-Konto mit aktivem Abonnement, dessen Tarif Integrationen enthält. Fehlt das, zeigt die Extension eine entsprechende Meldung.

Complianty für Agenturen

DSGVO-Sicherheit für alle eure Kunden-Websites. Zentral in einem Dashboard.

Automatisches Tracking, Pre/Post-Consent-Erkennung und fertige Dokumentation für alle Kundenprojekte.

Kostenlos, keine Anmeldung. Sehen Sie in Sekunden, was wirklich getrackt wird.

Prüfen Sie Ihre erste Website. Ohne Anmeldung.

Der Scan zeigt Ihnen in wenigen Minuten, was vor dem Consent lädt. Gefällt Ihnen das Ergebnis, legen Sie Ihre Mandanten an.