Kiteworks-Logs (früher Accellion) erfassen

Parserversion: 16.0

Unterstützt in:

Google SecOps SIEM

In diesem Dokument wird beschrieben, wie Sie Kiteworks-Logs (früher Accellion) mit Bindplane in Google Security Operations aufnehmen.

Kiteworks ist eine sichere Plattform für die Dateifreigabe und Governance, die die Kommunikation von Unternehmensinhalten über E‑Mail, Dateifreigabe, verwaltete Dateiübertragung und Webformulare ermöglicht. Sie bietet Transparenz, Compliance und Kontrolle über sensible Inhalte, die in die Organisation und aus ihr heraus verschoben werden.

Hinweis

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

• Eine Google SecOps-Instanz
• Windows Server 2016 oder höher oder Linux-Host mit systemd
• Netzwerkverbindung zwischen dem Bindplane-Agent und der Kiteworks-Appliance
• Wenn Sie den Agent hinter einem Proxy ausführen, müssen die Firewallports gemäß den Anforderungen des Bindplane-Agents geöffnet sein.
• Privilegierter Zugriff auf die Kiteworks-Verwaltungskonsole (Rolle „Systemadministrator“)

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

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

• Neue Deployments: 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 Console 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-Bearbeiter 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 & Verwaltung > Einstellungen auf und kopieren Sie die Projektnummer. Sie benötigen sie für die Konfiguration des Exporters.

Hinweis :Der JSON-Schlüssel ist eine Anmeldedaten. 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 die SIEM-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 Legacy Ingestion API (malachiteingestion-pa.googleapis.com) authentifiziert, die Google am 20. Juli 2027 einstellen wird. Planen Sie, vor diesem Datum zu Option 1 zu wechseln.

Google SecOps-Kundennummer abrufen

1. Melden Sie sich in der Google SecOps-Konsole an.
2. Rufen Sie die SIEM-Einstellungen > Profil auf.

3. Kopieren und speichern Sie die Kundennummer aus dem Bereich Organization Details (Organisationsdetails).

   Hinweis :Die Kunden-ID ist für die Konfiguration des Bindplane-Agent-Exporters erforderlich.

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
   

3. Warten Sie, bis die Installation abgeschlossen ist.

4. Überprüfen Sie die Installation mit folgendem Befehl:

   sc query observiq-otel-collector
   

Der Dienst sollte als RUNNING (WIRD AUSGEFÜHRT) angezeigt werden.

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
   

3. Warten Sie, bis die Installation abgeschlossen ist.

4. Überprüfen Sie die Installation mit folgendem Befehl:

   sudo systemctl status observiq-otel-collector
   

Der Dienst sollte als active (running) angezeigt werden.

Zusätzliche Installationsressourcen

Weitere Installationsoptionen und Informationen zur Fehlerbehebung finden Sie im Installationsanleitung für den Bindplane-Agenten.

Hinweis :Für die Konfiguration des Chronicle API-Exporters ist der 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 zum Erfassen von Syslog-Daten und Senden an Google SecOps konfigurieren

Konfigurationsdatei suchen

• Linux:

  sudo nano /opt/observiq-otel-collector/config.yaml
  

• Windows:

  notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
  

Konfigurationsdatei bearbeiten

• Ersetzen Sie den gesamten Inhalt von config.yaml durch die folgende Konfiguration:

  receivers:
    udplog:
      listen_address: "0.0.0.0:514"
  
  exporters:
    chronicle/accellion:
      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
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: ACCELLION
      raw_log_field: body
  
  service:
    pipelines:
      logs/accellion_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/accellion
  

Konfigurationsparameter

Ersetzen Sie die folgenden Platzhalter:

• Empfängerkonfiguration:

  • listen_address: IP-Adresse und Port, auf die gewartet werden soll:
    • 0.0.0.0, um auf allen Schnittstellen zuzuhören (empfohlen)
    • Port 514 ist der Standard-Syslog-Port (erfordert Root unter Linux; verwenden Sie 1514 für Nicht-Root).

• Exporter-Konfiguration:

  • creds_file_path: Vollständiger Pfad zur JSON-Schlüsseldatei des Dienstkontos (Option 1):
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • customer_id: Die Kundennummer, die aus der Google SecOps Console kopiert wurde
  • location: Ersetzen Sie <LOCATION> durch die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1). Der Exporteur stellt diesem Wert das Präfix chronicle.googleapis.com voran. Eine vollständige Liste finden Sie unter Regionale Endpunkte.
  • project: Ersetzen Sie <PROJECT_NUMBER> durch die Projektnummer unter IAM & Verwaltung > Einstellungen.
  • endpoint: Behalten Sie die Einstellung chronicle.googleapis.com bei.

Legacy-Ingestion-API-Exporter

• Wenn Sie die Datei zur Authentifizierung bei der Aufnahme 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/accellion:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: ACCELLION
      raw_log_field: body
  

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

Konfigurationsdatei speichern

• Speichern Sie die Datei nach der Bearbeitung:
  • Linux: Drücken Sie Ctrl+O, dann Enter und dann Ctrl+X.
  • Windows: Klicken Sie auf Datei > Speichern.

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
   

   • Services Console:
     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. Klicken Sie mit der rechten Maustaste 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 in Kiteworks (ehemals Accellion) konfigurieren

1. Melden Sie sich als Systemadministrator in der Kiteworks-Verwaltungskonsole an.
2. Rufen Sie die Seite Standorte auf:
   • Legacy-Admin-Benutzeroberfläche: Gehen Sie zu System > Standorte.
   • Neue Admin-Benutzeroberfläche: Gehen Sie zu Systemeinrichtung > Standorte.
3. Wählen Sie den Zielort aus der Liste aus.
4. Gehen Sie zum Abschnitt Externe Dienste.
5. Maximieren Sie den Bereich Syslog-Einstellungen.
6. Klicken Sie auf Hinzufügen, um eine neue Syslog-Serverkonfiguration zu erstellen.
7. Geben Sie die folgenden Konfigurationsdetails an:
   • Syslog-Server: Geben Sie die IP-Adresse des BindPlane-Agent-Hosts ein (z. B. 192.168.1.100).
   • Protokoll: Wählen Sie je nach Konfiguration des Bindplane-Agent-Empfängers UDP oder TCP aus.
   • Port: Geben Sie die Portnummer des Bindplane-Agents ein, z. B. 514.
   • TLS verwenden: Aktivieren Sie dieses Kästchen, wenn Sie Syslog-Nachrichten über TLS übertragen möchten. Diese Option ist nur verfügbar, wenn TCP als Protokoll ausgewählt ist.
   • Format: Wählen Sie JSON-Format aus (empfohlen für strukturiertes Parsen).

8. Klicken Sie auf Speichern, um die Konfiguration anzuwenden.

   Hinweis: Kiteworks Syslog exportiert alle Daten und administrativen Ereignisse, einschließlich Dateiverschiebungen, Dateizugriffen, Fehlern, Änderungen der Zugriffssteuerung, Änderungen von Berechtigungen, Onboarding/Offboarding von Nutzern, fehlgeschlagenen und erfolgreichen Anmeldungen sowie Scanfehlern (AV, ATP, DLP).

UDM-Zuordnungstabelle

Logfeld	UDM-Zuordnung	Logik
acct	principal.user.user_display_name	Der Wert von acct aus dem Feld msg des Rohlogs.
acct	target.user.user_display_name	Der Wert von acct aus dem Feld msg des Rohlogs.
addr	principal.ip	Der Wert von addr aus dem Feld msg des Rohlogs.
a0	security_result.about.labels.value	Der Wert von a0 aus dem Feld msg des Rohlogs, wobei der entsprechende key-Wert „a0“ ist.
a1	security_result.about.labels.value	Der Wert von a1 aus dem Feld msg des Rohlogs, wobei der entsprechende key-Wert „a1“ ist.
a2	security_result.about.labels.value	Der Wert von a2 aus dem Feld msg des Rohlogs, wobei der entsprechende key „a2“ ist.
a3	security_result.about.labels.value	Der Wert von a3 aus dem Feld msg des Rohlogs, wobei der entsprechende key-Wert „a3“ ist.
arch	security_result.about.platform_version	Der Wert von arch aus dem Feld msg des Rohlogs. Gilt nur für den SYSCALL type_name.
auid	about.user.userid	Der Wert von auid aus dem Feld msg des Rohlogs.
auid	security_result.detection_fields.value	Der Wert von auid aus dem Feld msg des Rohlogs, wobei der entsprechende key „auid“ ist.
comm	principal.application	Der Wert von comm aus dem Feld msg des Rohlogs.
cmd	principal.process.command_line	Der Wert von cmd aus dem Feld msg des Rohlogs.
cwd	security_result.detection_fields.value	Der Wert von cwd aus dem Feld msg des Rohlogs, wobei der entsprechende key „cwd“ ist.
cwd	target.process.file.full_path	Der Wert von cwd aus dem Feld msg des Rohlogs.
exe	principal.process.file.full_path	Der Wert von exe aus dem Feld msg des Rohlogs.
exe	target.process.file.full_path	Der Wert von exe aus dem Feld msg des Rohlogs.
exit	security_result.about.labels.value	Der Wert von exit aus dem Feld msg des Rohlogs, wobei der entsprechende key „Exit Code“ ist.
hostname	principal.hostname	Der Wert von hostname aus dem Feld msg des Rohlogs.
key	security_result.about.registry.registry_key	Der Wert von key aus dem Feld msg des Rohlogs. Gilt nur für den SYSCALL type_name.
log_type	metadata.log_type	Der Wert von log_type aus dem Rohlog.
msg	security_result.action_details	Der Wert nach res= im Feld msg des Rohlogs.
msg	security_result.summary	Kombination von Feldern aus dem Feld msg des Rohlogs. Wird aus dem Abschnitt audit des Felds msg im Rohlog geparst. Wird basierend auf dem Feld type im Rohlog zugeordnet. Beispiel: „USER_START“ wird „USER_LOGIN“ zugeordnet, „CRED_DISP“ wird „USER_LOGOUT“ zugeordnet, „CRED_ACQ“ wird „USER_LOGIN“ zugeordnet, „USER_END“ wird „USER_LOGOUT“ zugeordnet, „CRED_REFR“ wird „USER_LOGIN“ zugeordnet, „USER_CMD“ wird „USER_LOGIN“ zugeordnet, „CWD“ wird „STATUS_UPDATE“ zugeordnet, „PROCTITLE“ wird „STATUS_UPDATE“ zugeordnet, „USER_ACCT“ wird „USER_UNCATEGORIZED“ zugeordnet und „SYSCALL“ wird „USER_UNCATEGORIZED“ zugeordnet.
node	principal.hostname	Der Wert von node aus dem Feld msg des Rohlogs.
pid	principal.process.pid	Der Wert von pid aus dem Feld msg des Rohlogs.
ppid	principal.process.parent_process.pid	Der Wert von ppid aus dem Feld msg des Rohlogs.
proctitle	target.process.file.full_path	Der decodierte Hexadezimalwert von proctitle aus dem Feld msg des Rohlogs. Fest codiert als „LINUX“. Auf „ALLOW“ gesetzt, wenn res=success im Feld msg des Rohlogs vorhanden ist.
ses	network.session_id	Der Wert von ses aus dem Feld msg des Rohlogs.
syscall	security_result.about.labels.value	Der Wert von syscall aus dem Feld msg des Rohlogs, wobei der entsprechende key „Syscall“ ist.
success	security_result.summary	Wird mit anderen Feldern kombiniert, um die Zusammenfassung zu erstellen. Für SYSCALL-Ereignisse gilt folgende Logik: Wenn success=yes, dann „yes, The System call succeeded“ (ja, der Systemaufruf war erfolgreich), andernfalls „no, The System call failed“ (nein, der Systemaufruf ist fehlgeschlagen).
terminal	principal.terminal	Der Wert von terminal aus dem Feld msg des Rohlogs.
timestamp	timestamp	Der Wert von timestamp aus dem Logeintrag.
tty	principal.terminal	Der Wert von tty aus dem Feld msg des Rohlogs.
type	metadata.product_event_type	Der Wert von type aus dem Feld msg des Rohlogs.
uid	about.user.userid	Der Wert von uid aus dem Feld msg des Rohlogs. Gilt nur für type_name SYSCALL.
uid	target.user.userid	Der Wert von uid aus dem Feld msg des Rohlogs. Legen Sie „SETTING“ fest, wenn type „USER_ACCT“ ist.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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