Logging der Audit-Actions
Der CARA Server erlaubt das separate Logging der gespeicherten Audit-Actions..
Das Audit-Action-Logging verwendet den Log4j Mapped Diagnostic Context, um eine frei konfigurierbare Auswahl der im Logfile ausgegebenen Daten zu unterstützen.
Vorgehensweise
-
Definieren Sie in der Datei
log4j.xmlfür CARA-WS einen separaten Appender für das Logging der Audit-Events. Geben Sie diesem Appender einen eindeutigen Namen. -
Achten Sie darauf, in der Appender-Definition eine separate Datei für die Audit-Event-Log-Ausgabe anzugeben (falls es sich um einen Datei-basierten Appender handelt).
-
Bei Verwendung von
FileAppenderbesteht die Möglichkeit, das Logfile entweder bei jeder Initialisierung von Log4j zu überschreiben oder neue Einträge hinten anzuhängen. Hierzu dient ein XML-Element<param name="Append" value="true|false"/>. -
Definieren Sie innerhalb des Appenders ein Layout der Klasse
org.apache.log4j.PatternLayout. Dieses unterstützt einen Parameter mitname="ConversionPattern". Der Wert dieses Parameters ist ein Template für die auszugebenden Log-Messages. -
Den Wert eines Platzhalters können Sie in der Form
%X{Platzhaltername}an beliebiger Stelle in dasConversionPatterneinfügen. -
Definieren Sie einen neuen Logger mit
name="AUDIT_ACTION_LOGGER". Sein Log-Level muss auf INFO gestellt sein, da alle Messages mit diesem Level ausgegeben werden. Der Logger muss mittels<appender-ref>auf den neuen Appender verweisen. -
Um die Audit-Event Log-Ausgaben ausschließlich an den dedizierten Appender zu leiten, verwenden Sie im
<logger>-Tag das XML-Attributadditivity="false".
Beispiel
Ein Beispiel für eine Log4j-Konfiguration befindet sich im Lieferumfang des CARA-Servers in der Datei log4j.default.xml.
-
Beispiel-Appender:
AUDIT_ACTION_LOGGER_FILE -
Beispiel-Logger:
AUDIT_ACTION_LOGGER
Unterstützte MDC-Platzhalter
Je Audit-Action-Log-Message werden folgende Werte im MDC registriert:
| Platzhaltername | Beschreibung |
|---|---|
|
CARA-Datenbank-ID der gespeicherten Audit-Action |
|
CARA-Konfiguration der gespeicherten Audit-Action |
|
CARA-Datenbank-ID des zugehörigen Audit-Events |
|
CARA-Datenbank-ID des zugehörigen Workflow-Events |
|
ID des ausführenden Moduls in der CARA-Datenbank |
|
Name des ausführenden Moduls in der CARA-Datenbank. |
|
Statuscode der gespeicherten Audit-Action. |
|
Bezeichnung des Statuscode der gespeicherten Audit-Action Mögliche Werte:
|
Viele Werte sind optional. Sind diese nicht gesetzt, wird dies durch folgenden Text angezeigt: (null)
|