Audit Trail
Magento 2 Audit Trail — wer hat was wann geschrieben?
AlpenFX Audit Trail ist das gemeinsame Audit-Logging-Fundament für Magento 2. Append-only Einträge, eine Hash-Kette, ein Admin-Grid — und ein Service-Contract, den andere AlpenFX-Module und eigener Code nutzen.
Es ist ein reines Backend-Modul: kein Storefront-Markup, kein Script, kein zusätzlicher Request, keine Auswirkung auf den Full Page Cache.
Für wen?
Shops und Integratoren, die nachvollziehbare Admin- und Geschäftsereignisse brauchen, ohne für jedes Feature ein isoliertes Log zu bauen.
Was Sie sehen
- Das Audit-Log im Magento-Admin: eine Zeile pro Ereignis, filterbar nach Zeitraum, Akteur und Ereignistyp, ACL-geschützt.
- Die Konfiguration (nur Standard-Scope): Modul ein/aus, Logging-Modus synchron oder Message-Queue, PII-Opt-in (IP und Akteur), Aufbewahrungsfrist, HTTP-Gegenstelle.
- Den Prüflauf
bin/magento alpenfx:audit:verify— er nennt die erste Stelle, an der die Hashes nicht mehr zusammenpassen. - Den Aufräum-Befehl
bin/magento alpenfx:audit:prune(plus täglicher Cron) für die eingestellte Frist.
Wenn jemand am Protokoll dreht
Jeder neue Eintrag hängt kryptografisch am vorigen. Nachträglich ändern oder in der Mitte löschen fällt auf: der Prüflauf bricht an der ersten falschen Stelle ab und nennt Position, entry_id und Event.
Was das nicht leistet: jemand mit vollem Schreibrecht auf die Datenbank kann Einträge und Hashes gemeinsam umschreiben. Dagegen hilft eine Kopie auf einem anderen Host. Die HTTP-Gegenstelle schickt jeden Eintrag an eine URL. Leer bedeutet aus. Die Syslog-Datei liegt auf derselben Maschine wie die Datenbank, ist über die DI abgeschaltet und ist keine unabhängige Kopie.
Reguläres Löschen nach Aufbewahrungsfrist entfernt das älteste Präfix und schreibt in derselben Transaktion die Ursprungsmarke (Hash des zuletzt gelöschten Eintrags). Der Prüflauf verlangt diese Marke und die Spitze der Kette. Ein Schnitt, den das Aufräumen nicht selbst geschrieben hat, schlägt fehl. Ein aufgezeichnetes Aufräumen bleibt gültig.
Wohin die Einträge gehen
Die Datenbank ist die verbindliche Kopie. Der Logging-Modus ist synchron oder asynchron:
- Synchron schreibt im selben Request, atomar unter Sperre, in die Hash-Kette.
- Asynchron publisht auf das Topic
alpenfx.audit.entry(MySQL-Queue, ohne RabbitMQ). Dafür muss der Consumer laufen:bin/magento queue:consumers:start alpenfx.audit.entry. - HTTP-Gegenstelle schickt denselben Eintrag an eine URL außerhalb des Shops, sobald eine URL gesetzt ist. Ein Fehler dort bricht den Schreibvorgang ab. Der Datenbankeintrag bleibt liegen.
Was von selbst im Log landet
Anlegen, Ändern und Löschen von Produkt, Kategorie, Kunde und Kundenadresse schreibt eine Zeile, ebenso eine geänderte Konfiguration. Die Zeile enthält die geänderten Felder mit altem und neuem Wert. Passwort, Token und geheime Konfigurationswerte stehen als [redacted]. Beschreibungen werden nicht mitgeschrieben. Bestellungen schreibt das Modul nicht. Andere Module schreiben zusätzlich über AuditTrailServiceInterface.
Was Sie nicht kaufen
Keine Rechtsberatung und keine Zusage, der Shop sei damit datenschutzrechtlich oder sonst in Ordnung. Das Modul macht Änderungen technisch nachvollziehbar. Die Bewertung bleibt bei Ihnen.
Surfaces
| Fläche | Nutzen |
|---|---|
| Admin | Audit-Log lesen, filtern, exportieren |
| Service-Contract | Andere Module und Kundencode schreiben Events |
| CLI | alpenfx:audit:verify und alpenfx:audit:prune |
| Konfiguration | Retention, PII-Opt-in, Sync/Async, HTTP-Gegenstelle |
Installation (Kurz)
composer require alpenfx/module-audit-trail
bin/magento module:enable AlpenFX_AuditTrail
bin/magento setup:upgrade
Die technische Einrichtung steht in der README im Modul, nicht hier.
Keywords
Magento 2 Audit Log, Magento Audit Trail, Hash-Chain Logging Magento, Magento Konfigurations-Log, Magento Compliance Logging
Verweise auf rechtliche Vorgaben beschreiben, was die Erweiterung tut. Ob ein Shop eine Vorgabe erfüllt, hängt von Konfiguration und Einsatz ab und liegt beim Betreiber. Dies ist keine Rechtsberatung.