Array Networks SSL VPN-Logs erfassen

Parserversion: 1.0

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie SSL-VPN-Logs von Array Networks mit dem Bindplane-Agenten in Google Security Operations aufnehmen.

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.
  • Privilegierter Zugriff auf die SSL-VPN-Verwaltungskonsole oder -Appliance von Array Networks (AG-Serie oder vxAG)

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.
  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.

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.

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.

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

  1. Greifen Sie auf die Konfigurationsdatei zu:

    • 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: <CUSTOMER_ID>
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'ARRAYNETWORKS_VPN'
        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 <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.
    • 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. Eine vollständige Liste finden Sie unter Regionale Endpunkte.
    • Ersetzen Sie <PROJECT_NUMBER> durch die Projektnummer aus IAM und Verwaltung > Einstellungen.

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: <CUSTOMER_ID>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'ARRAYNETWORKS_VPN'
        raw_log_field: body
        ingestion_labels:
    

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

  1. Führen Sie den folgenden Befehl aus, um den Bindplane-Agenten unter Linux neu zu starten:

    sudo systemctl restart observiq-otel-collector
    
  2. Wenn Sie den Bindplane-Agenten unter Windows neu starten möchten, können Sie entweder die Konsole Dienste verwenden oder den folgenden Befehl eingeben:

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

Syslog-Weiterleitung auf Array Networks SSL VPN konfigurieren

  1. Melden Sie sich in der Array Networks SSL VPN Management Console (WebUI) an.
  2. Klicken Sie im linken Navigationsmenü auf ADMIN TOOLS (Admin-Tools).
  3. Klicken Sie auf Monitoring.
  4. Klicken Sie auf den Tab Logging.
  5. Klicken Sie auf den Untertab Syslog Servers (Syslog-Server).
  6. Klicken Sie im Abschnitt REMOTE SYSLOG SERVER CONFIGURATION auf Add Server Entry.
  7. Geben Sie die folgenden Konfigurationsdetails an:
    • Host-IP-Adresse: Geben Sie die IP-Adresse des Bindplane-Agents ein.
    • Hostport: Geben Sie die Portnummer des Bindplane-Agents ein (z. B. 514).
    • Protokoll: Wählen Sie je nach Bindplane-Agent-Konfiguration UDP oder TCP aus.
    • Quellport: Behalten Sie den Standardwert bei oder geben Sie einen Port an, wenn dies für Ihre Netzwerkkonfiguration erforderlich ist.
    • Stufe: Wählen Sie den Mindestschweregrad für die Weiterleitung aus (z. B. „Information“, „Warnung“, „Fehler“).
  8. Klicken Sie auf Hinzufügen oder Speichern, um die Konfiguration anzuwenden.
  9. Klicken Sie oben auf der Seite auf Konfiguration speichern, um die Änderungen zu speichern.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
clientip principal.ip Die IP-Adresse des Clients, die aus dem Feld clientip im Roh-Logeintrag extrahiert wurde.
column1 principal.ip IP-Adresse, die aus column1 im Rohlog extrahiert wurde.
column1 principal.asset.ip IP-Adresse, die aus column1 im Rohlog extrahiert wurde.
column3 network.received_bytes Die Anzahl der empfangenen Bytes, konvertiert in eine vorzeichenlose Ganzzahl.
column4 network.http.method Die HTTP-Methode, die aus column4 im Rohlog extrahiert wurde.
column7 target.ip Die Ziel-IP-Adresse, die aus column7 im Rohlog extrahiert wurde.
dport target.port Zielport, in eine Ganzzahl konvertiert.
dst target.ip IP-Adresse des Ziels.
dst target.asset.ip IP-Adresse des Ziels.
hostname principal.hostname Der Hostname, der aus dem Feld hostname in der rohen Logeintrag extrahiert wurde.
hostname principal.asset.hostname Der Hostname, der aus dem Feld hostname in der rohen Logeintrag extrahiert wurde.
http_method network.http.method Die HTTP-Methode, die aus dem Rohlogeintrag extrahiert wurde.
id principal.application Die Anwendungs-ID aus dem Rohlog.
mac principal.mac Die MAC-Adresse, die aus dem Feld mac in der rohen Logeintrag extrahiert wurde.
msg metadata.product_event_type Das Nachrichtenfeld aus dem Rohprotokoll, das als Produktereignistyp verwendet wird. Wird auch für security_result.description verwendet, nachdem Backslashes und Anführungszeichen entfernt wurden.
product_name metadata.product_name Der Produktname, der aus der Roh-Logeintrag extrahiert wurde.
prxy_ip intermediary.ip Proxy-IP-Adresse.
prxy_port intermediary.port Proxy-Port, in eine Ganzzahl konvertiert.
response_code network.http.response_code Der HTTP-Antwortcode, konvertiert in eine Ganzzahl.
security_result.action security_result.action Wird von der Parserlogik basierend auf dem Wert von column2 bestimmt. „BLOCK“, wenn column2 „TCP_MISS“ enthält, andernfalls „UNKNOWN_ACTION“.
security_result.description security_result.description Das Nachrichtenfeld aus dem Rohlog, nachdem Backslashes und Anführungszeichen entfernt wurden.
sport principal.port Quellport, in eine Ganzzahl konvertiert.
src principal.ip IP-Adresse der Quelle.
src principal.asset.ip IP-Adresse der Quelle.
target_hostname target.hostname Der Ziel-Hostname, der aus der rohen Logeintragsnachricht extrahiert wurde.
timestamp metadata.event_timestamp Der Zeitstempel, der aus der Roh-Logeintrag extrahiert und in ein Zeitstempelobjekt geparst wurde.
uri target.url Teil der Ziel-URL. Wird mit uri_param kombiniert, um die vollständige URL zu bilden.
uri_param target.url Teil der Ziel-URL. Wird mit uri kombiniert, um die vollständige URL zu bilden.
user target.user.userid Der aus dem rohen Logeintrag extrahierte Nutzername.
user_agent_string network.http.user_agent Der aus dem rohen Logeintrag extrahierte User-Agent-String.
vpn target.user.group_identifiers Der aus der rohen Logeintrag extrahierte VPN-Name.
metadata.event_type metadata.event_type Wird von der Parserlogik anhand einer Kombination von Feldern wie has_principal, has_target, has_http_value und user bestimmt. Kann „NETWORK_HTTP“, „NETWORK_CONNECTION“, „STATUS_UPDATE“, „USER_UNCATEGORIZED“ oder „GENERIC_EVENT“ sein.
network.ip_protocol network.ip_protocol Legen Sie „TCP“ fest, wenn die Nachricht „TCP“ enthält.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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