Serviceplattform Self-hosted¶

Allgemein¶

Die Serviceplattform ist ein zentrales Modul des INFOnline Measurement und dient grundsätzlich sowohl der Einhaltung von Vorschriften aus dem Datenschutz als auch zur Stabilisierung der Zensusmessung auf Grund von steigenden technischen Einschränkungen.

Zur Einhaltung sämtlicher Datenschutzvorschriften aus der EU-DSGVO und dem TTDSG verhindert die Serviceplattform als Messendpunkt den Austausch der IP-Adresse des Nutzers mit den Systemen der INFOnline im Rahmen des INFOnline Measurement.

Da die Verarbeitung der IP-Adresse als personenbezogenes Datum im Rahmen einer anonymen Messung nicht gestattet ist, wird diese auf der Serviceplattform verworfen, bevor der Messaufruf an INFOnline geleitet wird.

Die Nutzung der Serviceplattform im Rahmen der consentfreien Zensusmessung ist somit für die Messung von Webseiten notwendig.

Weiterhin wird durch die Serviceplattform eine Zensusmessung von Webseiten mit einer 1st-Party -Technologie ermöglicht, also unter der Domäne des Digital-Angebots.

Durch diese Technologie ist das System resistenter gegen die steigenden Restriktionen von 3rd-Party -Systemen, etwa durch Adblocker und die Ablehnung von 3rd-Party-Cookies.

Im Rahmen des Self-Hostings der Serviceplattform wird der Betrieb dieses Moduls auf Ihrer Infrastruktur realisiert.

Info

Sie benötigen lediglich eine Serviceplattform um all Ihre Digital-Angebote zu messen.

Alternative¶

Alternativ besteht die Möglichkeit, den Betrieb der Serviceplattform – im Rahmen der Nutzungsmessung für die DBS ohne zusätzliche Kosten für die Bibliothek - an INFOnline im Rahmen eines Hostings zu übertragen.

Info

1
2

Sollten Sie das Hosting der Serviceplattform bei INFOnline in Anspruch nehmen, ist es notwendig DNS-Einträge (CNAME) zu konfigurieren.
Die Notation dieser Einträge wird von INFOnline vorgegeben und Ihnen nach Beauftragung des Hostings im [Anmeldefrontend](https://dbs.infonline.de/) für jede zu messende Domain bereitgestellt.

Einrichtung¶

Voraussetzungen¶

Für den Betrieb der Serviceplattform in Ihrer Infrastruktur sollten Sie folgende Voraussetzungen erfüllen:

Linux (Unix) basierte Infrastruktur
entsprechende Berechtigungen auf den Systemen
entsprechende Umgebung um Docker Images auszuführen
Proxy für das SSL-Offloading¹
CORS Konfiguration via SSL-Offloader² oder via Serviceplattform³

¹ Ein SSL Offloader ist eine Software, welche sich um die SSL/TLS Verbindungen kümmert. Diese braucht ein Zertifikat, welches passend zur Domain ausgestellt wurde. Bei INFOnline Measurement wird dieser benötigt, da die Serviceplattform diesen als Proxy-Server vorgeschaltet nutzt. Die Serviceplattform selbst kann nicht SSL/TLS Verbindungen verwalten. Bekannte Softwaren in diesem Bereich sind nginx oder Apache HTTP Server.
² Um die fehlerfreie Funktion der Zensusmessung zu gewährleisten, muss CORS korrekt konfiguriert werde. Dies kann im verwendeten SSL-Offloader entsprechend vorgenommen werden.
³ CORS kann auch in der Serviceplattform konfiguriert werden, siehe Konfiguration Container.

Wir empfehlen Ihnen bei einem PI Aufkommen von bis zu 2.000 PI pro Minute folgende minimalen Systemanforderungen:

CPU: 4core
RAM: 16GB
HDD: 80GB

Gibt es auf Ihrem Digital-Angebot Peakzeiten mit mehr als 2.000 PI pro Minute, dimensionieren Sie das System bitte entsprechend größer.

Bereitstellung der Serviceplattform¶

Um die Serviceplattform in Ihrer Infrastruktur zu betreiben, stellen wir Ihnen nach der Beauftragung folgendes zur Verfügung:

Docker-Image für die Serviceplattform
AccessToken für den Betrieb der Serviceplattform

Das Docker-Image stellen wir Ihnen nach der Anmeldung via quay.io Repo zur Verfügung.

Die Zugangsdaten für das Repo erhalten Sie mit Ihrer Auftragsbestätigung, den AccessToken stellen wir Ihnen nach der Einrichtung Ihrer self-hosted Serviceplattform in unserem System mit einer weiteren Einrichtungsmail zur Verfügung.

Einrichtung der Serviceplattform im INFOnline System¶

Um eine manipulationsfreie Messung via INFOnline Measurement sicherzustellen, werden die Digital-Angebote und die dazu gehörigen Serviceplattformen, zentral bei der INFOnline verwaltet.

Die Serviceplattform erhält die benötigten Informationen über entsprechende Konfigurationen aus dem zentralen INFOnline System.

Für die Kommunikation zwischen INFOnline System und der self-hosted Serviceplattform ist ein AccessToken notwendig.

Diesen erhalten Sie von unserem Customer Service Team auf Anfrage. Bitte übermitteln Sie uns im Gegenzug den entsprechenden Hosteintrag, unter dem die self-hosted Serviceplattform erreichbar sein wird.

Betrieb der Serviceplattform¶

Installation

Anlegen einer environment Datei mit den Parametern zum Starten des Containers.
relay_key=<relay-client-namen>
geoip=false¹
token=<AccessToken>²
Login in der Repo:
docker login --username quay.io³
Beziehen des Containers:
docker pull quay.io/infonline/relay-client:[VERSION]⁴

Start
- Startet einen Container, der auf Port 8101 lauscht:
docker run --name relay-client --env-file [PFAD_ZUR_ENVIRONMENT_DATEI] --publish 127.0.0.1:8101:53119/tcp -d quay.io/infonline/relay-client:[VERSION]

¹ Ermöglicht mit entsprechender MaxMind Lizenz eine Geolokalisierung im anonymen Messverfahren, siehe Konfiguration Container. ² Erhalten Sie mit der Einrichtung der Serviceplattform im INFOnline System Bereitstellung der Serviceplattform. ³ Den username erhalten Sie mit der Einrichtungsbestätigung. ⁴ Die aktuelle Version erhalten Sie mit Ihrer Einrichtungsmail, bei Änderungen erhalten Sie eine gesonderte Mail.

Konfiguration Container¶

Die folgenden Parameter können genutzt werden um den Container zu konfigurieren:

Abkürzung	Typ	Standard	Länge	Muster	Obligatorisch	Beschreibung
TOKEN	String	-	20	^[a-zA-Z0-9_]*$	ja	Token für die Authentifizierung bei IO
RELAY_KEY	String	-	-	^[a-zA-Z0-9_]*$	ja	Der Hostname der Serviceplattform, den Sie bei der Einrichtung an die INFOnline übermittelt haben
GEOIP	Bool	False	-	-	nein	GeoIP Auflösung (Ja/Nein), nur bei Nutzung des INFOnline Measurement anonym, für die Nutzung der Zensusmessung nicht relevant
cors	Bool	False	-	-	nein	Gibt an, ob der CORS Header bei https vom Relay Client gesetzt werden soll (erst ab Version 0.9.1)

Empfehlungen für den Betrieb¶

Um einen reibungslosen Betrieb sicherzustellen, empfehlen wir Ihnen Ihre Infrastruktur, bzw. den Betrieb der Serviceplattform dynamisch zu gestalten.

Monitoring¶

Die Serviceplattform bietet eine API zum Monitoring der Funktion des Containers.

1 Der Container bietet unter der Adresse localhost:8101/hc.io die Möglichkeit an, einen Healthcheck abzurufen, der die Funktionsweise der PHP Seite und damit die Kette der Software prüft. Bei einem erfolgreichen Check, wird eine 200 Meldung zurückgegeben.

2 Der Container bietet unter der Adresse localhost:53120/nginx_status, localhost:53120/rsyslog_status und localhost:53120/php_status die Möglichkeit an, einen Prometheus Exporter zu verbinden. Dieses Adressen sind aber nur innerhalb des Container Daemon Netzwerks erreichbar und daher muss der Exporter in diesem eingebunden sein.

Auswirkungen bei Störungen¶

Die Serviceplattform ist das zentrale Module des INFOnline Measurements. Kommt es zu einer Störung im Betrieb der Serviceplattform, wirkt sich diese direkt auf die Messresultate auf.

Ein Ausfall und/oder gestörte Erreichbarkeit der Serviceplattform führt unmittelbar zu einer Mindermessung, bzw. zu einem Messausfall.

Die Messaufrufe, die ggf. während der Störung eingelaufen wären, können nicht wiederhergestellt werden.

Wir empfehlen Ihnen zwingend die Möglichkeiten des Monitoring zu nutzen.

Updates der Serviceplattform¶

Über Updates der Serviceplattform werden Sie von uns frühzeitig informiert und wir stellen Ihnen neue Versionen der Docker-Images, wie unter Bereitstellung der Serviceplattform beschrieben, bereit.