Prüfungsereignisse

Abfrage-Prüfungsereignisse

/api/v1/audit_events/query

Erforderliche Berechtigungen: Prüfungsprotokolle lesen.

• Bash

  curl -X POST 'https://<my_api_endpoint>/api/v1/audit_events/query' \
      -H "Authorization: Bearer $REINFER_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
    "filter": {
      "timestamp": {
        "maximum": "2021-07-10T00:00:00Z",
        "minimum": "2021-06-10T00:00:00Z"
      }
    }
  }'

• Knoten

  const request = require("request");
  
  request.post(
    {
      url: "https://<my_api_endpoint>/api/v1/audit_events/query",
      headers: {
        Authorization: "Bearer " + process.env.REINFER_TOKEN,
      },
      json: true,
      body: {
        filter: {
          timestamp: {
            maximum: "2021-07-10T00:00:00Z",
            minimum: "2021-06-10T00:00:00Z",
          },
        },
      },
    },
    function (error, response, json) {
      // digest response
      console.log(JSON.stringify(json, null, 2));
    }
  );

• Python

  import json
  import os
  
  import requests
  
  response = requests.post(
      "https://<my_api_endpoint>/api/v1/audit_events/query",
      headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
      json={
          "filter": {
              "timestamp": {
                  "minimum": "2021-06-10T00:00:00Z",
                  "maximum": "2021-07-10T00:00:00Z",
              }
          }
      },
  )
  
  print(json.dumps(response.json(), indent=2, sort_keys=True))

• Antwort

  {
    "audit_events": [
      {
        "actor_user_id": "e2148a6625225593",
        "dataset_ids": ["1fe230edc85ffc1a"],
        "event_id": "2555880060c23eb5",
        "event_type": "get_datasets",
        "project_ids": ["ce3c61dcf210f425", "274400867ab17af9"],
        "tenant_ids": ["c59b6e209da438a8"],
        "timestamp": "2021-06-10T16:32:53Z"
      }
    ],
    "continuation": "2555880060c23eb5",
    "datasets": [
      {
        "id": "1fe230edc85ffc1a",
        "name": "collateral-sharing",
        "project_id": "ce3c61dcf210f425",
        "title": "Collateral Sharing"
      },
      {
        "id": "274400867ab17af9",
        "name": "Customer-Feedback",
        "project_id": "ce3c61dcf210f425",
        "title": "Customer Feedback"
      }
    ],
    "projects": [
      {
        "id": "ce3c61dcf210f425",
        "name": "bank-collateral",
        "tenant_id": "c59b6e209da438a8"
      }
    ],
    "status": "ok",
    "tenants": [
      {
        "id": "c59b6e209da438a8",
        "name": "acme"
      }
    ],
    "users": [
      {
        "display_name": "Alice",
        "email": "[e-mail]",
        "id": "e2148a6625225593",
        "tenant_id": "c59b6e209da438a8",
        "username": "alice"
      }
    ]
  }

Ein Prüfungsereignis ist eine Aufzeichnung einer Aktion, die von einem Benutzer der Communications Mining-Plattform ausgeführt wird. Beispiele für überprüfbare Ereignisse sind:

• ein Benutzer, der sich anmeldet
• ein Benutzer, der sein Kennwort ändert
• ein Benutzer, der die Berechtigungen eines anderen Benutzers ändert

Name	Typ	Erforderlich	BESCHREIBUNG
continuation	string	nein	Wenn eine vorherige Abfrage ein continuation in der Antwort zurückgegeben hat, ist eine andere Seite mit Ereignissen verfügbar. Legen Sie den zurückgegebenen Fortsetzungswert hier fest, um die nächste Seite abzurufen.
limit	Nummer	nein	Die Anzahl der Prüfungsereignisse, die pro Seite zurückgegeben werden sollen. Der Standardwert ist 128.
filter	Filter	nein	Ein Filter, der angibt, welche Prüfungsereignisse zurückgegeben werden sollen.

Dabei hat Filter das folgende Format:

Name	Typ	Erforderlich	BESCHREIBUNG
timestamp	Zeitstempelfilter	nein	Ein Filter, der angibt, in welchem Zeitbereich Ereignisse zurückgegeben werden sollen.

Dabei hat TimestampFilter das folgende Format:

Name	Typ	Erforderlich	BESCHREIBUNG
minimum	string	nein	Ein ISO-8601-Zeitstempel. Wenn angegeben, wird nur ein Prüfungsereignis nach oder einschließlich dieses Zeitstempels zurückgegeben.
maximum	string	nein	Ein ISO-8601-Zeitstempel. Wenn angegeben, wird nur ein Prüfungsereignis vor diesem Zeitstempel zurückgegeben.

Antwortformat

Die Liste der Prüfungsereignisse finden Sie unter dem Schlüssel audit_events auf der obersten Ebene der Antwort. Jeder AuditEvent kann anhand der ID auf andere Ressourcen verweisen (z. B. Quellen, Datasets, Benutzer usw.). Für jede referenzierte Ressource finden Sie zusätzliche Informationen unter dem jeweiligen Schlüssel (sources, datasets, users usw.) auf der obersten Ebene der Antwort.

Ein AuditEvent stellt eine Aktion dar, die von einem Benutzer auf der Plattform ausgeführt wird, und hat das folgende Grundformat. Je nach Wert von event_type können zusätzliche Schlüssel vorhanden sein. Beispielsweise enthält ein get_datasets -Prüfungsereignis eine Liste von dataset_ids , die vom Benutzer gelesen wurden.

Name	Typ	BESCHREIBUNG
event_id	string	Die eindeutige ID dieses Termins.
event_type	string	Der Typ dieses Ereignisses.
timestamp	string	Der ISO-8601-Zeitstempel dieses Ereignisses auf die nächste Sekunde genau.
actor_user_id	string	Die ID des Benutzers, der diese Aktion ausgeführt hat.
actor_tenant_id	string	Die Mandanten-ID des Benutzers, der diese Aktion ausgeführt hat.

Wenn die Antwort schließlich einen continuation -Schlüssel enthält, sollten Sie die nächste Seite der Ereignisse abrufen, indem Sie das Feld continuation in der Anforderung auf diesen Wert festlegen.