BeyondTrust Secure Remote Access-Logs (früher BeyondTrust Privileged Remote Access) erfassen

Unterstützt in:

Google SecOps SIEM

In diesem Dokument wird beschrieben, wie Sie BeyondTrust Secure Remote Access-Logs (früher BeyondTrust Privileged Remote Access) mit Bindplane in Google Security Operations aufnehmen.

BeyondTrust Secure Remote Access ist eine Lösung für die Berechtigungsverwaltung, mit der Unternehmen den privilegierten Remote-Zugriff für Anbieter, Auftragnehmer und interne Administratoren, die eine Verbindung zu kritischen Systemen herstellen, steuern, überwachen und prüfen können. Es bietet die Möglichkeit, Anmeldedaten einzufügen, Just-in-Time-Zugriff und Sitzungsaufzeichnung. BeyondTrust Secure Remote Access protokolliert Sitzungsaktivitäten, Authentifizierungsereignisse und administrative Aktionen über Syslog.

Hinweis

Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:

• Eine Google SecOps-Instanz.
• Ein Windows 2016- oder höherer oder Linux-Host mit systemd.
• Wenn der Agent hinter einem Proxy ausgeführt wird, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
• Administratorzugriff auf die BeyondTrust Secure Remote Access B Series Appliance-Schnittstelle (/appliance).

Google SecOps-Anmeldedaten für den Bindplane-Agenten abrufen

Wählen Sie eine der folgenden Methoden aus, um den Bindplane-Agenten bei Google SecOps zu authentifizieren:

• Neue Bereitstellungen: Verwenden Sie die Chronicle API (Option 1).
• Legacy-Bereitstellungen: Verwenden Sie die Authentifizierungsdatei für die Datenaufnahme (Option 2) weiter, bis die Ingestion API am 20. Juli 2027 eingestellt wird.

Option 1: Dienstkonto für die Chronicle API erstellen (empfohlen)

1. Melden Sie sich in der Google Cloud -Konsole an und wählen Sie das Google Cloud -Projekt aus, das mit Ihrer Google SecOps-Instanz verknüpft ist.
2. Rufen Sie IAM und Verwaltung > Dienstkonten auf.
3. Klicken Sie auf Dienstkonto erstellen.
4. Geben Sie die folgenden Konfigurationsdetails an:
   • Name des Dienstkontos: Geben Sie einen Namen für das Konto ein (z. B. bindplane-ingest).
   • Dienstkontobeschreibung: Geben Sie eine Beschreibung ein (z. B. Bindplane agent log ingestion).
5. Klicken Sie auf Erstellen und fortfahren.
6. Klicken Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen auf Rolle auswählen und wählen Sie Chronicle Editor aus.
7. Klicken Sie auf Weiter und dann auf Fertig.
8. Klicken Sie auf das von Ihnen erstellte Dienstkonto und rufen Sie den Tab Schlüssel auf.
9. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
10. Wählen Sie JSON aus und klicken Sie auf Erstellen. Die Schlüsseldatei wird auf Ihren Computer heruntergeladen.
11. Speichern Sie die Schlüsseldatei als ingestion-auth.json im Bindplane-Collector-Verzeichnis (/opt/observiq-otel-collector/ingestion-auth.json unter Linux oder C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json unter Windows) oder aktualisieren Sie creds_file_path in config.yaml, sodass der Pfad mit dem Pfad übereinstimmt, unter dem Sie die Datei speichern.
12. Rufen Sie IAM und Verwaltung > Einstellungen auf und kopieren Sie die Projektnummer. Sie benötigen sie für die Exporter-Konfiguration.

Hinweis: Der JSON-Schlüssel ist ein Berechtigungsnachweis. Beschränken Sie den Zugriff auf die Datei auf dem Bindplane-Host und rotieren Sie den Schlüssel gemäß den Richtlinien Ihrer Organisation.

Option 2: Authentifizierungsdatei für die Datenaufnahme herunterladen (Legacy)

1. Melden Sie sich in der Google SecOps-Konsole an.
2. Rufen Sie Einstellungen > Datenverwaltung > Erfassungs-Agents auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Erfassungs-Agents auf.
3. Laden Sie die Authentifizierungsdatei für die Datenaufnahme herunter.
4. Speichern Sie die Datei sicher auf dem System, auf dem der Bindplane-Agent installiert werden soll.

Hinweis: Mit dieser Datei wird der Agent bei der alten Ingestion API (malachiteingestion-pa.googleapis.com) authentifiziert, die Google am 20. Juli 2027 einstellen wird. Planen Sie den Wechsel zu Option 1 vor diesem Datum.

Google SecOps-Kundennummer abrufen

1. Melden Sie sich in der Google SecOps-Konsole an.
2. Gehen Sie zu Einstellungen > Verwaltung > Profil. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Profil auf.
3. Kopieren und speichern Sie die Kundennummer aus dem Bereich Organisationsdetails.

Bindplane-Agent installieren

Installieren Sie den Bindplane-Agenten gemäß der folgenden Anleitung auf Ihrem Windows- oder Linux-Betriebssystem.

Windows-Installation

1. Öffnen Sie die Eingabeaufforderung oder PowerShell als Administrator.

2. Führen Sie dazu diesen Befehl aus:

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Linux-Installation

1. Öffnen Sie ein Terminal mit Root- oder sudo-Berechtigungen.

2. Führen Sie dazu diesen Befehl aus:

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

Zusätzliche Installationsressourcen

Weitere Installationsoptionen finden Sie in dieser Installationsanleitung.

Hinweis: Für die Konfiguration des Chronicle API-Exporters ist Bindplane Collector v1.106.0 oder höher erforderlich. Mit den vorherigen Befehlen wird die neueste Version installiert. Wenn Sie eine vorhandene Installation aktualisieren, aktualisieren Sie den Collector, bevor Sie die Konfiguration ändern.

Bindplane-Agent für die Aufnahme von Syslog und das Senden an Google SecOps konfigurieren

1. Konfigurationsdatei aufrufen:

   • Suchen Sie die Datei config.yaml. In der Regel befindet sie sich unter Linux im Verzeichnis /opt/observiq-otel-collector/ oder unter Windows im Installationsverzeichnis.
   • Öffnen Sie die Datei mit einem Texteditor (z. B. nano, vi oder Notepad).

2. Bearbeiten Sie die Datei config.yamlso:

   receivers:
     udplog:
       # Replace the port and IP address as required
       listen_address: "0.0.0.0:514"
   
   exporters:
     chronicle/chronicle_w_labels:
       protocol: https
       # Region of your instance, for example us, europe, asia-southeast1
       location: <LOCATION>
       # Project number of the Google Cloud project linked to the instance
       project: '<PROJECT_NUMBER>'
       compression: gzip
       # Adjust the path to the credentials file you downloaded in Step 1
       creds_file_path: '/path/to/ingestion-authentication-file.json'
       # Replace with your actual customer ID from Step 2
       customer_id: <your_customer_id>
       endpoint: chronicle.googleapis.com
       # Add optional ingestion labels for better organization
       log_type: 'BEYONDTRUST_REMOTE_ACCESS'
       raw_log_field: body
       ingestion_labels:
   
   service:
     pipelines:
       logs/source0__chronicle_w_labels-0:
         receivers:
           - udplog
         exporters:
           - chronicle/chronicle_w_labels
   

• Ersetzen Sie den Port und die IP-Adresse nach Bedarf in Ihrer Infrastruktur.
• Ersetzen Sie <LOCATION> durch die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1). Der Exporter stellt diesem Wert chronicle.googleapis.com voran.
• Ersetzen Sie <PROJECT_NUMBER> durch die Projektnummer aus IAM und Verwaltung > Einstellungen.
• Ersetzen Sie <your_customer_id> durch die tatsächliche Kundennummer.

• Aktualisieren Sie /path/to/ingestion-authentication-file.json auf den Dateipfad, unter dem die Dienstkontoschlüsseldatei (Option 1) in Schritt 1 gespeichert wurde.

  Hinweis: BeyondTrust Secure Remote Access verwendet die local0-Einrichtung und standardmäßig den UDP-Port 514 für Syslog ohne TLS. Wenn Sie Syslog über TLS auf der Appliance konfigurieren, verwenden Sie tcplog als Empfänger und legen Sie den Port auf 6514 fest.

Legacy-Ingestion-API-Exporter

• Wenn Sie die Authentifizierungsdatei für die Datenaufnahme aus Option 2 verwenden, ersetzen Sie den Block exporters durch Folgendes. Legen Sie für creds_file_path den Pfad zur Authentifizierungsdatei für die Datenaufnahme fest. Wenn sich Ihre Instanz außerhalb der USA befindet, ersetzen Sie malachiteingestion-pa.googleapis.com durch Ihren regionalen Endpunkt (z. B. europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/chronicle_w_labels:
      compression: gzip
      # Adjust the path to the credentials file you downloaded in Step 1
      creds_file_path: '/path/to/ingestion-authentication-file.json'
      # Replace with your actual customer ID from Step 2
      customer_id: <your_customer_id>
      endpoint: malachiteingestion-pa.googleapis.com
      # Add optional ingestion labels for better organization
      log_type: 'BEYONDTRUST_REMOTE_ACCESS'
      raw_log_field: body
      ingestion_labels:
  

Hinweis: Dieser Exporter funktioniert nicht mehr, wenn die Ingestion API am 20. Juli 2027 eingestellt wird.

Starten Sie den Bindplane-Agent neu, um die Änderungen zu übernehmen.

So starten Sie den Bindplane-Agenten unter Linux neu:

1. Führen Sie dazu diesen Befehl aus:

   sudo systemctl restart observiq-otel-collector
   

2. Prüfen Sie, ob der Dienst ausgeführt wird:

   sudo systemctl status observiq-otel-collector
   

3. Prüfen Sie die Logs auf Fehler:

   sudo journalctl -u observiq-otel-collector -f
   

So starten Sie den Bindplane-Agenten unter Windows neu:

1. Wählen Sie eine der folgenden Optionen aus:

   • Eingabeaufforderung oder PowerShell als Administrator:

   net stop observiq-otel-collector && net start observiq-otel-collector
   

   • Dienstkonsole:
     1. Drücken Sie Win+R, geben Sie services.msc ein und drücken Sie die Eingabetaste.
     2. Suchen Sie nach observIQ OpenTelemetry Collector.
     3. Rechtsklicken Sie und wählen Sie Neu starten aus.

2. Prüfen Sie, ob der Dienst ausgeführt wird:

   sc query observiq-otel-collector
   

3. Prüfen Sie die Logs auf Fehler:

   type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
   

Syslog-Weiterleitung für BeyondTrust Secure Remote Access konfigurieren

1. Melden Sie sich in der BeyondTrust Secure Remote Access-Oberfläche der B Series Appliance (/appliance) an.
2. Gehen Sie zu Sicherheit > Appliance-Verwaltung.
3. Scrollen Sie nach unten zum Abschnitt Syslog.
4. Geben Sie im Feld Remote-Syslog-Server den Hostnamen oder die IP-Adresse des Bindplane-Agent-Hosts ein (z. B. 192.168.1.100).
5. Wählen Sie das Nachrichtenformat für Ereignisbenachrichtigungen aus:
   • RFC 5424: Moderner Syslog-Standard mit strukturierten Daten (empfohlen).
   • BSD (Legacy): Legacy-BSD-Syslog-Format (RFC 3164).
   • Syslog über TLS: Verschlüsseltes Syslog über TCP-Port 6514.
6. Ändern Sie bei Bedarf den Standardport:
   • Die Formate RFC 5424 und BSD verwenden standardmäßig UDP 514.
   • Syslog über TLS verwendet standardmäßig TCP 6514.

7. Klicken Sie auf Speichern.

   Hinweis: Sie können auf der B-Series-Appliance bis zu drei Syslog-Server konfigurieren. Wenn ein Syslog-Server hinzugefügt oder geändert wird, wird eine Benachrichtigung an die E-Mail-Adresse des Administrators gesendet.
   Hinweis: Ereignisse von der /login-Verwaltungsoberfläche (z. B. Nutzeranmeldeversuche, Kontoerstellung und Konfigurationsänderungen) und der /appliance-Oberfläche werden als Syslog-Nachrichten gesendet. BeyondTrust Secure Remote Access-Logs werden mit der local0-Einrichtung gesendet.

Syslog-Zustellung bestätigen

1. Nachdem Sie die Syslog-Weiterleitung konfiguriert haben, starten Sie eine Test-Support-Sitzung oder melden Sie sich in der Verwaltungsoberfläche von /login an.

2. Prüfen Sie auf dem Bindplane-Agent-Host, ob Logs empfangen werden:

   sudo journalctl -u observiq-otel-collector -f
   

Weitere Informationen finden Sie in der Syslog-Dokumentation zu BeyondTrust Privileged Remote Access.

UDM-Zuordnungstabelle

Logfeld	UDM-Zuordnung	Logik
_field	additional.fields	Zusammengeführt
additional_device_product	additional.fields	Zusammengeführt
additional_device_vendor	additional.fields	Zusammengeführt
additional_dst_priv	additional.fields	Zusammengeführt
additional_event_name	additional.fields	Zusammengeführt
additional_external_key_label	additional.fields	Zusammengeführt
additional_jumpGroupId	additional.fields	Zusammengeführt
additional_jumpGroupName	additional.fields	Zusammengeführt
additional_jumpGroupType	additional.fields	Zusammengeführt
additional_jumpointId	additional.fields	Zusammengeführt
additional_jumpointName	additional.fields	Zusammengeführt
additional_segment_number	additional.fields	Zusammengeführt
additional_site_id	additional.fields	Zusammengeführt
additional_total_segments	additional.fields	Zusammengeführt
appliance_identifier_label	additional.fields	Zusammengeführt
appliance_label	additional.fields	Zusammengeführt
eventid_label	additional.fields	Zusammengeführt
eventsubject_label	additional.fields	Zusammengeführt
eventtype_label	additional.fields	Zusammengeführt
format_version_label	additional.fields	Zusammengeführt
nvps_actiontype_label	additional.fields	Zusammengeführt
nvps_authenticationtype_label	additional.fields	Zusammengeführt
nvps_createdate_label	additional.fields	Zusammengeführt
nvps_eventseverity_label	additional.fields	Zusammengeführt
nvps_subjectdescription_label	additional.fields	Zusammengeführt
product_label	additional.fields	Zusammengeführt
eventName	extensions.auth.auth_details	Direkt zugeordnet
mechanism	extensions.auth.mechanism	Zusammengeführt
target	extensions.auth.type	Zugeordnet: "rep_client", "web/login" → MACHINE, "rep_client", "web/login" → SSO, `rep_c...
intermediary_hostname	intermediary.asset.hostname	Direkt zugeordnet
intermediary_ip	intermediary.asset.ip	Zusammengeführt
intermediary_hostname	intermediary.hostname	Direkt zugeordnet
intermediary_ip	intermediary.ip	Zusammengeführt
msg	metadata.description	Direkt zugeordnet
datetime	metadata.event_timestamp	Geparst als RFC 3339
eventdate	metadata.event_timestamp	Geparst als MMM dd yyyy HH:mm:ss
timestamp	metadata.event_timestamp	Geparst als ISO8601
timestampvalue	metadata.event_timestamp	Geparst als yyyy-MM-ddTHH:mm:ssZZ
when	metadata.event_timestamp	Geparst als UNIX
device_vendor	metadata.event_type	Zugeordnet: Bomgar → GENERIC_EVENT
eventName	metadata.event_type	Zugeordnet: (?i)login → USER_LOGIN, (?i)logout → USER_LOGOUT
has_principal	metadata.event_type	Zugeordnet: true → NETWORK_CONNECTION, true → STATUS_UPDATE
category	metadata.product_event_type	Direkt zugeordnet
event_name	metadata.product_event_type	Direkt zugeordnet
id	metadata.product_event_type	Direkt zugeordnet
nvps_auditid	metadata.product_log_id	Direkt zugeordnet
product_log_id	metadata.product_log_id	Direkt zugeordnet
device_version	metadata.product_version	Direkt zugeordnet
version	metadata.product_version	Direkt zugeordnet
sessionId	network.session_id	Direkt zugeordnet
agentid	observer.application	Direkt zugeordnet
product_event_type	principal.asset.hostname	Direkt zugeordnet
nvps_ipaddress	principal.asset.ip	Zusammengeführt
sourceip	principal.asset.ip	Zusammengeführt
product_event_type	principal.hostname	Direkt zugeordnet
nvps_ipaddress	principal.ip	Zusammengeführt
sourceip	principal.ip	Zusammengeführt
srcHost	principal.ip	Zusammengeführt
who_ip	principal.ip	Zusammengeführt
process_id	principal.process.pid	Direkt zugeordnet
srcUser	principal.user.user_display_name	Direkt zugeordnet
user_display_name	principal.user.user_display_name	Direkt zugeordnet
srcUid	principal.user.userid	Direkt zugeordnet
user	principal.user.userid	Direkt zugeordnet
userid	principal.user.userid	Direkt zugeordnet
who	principal.user.userid	Direkt zugeordnet
security_action	security_result.action	Zusammengeführt
status	security_result.action_details	Direkt zugeordnet
reason	security_result.description	Direkt zugeordnet
severity	security_result.severity	Zugeordnete Werte (insgesamt 5, z.B. 0 → UNKNOWN_SEVERITY, 1 → LOW, 2 → MEDIUM)
eventName	security_result.summary	Direkt zugeordnet
eventname	security_result.summary	Direkt zugeordnet
nvps_systemname	target.application	Direkt zugeordnet
target	target.application	Direkt zugeordnet
filePath	target.file.full_path	Direkt zugeordnet
fsize	target.file.size	Direkt zugeordnet
deviceHost	target.hostname	Direkt zugeordnet
site	target.hostname	Direkt zugeordnet
dstHost	target.ip	Zusammengeführt
nvps_username_label	target.resource.attribute.labels	Zusammengeführt
nvps_appuserid	target.user.product_object_id	Direkt zugeordnet
dstUser	target.user.user_display_name	Direkt zugeordnet
dstUid	target.user.userid	Direkt zugeordnet
–	extensions.auth.type	Konstante: MACHINE
–	metadata.event_type	Konstante: USER_LOGIN
–	metadata.product_name	Konstante: BeyondTrust Secure Remote Access
–	metadata.vendor_name	Konstante: BeyondTrust
–	security_result.severity	Konstante: UNKNOWN_SEVERITY

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten