HashiCorp-Audit-Logs erfassen

Dieser Parser verarbeitet HashiCorp-Audit-Logs im JSON-, Syslog- oder kombinierten Format. Sie extrahiert Felder, führt Grok- und KV-Parsing für Nachrichten vom Typ „Standard“ und „Runner“ aus, verarbeitet JSON-Nutzlasten und ordnet die extrahierten Daten dem UDM zu. Der Parser umfasst auch die Fehlerbehandlung und das Verwerfen fehlerhafter Logs.

Hinweise

• Prüfen Sie, ob Sie eine Google Security Operations-Instanz haben.
• Achten Sie darauf, dass Sie einen Windows 2016-Host oder höher oder einen Linux-Host mit systemd haben.
• Wenn Sie einen Proxy verwenden, müssen die Firewallports geöffnet sein.
• Prüfen Sie, ob Sie privilegierten Zugriff auf HCP haben.

Authentifizierungsdatei für die Aufnahme in Google SecOps abrufen

1. Melden Sie sich in der Google SecOps-Konsole an.
2. Rufen Sie die SIEM-Einstellungen > Collection Agents auf.
3. Laden Sie die Authentifizierungsdatei für die Aufnahme herunter.

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 Kunden-ID aus dem Bereich Organisationsdetails.

BindPlane-Agent installieren

1. Führen Sie für die Windows-Installation das folgende Skript aus:
   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
2. Führen Sie für die Linux-Installation das folgende Skript aus:
   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
3. Weitere Installationsoptionen finden Sie in dieser Installationsanleitung.

Bindplane-Agent so konfigurieren, dass Syslog-Daten aufgenommen und an Google SecOps gesendet werden

1. Greifen Sie auf den Computer zu, auf dem der BindPlane-Agent installiert ist.

2. Bearbeiten Sie die Datei config.yamlso:

   receivers:
       udplog:
           # Replace the below port <54525> and IP <0.0.0.0> with your specific values
           listen_address: "0.0.0.0:54525" 
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the creds location below according the placement of the credentials file you downloaded
           creds: '{ json file for creds }'
           # Replace <customer_id> below with your actual ID that you copied
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # You can apply ingestion labels below as preferred
           ingestion_labels:
           log_type: SYSLOG
           namespace: auditd
           raw_log_field: body
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

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

   sudo systemctl restart bindplane
   

Syslog für HCP Vault aktivieren

1. Melden Sie sich im HCP-Portal an.
2. Rufen Sie Vault-Cluster auf.
3. Wählen Sie Ihren Vault-Cluster aus der Liste der bereitgestellten Cluster aus.
4. Suchen Sie in der Clusterübersicht die Vault-Adresse (z. B. https://vault-cluster-name.hashicorpcloud.com:8200) und kopieren Sie sie.
5. Rufen Sie den Abschnitt Zugriffsdetails auf und kopieren Sie das Root-Token.

Vault-Befehlszeile installieren

• Für Linux:

  curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
  echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
  sudo apt update && sudo apt install vault
  

• Für macOS (mit Homebrew):

  brew tap hashicorp/tap
  brew install hashicorp/tap/vault
  

• Für Windows:

  Download the executable file.
  Extract it and add the Vault binary to your system's PATH.
  

• Prüfen Sie die Installation der Vault CLI mit folgendem Befehl:

  vault --version
  

HCP Vault mit der CLI konfigurieren, um Audit-Logs an Bindplane zu senden

1. Öffnen Sie das Terminal oder die Eingabeaufforderung.

2. Legen Sie die Vault-Serveradresse mit der Umgebungsvariable fest:

   export VAULT_ADDR="https://vault-cluster-name.hashicorpcloud.com:8200"
   

3. Melden Sie sich mit dem Root-Token bei Vault an:

   vault login <root-token>
   

Syslog-Pfad zu einem externen Syslog-Socket konfigurieren

1. Führen Sie den folgenden Befehl aus, um syslog zu aktivieren und an Bindplane Agent zu senden:

   vault audit enable socket address="udp://<bindplane-ip>:<bindplane-port>" socket_type="udp" tag="vault"
   

2. Bestätigen Sie die neue Konfiguration:

   vault audit list
   

3. In der Ausgabe sollte die neue Socket-Konfiguration angezeigt werden.

4. Optional: Einrichtung mit Terraform automatisieren:

   • Erstellen Sie eine Terraform-Konfigurationsdatei (audit.tf):

   resource "vault_audit" "syslog" {
     type        = "syslog"
     description = "Syslog audit logs"
     options = {
       tag      = "vault"
       facility = "LOCAL0"
     }
   }
   
   resource "vault_audit" "socket" {
     type        = "socket"
     description = "Remote syslog socket"
     options = {
       address     = "udp://<syslog-server-ip>:514"
       socket_type = "udp"
       tag         = "vault"
     }
   }
   

   • Wenden Sie die Konfiguration an:

   terraform init
   terraform apply
   

Fehlerbehebung bei nicht empfangenen Logs

• Prüfen Sie, ob der Syslog-Server erreichbar ist:

  ping <syslog-server-ip>
  

UDM-Zuordnungstabelle

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