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: Modul ein/aus, Logging-Modus synchron oder Message-Queue, PII-Opt-in (IP und Akteur), Aufbewahrungsfrist.
• 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. Dann braucht es eine Kopie außerhalb der Shop-Datenbank — die optionale Syslog-/Datei-Senke ist dafür da, liegt aber standardmäßig aus und wird per DI eingeschaltet, nicht über den Logging-Modus.

Reguläres Löschen nach Aufbewahrungsfrist entfernt das älteste Präfix. Der Prüflauf bewertet danach die verbliebene Kette ab dem ältesten noch vorhandenen Eintrag — Aufräumen sieht nicht wie Manipulation aus.

Wohin die Einträge gehen

Die Datenbank ist die verbindliche Kopie. Der Logging-Modus ist synchron oder asynchron, nicht „Datenbank / Syslog / beides“:

• 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.

Was das Modul nicht von selbst tut

Es beobachtet keine Magento-Core-Events (Katalog, Kunden, Bestellungen). Andere Module und eigener Code schreiben über AuditTrailServiceInterface. Das ist das Fundament, kein fertiges Protokoll jeder Admin-Änderung.

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

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, revisionssicheres Logging Magento, Magento Compliance Logging