> 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.5/zusaetze/audit-trail.md).
# Audit Trail
{% hint style="info" %}
Der optionale "JUNE5 Audit Trail Service" wird nur benötigt wenn JUNE5 DataTrans Audit Trail Daten eingelesen werden müssen.
{% endhint %}
JUNE5 liefert nach der Installation des Audit Trail einen weiteren Dienst „JUNE5 Audit Trail Service“ mit. Aufgabe des Dienstes ist die Nettodaten für einen Audit Trail zu sammeln und in die JUNE5 Datenbank zu schreiben. Mit einem passenden Ereignisobjekt bzw. Auditobjekt kann dann eine Auswertung des Audit Trails im JUNE5 erfolgen.
Der Dienst „JUNE5 Audit Trail Service“ führt beim ersten Start folgende Aktivitäten durch:
* Liest seine Einstellungen ein (ConfigurationModel.json)
* Erstellt eine Verbindung zu JUNE5 Datenbank her
* Erstellt falls nicht vorhanden die Tabelle „AuditTrial“
* Erstellt falls nicht vorhanden den View „ViewAudit“
Danach werden folgende Aktionen durchgeführt
* Liest alle Dateien der definierten Verzeichnisse aus „Folder2Observe“ ein
* Erstellt den Audit Trail in der JUNE5 Datenbank
{% hint style="info" %}
Audit Trail wird nur unterstützt in Verbindung mit einem SQL Server. Die LocalDB Datenbank wird nicht unterstützt.
{% endhint %}
## 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 = Ereginis Spalten ID aus JUNE5
Entspricht der eindeutigen ID aus der Ereignisdefinition. Diese Definition ist fest im JUNE5 verankert. Siehe [„Ereignisdefinition“](/june5-3.5/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:
|
|
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\JUNE5PORTAL"*
* Aktivieren Sie die *"Integrierte Sicherheit von Windows"*
* Speichern Sie die Änderungen und testen Sie anschließend die Verbindung
### 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"*
### 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.5/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.