> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/june5-3.7/zusaetze/audit-trail.md). # Audit Trail Audittrail Informationen sind bei der GxP Edition automatisch aktiviert und werden protokolliert. Mit dem Auditrail hat der Anwender die Möglichkeit folgende Daten in einem Ereignisobjekt in Form einer Tabelle abzurufen: * Loginvorgänge (Einloggen, Ausloggen und Einlogversuche) * Laufzeitveränderungen am System (z.B. Starten und Beenden des JUNE5 Servers) * Konfigurationsänderungen an Objekten (CRUD Operationen wie Create, Update und Delete) * Konfigurationsänderungen an Datenquellen ## Nettodaten Informationen Intern werden vom JUNE5 netto Daten für das Audit Trail erzeugt. | ID | Typ | Beschreibung | | -------------- | ------------------------- | -------------------------------------------------------------------- | | HistoryCreated | datetime2 (7) NOT NULL | Erstellungszeitpunkt des Audit Eintrages in der Quelle | | HistoryGetIn | datetime2 (7) NOT NULL | Erstellungszeitpunkt des Audit Eintrages in der Datenbank | | AuditUid | uniqueidentifier NOT NULL | Audit UID | | Action | nvarchar (max) NULL | Action wie CREATE, UPDATE, DELETE, Login, Logout, Start, Stop | | Category | int NOT NULL | 1 = Administrative, 2 Operational | | Owner | nvarchar (max) NULL | Benutzer der den Eintrag erzeugt hat (z.B. Admin, User123) | | OwnerType | nvarchar (max) NULL | Dienst der den Eintrag erzeugt hat (z.B. User, Service) | | ObjectName | nvarchar (max) NULL | Objektname z.B. Chart123, T234 | | ObjectUid | uniqueidentifier NULL | Objekt UID, eindeutige ID z.B. eed1cfb4-80e5.. | | ObjectType | nvarchar (max) NULL | Objekttyp, z.B. Chart, Dashboard | | PropertyName | nvarchar (max) NULL | Eigenschaftsname z.B. Name, Port, Color | | PropertyType | nvarchar (max) NULL | Eigenschaftstyp z.B. String, Int, Long, Color, ... | | OldValue | nvarchar (max) NULL | Alter Wert | | NewValue | nvarchar (max) NULL | Neuer Wert | | Information | nvarchar (max) NULL | Zusätzliche Information, z.B. OK, Failed, Beschreibung, Meldung usw. | Alle Nettodaten werden in der AuditTrail Tabelle abgelegt. ## Mapping Das Mapping wird benötigt damit Nettodaten lesbar gestaltet werden. Hier gibt es unterschiedliche Sichtweisen. #### A = Auditor Sicht desjenigen der den Audittrail sehen möchte, er kennt die Begrifflichkeiten eines Audittrails. #### B = Ereignis Spalten ID aus JUNE5 Entspricht der eindeutigen ID aus der Ereignisdefinition. Diese Definition ist fest im JUNE5 verankert. Siehe [„Ereignisdefinition“](/june5-3.7/datenquellenunterstuetzung-und-einbindung/microsoft-ole-db/sql-tabelle-ereignisse.md) im JUNE5 Handbuch. #### C = Audittabelle Die Spalten aus der o.g. Audittrail Tabelle. Für den Audittrail benötigte Spalten werden zusammengefasst zu: |

A

Begriffe des Auditors

|

B

Definition JUNE5 Ereignistabelle

|

C

Audittabelle in JUNE5 Datenbank

| | ------------------------------------ | ----------------------------------------------- | ------------------------------------------------------------- | | Zeitstempel | TimestampFrom | HistoryCreated | | Kategorie | Category | Category | | User ID | UserName | Owner + OwnerType | | Tätigkeit | Status | Action | | Parameter-ID | ItemName | ObjectName + ObjectType | | Altwert, Neuwert, Info | ItemDescription |

PropertyName + OldValue +

NewValue + Information

| In der JUNE5 Datenbank wird mittels eines Views „ViewAudit“ eine Sicht für den Auditor generiert. ## Konfiguration des Audittrails Die Konfiguration des Audit Trails erfolgt in *drei* Schritten: 1. Endpunkt OLE DB anlegen 2. Konfigurieren der Datenquelle 3. Ereigniskonfiguration ### Schritt 1 - Endpunkt OLE DB * Ändern Sie die Identifikation auf *"Audit"* * Ändern Sie den Namen auf *"Audit"* * Ändern Sie den Datenbankinstnznamen auf *"localhost\JUNE5PORTAL2022"* * Aktivieren Sie die *"Integrierte Sicherheit von Windows"* * Speichern Sie die Änderungen und testen Sie anschließend die Verbindung ![](/files/H0eefINk40mHmxmQWyr0) ### Schritt 2 - Konfigurieren der Datenquelle Gehen Sie zu Datenquellen konfigurieren und wählen die Datenquelle *"Audit*" aus. * Ändern Sie die Identifikation zu *"SQLAudit"* * Ändern Sie den Namen zu "*SQL Audit"* * Gehen Sie zur *"Ereigniskonfiguration"* ![](/files/GF6ZRzyLIrW5diSqFm5s) ### Schritt 3 - Ereigniskonfiguration Erstellen Sie im JUNE5 eine Ereigniskonfiguration, damit in einem JUNE5 Ereignisobjekt, die Auditinformationen aus dem View „ViewAudit“ dargestellt werden können. * Aktivieren Sie den Haken "Spaltennamen werden durch.." * Tragen Sie bei "SQL-Befehl Ereignis" den SQL Befehl "SELECT \* FROM ViewAudit" ein * Drücken Sie die Schaltfläche "Spaltennamen ermitteln" * Setzen Sie nun die Spaltennamen wie in dem Screenshot dargestellt
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.videc.de/june5-3.7/zusaetze/audit-trail.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.