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

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

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