Erweiterte Audit-Funktionen
Zweck
Diese Referenz beschreibt die Ereignis-Nutzdaten, die Ihre Audit-Daten enthalten können. Das erweiterte Audit ist sowohl in iGrafx Cloud als auch in On-Premises-Installationen verfügbar. Nur die Art, wie Sie auf die Daten zugreifen und sie abrufen, unterscheidet sich.
Festlegen, was auditiert wird
Die Plattform zeichnet die auf dieser Seite beschriebenen Ereignisse nur auf, solange Prüfeinstellungen auf Prüfung ein steht. Die Stufen, die Voreinstellung pro Kanal und die erforderliche Berechtigung finden Sie unter Prüfeinstellungen. Bei einer On-Premises-Installation schreibt Prüfung ein außerdem jedes Ereignis in lokale Logdateien auf dem Anwendungsserver – siehe Dateibasierte Audit-Protokollierung.
Auf die Audit-Daten zugreifen
In der Verwaltungsoberfläche exportiert Prüfdaten herunterladen unter Prüfeinstellungen die Ereignisse für einen Zeitraum und optionale Filter als JSON-Lines-Datei (JSONL) – ein Ereignis pro Zeile, im Format unter Allgemeine Struktur der Nutzdaten. Die Schritte finden Sie unter Audit-Ereignisse exportieren. Der Rest dieses Abschnitts behandelt die REST API.
Die REST API abfragen
Sie können die Audit-Informationen über die REST API der Anwendung iGrafx Process Design abfragen.
Der allgemeine Endpunkt zum Abrufen Ihrer Audit-Informationen lautet
https://YOUR_PLATFORM_URL/api/auditevents
In iGrafx Cloud ist YOUR_PLATFORM_URL gleich YOUR_SUBDOMAIN.igrafxcloud.com.
Der Aufrufer benötigt die Serverberechtigungen Auf REST-API zugreifen und Auf Supportfunktionen zugreifen. Bei einer On-Premises-Installation ist die REST API ausgeschaltet, bis ein Administrator API aktivieren einschaltet – siehe Auf die REST API zugreifen.
Ein Aufruf ohne Abfrageparameter liefert die Audit-Informationen der letzten 24 Stunden, das neueste Ereignis zuerst, im unten unter Allgemeine Struktur der Nutzdaten beschriebenen Datenformat.
Abfrageparameter
| Parameter | Wert | Standard | Funktion |
|---|---|---|---|
secondThreshold | Ganze Anzahl Sekunden | 86400 (24 Stunden) | Legt die Länge des Zeitraums fest, zurückgerechnet ab eventsBefore – oder ab dem Zeitpunkt der Anfrage, wenn eventsBefore fehlt. |
eventsBefore | UTC-Zeitstempel im ISO-8601-Format mit dem Suffix Z, zum Beispiel 2026-04-01T00:00:00Z | Der Zeitpunkt der Anfrage | Legt das Ende des Zeitraums fest. secondThreshold wird von diesem Zeitstempel abgezogen, um den Beginn des Zeitraums zu erhalten. |
eventType | Ein oder mehrere Ereignistypen, etwa create-user | Alle Ereignistypen | Liefert nur Ereignisse, deren Typ einem der angegebenen Werte entspricht. Die Werte finden Sie in der Spalte „Ereignistyp“ unter Verfügbare Ereignisdaten. |
eventCategory | Eine oder mehrere Ereigniskategorien, etwa SECURITY | Alle Kategorien | Liefert nur Ereignisse, deren Kategorie einem der angegebenen Werte entspricht. Die Werte finden Sie in der Spalte „Kategorie“ unter Verfügbare Ereignisdaten. |
So verhalten sich die Parameter:
- Beide Enden des Zeitraums sind eingeschlossen.
- Um mehr als einen Wert an
eventTypeodereventCategoryzu übergeben, trennen Sie die Werte entweder mit Kommas –?eventType=create-user,delete-user– oder wiederholen Sie den Parameter –?eventType=create-user&eventType=delete-user. Beide Formen liefern Ereignisse, die einem der angegebenen Werte entsprechen. - Verwenden Sie für einen Parameter entweder die eine oder die andere Form. Eine Anfrage, die beide mischt, behandelt die kommagetrennten Werte als einen einzigen Wert, der keinem Ereignis entspricht.
- Ein Ereignis muss jeden gesendeten Parameter erfüllen: Es muss in den Zeitraum fallen, einem der
eventType-Werte entsprechen und einem dereventCategory-Werte entsprechen. Lassen Sie einen Parameter weg, um diese Einschränkung aufzuheben.
Die Ereignisse als JSON-Lines-Datei herunterladen
Seit 20.3.0 kann derselbe Endpunkt die Ereignisse statt als JSON-Array als JSONL-Datei liefern – im Format, das die Verwaltungsoberfläche exportiert. Senden Sie die Anfrage mit dem Header Accept: application/x-ndjson:
GET https://YOUR_PLATFORM_URL/api/auditevents
Accept: application/x-ndjson
Die Antwort ist ein Dateidownload namens iGrafxPlatform-AuditData-<timestamp>.jsonl mit einem Ereignis pro Zeile im Format unter Allgemeine Struktur der Nutzdaten. Abfrageparameter und Berechtigungen sind dieselben wie oben, mit zwei Unterschieden:
- Prüfung ein muss gelten. Bei jeder anderen Einstellung schlägt die JSONL-Anfrage fehl, während die JSON-Form weiterhin die Ereignisse liefert, die vor der Änderung der Einstellung aufgezeichnet wurden.
secondThresholddarf 30 Tage nicht überschreiten.
Allgemeine Struktur der Nutzdaten
Jedes Audit-Ereignis hat die folgende Datenstruktur sowie benutzerdefinierte Daten, die für den jeweiligen Typ und die Kategorie des Ereignisses relevant sind. Dieser Abschnitt beschreibt die allgemeine Struktur. Die Tabellen unter Verfügbare Ereignisdaten zeigen Beispiele für bestimmte Audit-Ereignisse.
Grundlegende Nutzdaten eines Audit-Ereignisses
{
"uuid": "558ff7b4-7fd2-459c-9b2d-4a3d5d0fc306",
"eventType": "loginsuccess",
"eventCategory": "SECURITY",
"eventData": {},
"timestamp": "2023-08-08T04:26:58.919+00:00",
"principal": "firstname.lastname@company.com",
"authenticationType": "OAUTH2",
"hostname": "abcdef123456",
"platformVersion": "18.3.1.925-develop",
"platformUuid": "fdc8450e-7774-4c8c-88ee-a0f6162aa616",
"tenantId": "abcd1234"
}
Die Felder sind:
| Feldname | Inhalt/Zweck |
|---|---|
uuid | Enthält eine eindeutige Kennung des Ereignisses |
eventType | Konkreter Ereignistyp (siehe Spalte „Ereignistyp“ in den Tabellen unten) |
eventCategory | Kategorie des Ereignisses (siehe Spalte „Kategorie“ in den Tabellen unten) |
eventData | Benutzerdefinierte Nutzdaten, die sich je Ereignis unterscheiden (siehe die Tabellen unten) |
timestamp | Der Zeitstempel des Ereignisses, entweder als ISO-8601-Zeichenfolge oder als numerischer Zeitstempel |
principal | Der authentifizierte Benutzer oder die Entität, die das Ereignis ausgelöst hat |
authenticationType | Die Art der Authentifizierung, die der Principal bei diesem Ereignis verwendet hat (siehe Spalte authenticationType in der Tabelle unten).Die Eigenschaft authenticationType liefert sicherheitsrelevante Informationen. |
hostname | Der Name des Hosts der Process-Design-Instanz. Die Eigenschaft hostname ist hauptsächlich für interne Zwecke und für Kunden mit mehreren Bereitstellungen bzw. Servern implementiert. Für die meisten Kunden ist sie nicht relevant. |
platformVersion | Die Version, mit der die Process-Design-App zum Zeitpunkt des Ereignisses lief |
platformUuid | Enthält die eindeutige Kennung der Process-Design-Instanz |
tenantId | Die eindeutige Mandantenkennung der Process-Design-Instanz (falls vorhanden). Die Eigenschaft tenantId ist hauptsächlich für interne Zwecke und für Kunden mit mehreren Bereitstellungen bzw. Servern implementiert. Für die meisten Kunden ist sie nicht relevant. |
Authentifizierungstyp
| authenticationType | Beschreibung |
|---|---|
BASIC* | Dieser Authentifizierungstyp steht für eine „einfache“ Anmeldung mit Benutzername und Passwort |
OAUTH2 | Wenn sich der Principal mit OAuth2 bei Process DesignProcess Design Die Disziplin, Geschäftsprozesse explizit zu modellieren, um sie zu dokumentieren, zu analysieren und zu optimieren. In Process360 Live ist Process Design die Seite der Erstellung, die die datengetriebene Sicht des Minings ergänzt. authentifiziert |
SAML | Wenn sich der Principal mit SAMLSAML Ein XML-basierter Standard für den Austausch von Authentifizierungs- und Autorisierungsdaten zwischen einem Identitätsanbieter und einem Dienstanbieter. Process360 Live unterstützt SAML 2.0 für SSO. bei Process DesignProcess Design Die Disziplin, Geschäftsprozesse explizit zu modellieren, um sie zu dokumentieren, zu analysieren und zu optimieren. In Process360 Live ist Process Design die Seite der Erstellung, die die datengetriebene Sicht des Minings ergänzt. authentifiziert |
APP_TOKEN | iGrafx Access Management Service |
API_KEY | Wenn sich der Principal mit einem API-Schlüssel bei Process DesignProcess Design Die Disziplin, Geschäftsprozesse explizit zu modellieren, um sie zu dokumentieren, zu analysieren und zu optimieren. In Process360 Live ist Process Design die Seite der Erstellung, die die datengetriebene Sicht des Minings ergänzt. authentifiziert |
SYSTEM | Für interne bzw. automatisierte Aktionen von Process DesignProcess Design Die Disziplin, Geschäftsprozesse explizit zu modellieren, um sie zu dokumentieren, zu analysieren und zu optimieren. In Process360 Live ist Process Design die Seite der Erstellung, die die datengetriebene Sicht des Minings ergänzt. |
* Wenn sich der Authentifizierungstyp nicht ermitteln lässt, wird der Authentifizierungstyp BASIC verwendet.
Verfügbare Ereignisdaten
Zusätzlich zu den oben aufgeführten allgemeinen Feldern kann jede Aktion weitere Informationen enthalten:
USER_MANAGEMENT
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Lokalen Benutzer in der Plattform erstellen |
|
|
|
Benutzerdetails in der Plattform aktualisieren |
|
|
|
Benutzer in der Plattform löschen |
|
|
|
OBJECTS
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Zu einer Objektregisterkarte im Modellbereich der Plattform navigieren |
|
|
|
Massenvorgang angefordert |
|
|
|
DIAGRAMMING
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Webdiagramm anzeigen |
|
|
|
NARRATIVE
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Vollständigen Prozesssteckbrief eines Diagramms anzeigen |
|
|
|
SOP-Prozesssteckbrief eines Diagramms anzeigen |
|
|
|
Symbolsteckbrief anzeigen |
|
|
|
Pfad-Prozesssteckbrief anzeigen |
|
|
|
SECURITY
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Erfolgreiche Anmeldung |
|
|
Nicht zutreffend |
SETTINGS
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Ändern eines Feature-Flags über die API |
|
|
|
Lesen des Feature-Flag-Status |
|
|
|
Feature-Flag für ein Repository gesetzt |
|
|
*Das Array **Hier werden nur die Änderungen der Repositorien für das Feature-Flag auditiert. Das Ein- oder Ausschalten des Feature-Flags wird weiterhin unter |
Eine neue Servereinstellung wird erstellt |
|
|
*Werte vertraulicher Einstellungen werden unkenntlich gemacht als: |
Eine Servereinstellung wird aktualisiert |
|
|
*Werte vertraulicher Einstellungen werden unkenntlich gemacht als: |
Eine Servereinstellung wird gelöscht |
|
|
*Werte vertraulicher Einstellungen werden unkenntlich gemacht als: |
Eine Repository-Einstellung wird erstellt |
|
|
*Die Ausgangswerte, die beim Installieren, Registrieren oder Aktualisieren eines Repositorys geschrieben werden, werden nicht auditiert. Die internen Variablen des Repositorys – Kennung, Version, Zeitstempel und Migrationsmarkierungen – werden nie auditiert, unabhängig davon, was sie ändert. |
Eine Repository-Einstellung wird aktualisiert |
|
|
*Eine Aktualisierung, die den Wert speichert, den die Einstellung bereits hatte, wird nicht auditiert. |
Eine Repository-Einstellung wird gelöscht |
|
|
|
Der Text der benutzerdefinierten Pia-Anweisungen wird gespeichert oder geleert |
|
|
Nicht zutreffend *Der Anweisungstext wird nie aufgezeichnet. |
Dateien mit benutzerdefinierten Pia-Anweisungen werden hochgeladen |
|
|
*Ein Eintrag pro gespeicherter Datei. Eine Datei, die der Upload nicht speichern konnte, fehlt, und ein Upload, der keine Dateien speichert, wird nicht auditiert. Dateinamen werden bis auf die ersten drei und letzten drei Zeichen des Namens vor der Dateiendung maskiert. Ein Name mit sechs oder weniger Zeichen vor der Dateiendung wird vollständig unkenntlich gemacht. |
Eine Datei mit benutzerdefinierten Pia-Anweisungen wird entfernt |
|
|
*Enthält den Namen der entfernten Datei, in derselben Form wie beim Upload. Der Dateiname wird auf dieselbe Weise maskiert wie beim Upload. Ein fehlgeschlagenes Entfernen wird nicht auditiert. |
ROLE_MANAGEMENT
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Serverrolle erstellt |
|
|
|
Serverrolle aktualisiert |
|
|
*Die Rechte umfassen die gesamte Liste der zum Zeitpunkt der Aktualisierung gewährten Berechtigungen. |
Serverrolle gelöscht |
|
|
*Die Rechte umfassen die gesamte Liste der zum Zeitpunkt des Löschens gewährten Berechtigungen. |
Serverrolle einem Benutzer bzw. einer Gruppe zugewiesen |
|
|
* |
Serverrolle von einem Benutzer bzw. einer Gruppe entfernt |
|
|
* |
Repository-Rolle erstellt |
|
|
|
Repository-Rolle aktualisiert |
|
|
*Die Rechte umfassen die gesamte Liste der zum Zeitpunkt der Aktualisierung gewährten Berechtigungen. |
Repository-Rolle gelöscht |
|
|
*Die Rechte umfassen die gesamte Liste der zum Zeitpunkt des Löschens gewährten Berechtigungen. |
Repository-Rolle einem Benutzer bzw. einer Gruppe zugewiesen |
|
|
* **Der Block |
Repository-Rolle von einem Benutzer bzw. einer Gruppe entfernt |
|
|
* **Der Block |
Elementrolle erstellt |
|
|
|
Elementrolle aktualisiert |
|
|
*Die Rechte umfassen die gesamte Liste der zum Zeitpunkt der Aktualisierung gewährten Berechtigungen. |
Elementrolle gelöscht |
|
|
*Die Rechte umfassen die gesamte Liste der zum Zeitpunkt des Löschens gewährten Berechtigungen. |
Elementrolle einem Benutzer oder einer Gruppe zugewiesen |
|
|
* |
Zuweisung einer Elementrolle an einen Benutzer oder eine Gruppe aufgehoben |
|
|
* |
GROUP_MANAGEMENT
Einige Aktionen der Gruppenverwaltung werden von automatisierten Systemen erstellt. Diese Aktionen können besondere Principals haben, die angeben, wie die Aktion ausgeführt wurde (zum Beispiel die iGrafx IdentityiGrafx Identity Der Identitäts- und Zugriffsverwaltungsdienst von iGrafx, der die Authentifizierung zwischen den Identitätsanbietern der Kunden und den Komponenten von Process360 Live vermittelt. Solution oder LDAP). Diese Principals beruhen auf den zugrunde liegenden Technologien und zeigen möglicherweise nicht das, was Sie erwarten. Zum Beispiel kann eine Anmeldung mit SAMLSAML Ein XML-basierter Standard für den Austausch von Authentifizierungs- und Autorisierungsdaten zwischen einem Identitätsanbieter und einem Dienstanbieter. Process360 Live unterstützt SAML 2.0 für SSO. über die iGrafx IdentityiGrafx Identity Der Identitäts- und Zugriffsverwaltungsdienst von iGrafx, der die Authentifizierung zwischen den Identitätsanbietern der Kunden und den Komponenten von Process360 Live vermittelt. Solution den Principal SYSTEM: OAuth2 zeigen, weil die zugrunde liegende Technologie OAuth2 ist.
Gruppenänderungen aus einem synchronisierten LDAP-Verzeichnis werden nicht auditiert: Wenn die Synchronisierung eine Gruppe erstellt, umbenennt oder entfernt, um sie an das Verzeichnis anzugleichen, wird kein Ereignis create-group, update-group oder delete-group aufgezeichnet.
Jede in diesen Ereignissen gemeldete Gruppe trägt die directoryId und den directoryName des Benutzerverzeichnisses, zu dem sie gehört. So lassen sich gleichnamige Gruppen in verschiedenen Verzeichnissen unterscheiden.
Benutzeraktion |
Ereignistyp |
Kategorie |
eventData-Nutzdaten |
|---|---|---|---|
Eine Gruppe wird erstellt |
|
|
|
Eine Gruppe wird umbenannt |
|
|
|
Eine Gruppe wird gelöscht |
|
|
* *Das Löschen eines Benutzerverzeichnisses entfernt jede Gruppe darin und löst pro entfernter Gruppe ein Ereignis |
Ein Benutzer wird einer Gruppe hinzugefügt |
|
|
*Nicht auditiert werden neu erstellte Benutzer, die zur Gruppe „Alle“ hinzugefügt werden, sowie die anfängliche Zuweisung für den Systemadministrator. |
Ein Benutzer wird aus einer Gruppe entfernt |
|
|
|
Eine Gruppe wird einer Gruppe hinzugefügt |
|
|
|
Eine Gruppe wird aus einer Gruppe entfernt |
|
|
|