Spezifikationen

Verwenden Sie IBM Cloud® Activity Tracker Event Routing, um zu konfigurieren, wie Audit-Ereignisse, sowohl globale als auch standortbezogene Ereignisdaten, in Ihrem IBM Cloud weitergeleitet werden sollen. Die Ereignisse entsprechen dem Standard Cloud Auditing Data Federation (CADF).

Die Activity Tracker Event Routing
Activity Tracker Event Routing

Konto konfigurieren

Um „ Activity Tracker Event Routing “ in Ihrem Konto zu konfigurieren, legen Sie fest, wohin Überwachungsereignisse weitergeleitet und gespeichert werden sollen. Sie müssen mindestens ein Ziel und mindestens eine Route konfigurieren. Außerdem müssen Sie die Kontoeinstellungen konfigurieren.

  • Ein Ziel definiert die Ressource, in der Sie Prüfereignisse speichern können.
  • Eine Route definiert die Regeln, die festlegen, wohin Prüfereignisse in Ihrem Konto weitergeleitet werden.
  • Bei der Konfiguration der Kontoeinstellungen werden Informationen wie Standardziele definiert, auf denen Ereignisse im Konto erfasst werden, die Art der Endpunkte, die die Konfiguration verwalten dürfen, und zulässige Positionen zum Speichern der Daten im Konto.

Sie können globale Ereignisse und standortbezogene Ereignisse erfassen.

  • Globale Ereignisse berichten über Aktivitäten in Ihrem Konto, die sich auf Daten und Ressourcen beziehen, die in der Regel über alle Regionen hinweg synchronisiert werden.
  • Standortbasierte Ereignisse berichten über Aktivitäten in Ihrem Konto, die von IBM Cloud-Services generiert werden, die innerhalb eines IBM-Rechenzentrums-Standorts, wie z. B. USA (Süden) oder USA (Osten), gehostet werden.

Pro Konto können Sie die Region auswählen, in der Ereignisse erfasst werden.

Einstellungen für die Kontokonfiguration

Bei der Konfiguration der Kontoeinstellungen für „ Activity Tracker Event Routing “ können Sie folgende Angaben festlegen:

  1. Der Speicherort in Ihrem „ IBM Cloud “-Konto, an dem die Metadaten zur Konfiguration des „ Activity Tracker Event Routing “-Kontos gespeichert sind.

    Mit Metadaten sind die Daten für Ziele/Routen/Einstellungen gemeint, die im gesamten Konto in jeder beliebigen Region verfügbar sind.

    Sie können einen beliebigen der unterstützten Standorte auswählen, an denen „ Activity Tracker Event Routing “ verfügbar ist. Weitere Informationen finden Sie in Standorte.

    Berücksichtigen Sie alle Compliance-Anforderungen des Unternehmens oder der Branche, wie z. B. Standorte mit der Kennzeichnung "Financial Services Validated" oder von der EU verwaltete Regionen, sowie alle Anforderungen an den Datenspeicherort.

  2. Die Art der Endpunkte, die zur Verwaltung der Konfiguration des „ Activity Tracker Event Routing “-Kontos in diesem Konto berechtigt sind.

    Sie können öffentliche und/oder private Endpunkte konfigurieren.

  3. Die Standorte, an denen ein Kontoadministrator Ziele für die Erfassung von Prüfereignissen definieren kann.

    Sie können einen beliebigen der unterstützten Standorte auswählen, an denen „ Activity Tracker Event Routing “ verfügbar ist. Weitere Informationen finden Sie in Standorte.

    Berücksichtigen Sie alle Compliance-Anforderungen des Unternehmens oder der Branche, wie z. B. Standorte mit der Kennzeichnung "Financial Services Validated" oder von der EU verwaltete Regionen, sowie alle Anforderungen an den Datenspeicherort.

  4. Es gibt ein oder mehrere Ziele im Konto, die Überwachungsereignisse von unterstützten „ Activity Tracker Event Routing “-Standorten erfassen, für die Sie noch nicht festgelegt haben, wie die Überwachungsereignisse weitergeleitet werden sollen.

    Wenn Sie mehrere Ziele definieren, erhalten alle Standardziele eine Kopie der Prüfereignisse, die nicht über eine Routing-Regel verfügen, die angibt, wohin im Konto sie weitergeleitet werden sollen. Sie können bis zu zwei Standardziele pro Konto definieren.

Beachten Sie bei der Konfiguration oder Änderung der Kontoeinstellungen für „ Activity Tracker Event Routing “ die folgenden Hinweise:

  • Jedes Mal, wenn Sie die Einstellungen des „ Activity Tracker Event Routing “-Kontos ändern, ersetzen die in der neuen Anfrage übermittelten Daten alle vorhandenen Konfigurationsdaten. Sie müssen sicherstellen, dass vorhandene Daten nicht gelöscht werden, wenn Sie eine Aktualisierung der Kontoeinstellungen ausführen, indem Sie sie in die neue Anforderung einschließen.

  • Bevor Sie öffentliche Endpunkte durch Festlegen von --private-api-endpoint-only TRUE inaktivieren, stellen Sie sicher, dass Ihr Konto Zugriff auf den privaten Endpunkt hat. Sie können dies tun, indem Sie den Befehl ibmcloud account showausführen. Wenn VRF Enabled auf true gesetzt ist und Service Endpoint Enabled auf true gesetzt ist, haben Sie Zugriff auf den privaten Endpunkt. Wenn Sie keinen Zugriff auf den privaten Endpunkt haben, können Sie den öffentlichen Endpunkt nicht erneut aktivieren, da der private Endpoint-Zugriff erforderlich ist, um den öffentlichen Endpunkt erneut zu aktivieren.

Ziele

Ein Ziel definiert, wo Prüfereignisse erfasst werden.

Beachten Sie die folgenden Informationen zu Zielen:

  • Sie können bis zu 16 Ziele in jedem Konto definieren.

  • Jedes Konto kann bis zu zwei Standardziele aufweisen. Ein Standardziel definiert eine Ressource, an die Prüfereignisse gesendet werden, die nicht explizit in den Routing-Regeln des Kontos verwaltet werden.

  • Ein Ziel kann Folgendes sein:

    • Ein IBM Cloud Object Storage-Bucket (COS)

    • Thema IBM® Event Streams for IBM Cloud®

    • IBM Cloud Logs-Angebot

    • Ein Angebot von „ IBM Cloud App Configuration “

  • Jeder Activity Tracker Event Routing-API-Endpunkt kann auf alle Ziele zugreifen.

  • Ziele werden innerhalb einer Region erstellt, sind jedoch regionsübergreifend sichtbar.

  • Sie können Ziele in demselben Konto, in dem Ereignisse generiert werden, oder in einem anderen Konto definieren.

  • Wenn Sie ein Ziel vom Typ „ Cloud Object Storage “ oder „ Event Streams “ definieren, können Sie zum Hochladen von Ereignissen einen API-Schlüssel oder die Service-to-Service-Authentifizierung verwenden.

  • Sie können Ziele in Ihrem Konto mithilfe der CLI unter Activity Tracker Event Routing verwalten sowie programmgesteuert über die REST-API unter Activity Tracker Event Routing und Terraform-Skripte.

  • Zum Verwalten von Zielen benötigen Sie IAM-Berechtigungen. Weitere Informationen finden Sie unter IAM-Aktionen nach Aufgabe.

In der folgenden Tabelle werden die gültigen Zieltypen beschrieben:

Liste der Ziele
Ziel Typ Weitere Informationen
IBM Cloud Object Storage (COS) cloud_object_storage COS-Ziele verwalten
IBM® Event Streams for IBM Cloud® event_streams IBM® Event Streams for IBM Cloud®-Ziele verwalten
IBM Cloud Logs cloud_logs Cloudprotokollziele verwalten
IBM Cloud App Configuration app_config App Configuration-Ziele verwalten

Routen

Eine Route definiert die Regeln, die angeben, wohin Prüfereignisse, die im Konto generiert werden, weitergeleitet werden.

  • Routen sind unter einem Konto global und werden in allen Regionen ausgewertet, in denen Activity Tracker Event Routing bereitgestellt wird.

  • Routen können von jedem regionalen IBM Cloud® Activity Tracker Event Routing-API-Endpunkt aus verwaltet werden.

  • Für ein Konto können Sie bis zu 30 Routen definieren.

  • Das Konto hat standardmäßig 0 Routen konfiguriert.

  • Pro Route können Sie bis zu 10 Regeln konfigurieren. Eine Routing-Regel gibt die Standorte und zugeordneten Ziele an, an die Prüfereignisse weitergeleitet werden.

  • Sie können bis zu acht Standorte für jede Regel konfigurieren.

  • Sie können für jede Regel bis zu drei Ziele (target_ids) konfigurieren.

  • Routen werden unabhängig voneinander verarbeitet. Wenn Sie mehrere Routen mit Regeln haben, die demselben Ereignis entsprechen, wird dieses Ereignis an mehrere Ziele gesendet.

  • Regeln werden in der angegebenen Reihenfolge verarbeitet. Die erste Abgleichsregel (z. B. location), mit der ein Ereignis übereinstimmt, wird zur Verarbeitung des Ereignisses verwendet. Sobald ein Ereignis verarbeitet wurde, wird es nicht von einer nachfolgenden Regel in der Definition dieser Route verarbeitet. Wenn Sie eine Standardregel für alle Ereignisse angeben wollen, die nicht von anderen Regeln verarbeitet werden, geben Sie die Regel ("locations" : ["*"]) als letzte Regel in Ihrer rules-Definition für die Regel (route) an.

  • Wenn ein Ereignis keiner Regel entspricht und kein Standardziel konfiguriert ist, wird das Ereignis gelöscht und nicht an ein Ziel weitergeleitet.

  • Jede Aktualisierung einer rules-Konfiguration muss alle Regeln des Typs location enthalten. Eine Aktualisierung löscht den vorhandenen Regelsatz und ersetzt ihn durch die angegebene Konfiguration.

  • Sie können Routen in Ihrem Konto mithilfe der CLI unter Activity Tracker Event Routing verwalten sowie programmgesteuert mithilfe der REST-API unter Activity Tracker Event Routing und Terraform-Skripten.

  • Zum Verwalten von Routen benötigen Sie IAM-Berechtigungen. Weitere Informationen finden Sie unter Activity Tracker Event Routing-Aktionen.

Prüfereignisse erfassen

Um Audit-Ereignisse in Ihrem „ IBM Cloud “-Konto zu erfassen, können Sie „ Activity Tracker Event Routing “ mithilfe der „ Activity Tracker Event Routing “-API, der „ Activity Tracker Event Routing “-CLI und Terraform-Skripten konfigurieren.

Weitere Informationen finden Sie unter Sammeln von Ereignissen.