PKR-Lab

60090 - pacman (Schulungsobjekt) — Hintergründe

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/6-hintergruende/60090-pacman-schulungsobjekt.md

pacman (Schulungsobjekt) — Hintergründe

Begründungen zu argocd/apps/tech/pacman/ (Go-Server, Frontend-Skripte, Chart). pacman ist ein Pacman-Canvas-Fork, der in der IT-Security-Schulung zeigt, was ein Webserver über
einen Besucher herausfinden kann
, mit einem Grafana-Dashboard als „Auflösung“. Zweck, Ablauf und Offenlegung stehen in
300f0 und im README des Charts. Hier stehen die Implementierungsentscheidungen.
Übersicht dieser Kategorie: 60000.

Rahmen: Die Erhebung von Besucherdaten ist ausschließlich für den abgegrenzten Schulungskontext mit informierten, einverstandenen Teilnehmenden gedacht, die vorher mündlich aufgeklärt
werden. Das Trainingsmodus-Flag ist deshalb standardmäßig aus.


Server (Go)

Auslieferung und Vendoring

Der Server liefert die vendorten Pacman-Canvas-Assets aus und schreibt je Request eine strukturierte JSON-Zeile (Client-IP, User-Agent und, falls eine MMDB-Geo-Datenbank gemountet ist, den
aufgelösten Standort). Änderungen am vendorten Spiel werden nicht in dessen Dateien vorgenommen, sondern im Server, damit ein erneutes Vendoring vom Upstream ein sauberer Diff bleibt statt
eines Merge-Konflikts:

Bestenliste

Zugriffslog

GeoIP

Quelle ist DB-IP City Lite (db-ip.com, CC BY 4.0): kostenlos, kein Account und kein Lizenzschlüssel, monatlicher Direct-Download (siehe README). Standardmäßig an, weil das der Zweck der App ist. Schlägt der
Download trotzdem fehl, läuft der Server weiter und loggt nur die rohe IP.

Trainingsmodus

trainingMode.enabled koppelt das Namensfeld im Nickname-Overlay an dieselbe versteckte Autofill-Ernte (E-Mail, Telefon, Adresse, PLZ), die fingerprint.js für die eigene Ecke nutzt. Standard ist aus.


Frontend

fingerprint.js

Clientseitige Erfassung für die Schulungsdemo. Sie ist nicht Teil des vendorten pacman-canvas-Spiels, sondern von uns ergänzt und serverseitig eingebunden. Sie liest ausschließlich Browser-APIs, auf die
eine Seite ohne jede Berechtigungsabfrage zugreifen kann. Geolocation, Kamera und Mikrofon werden bewusst nicht verwendet: Sie zeigen einen sichtbaren Browser-Dialog, was den Punkt „niemand bemerkt es“
der Demo zunichtemachen würde.

nickname.js (Bestenlisten-Identität)