Uptycs-EDR-Logs erfassen

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Uptycs EDR-Logs mit Amazon S3 in Google Security Operations aufnehmen können. Der Parser wandelt JSON-Rohlogs in ein einheitliches Datenmodell (Unified Data Model, UDM) um. Zuerst werden Felder aus dem JSON-Code extrahiert, die Daten bereinigt und angereichert. Anschließend werden die relevanten Informationen den entsprechenden UDM-Feldern zugeordnet. Dabei werden verschiedene Datentypen und Grenzfälle berücksichtigt, um eine genaue und konsistente Darstellung im UDM-Schema zu gewährleisten.

Hinweis

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

  • Eine Google SecOps-Instanz
  • Privilegierter Zugriff auf Uptycs
  • Privilegierter Zugriff auf AWS (S3, IAM)

Voraussetzungen für Uptycs abrufen

  1. Melden Sie sich in der Uptycs-Admin-Konsole an.
  2. Gehen Sie zu Konfiguration > Nutzer.
  3. Wählen Sie Ihren Nutzer aus oder erstellen Sie einen Dienstkontonutzer.
  4. Klicken Sie auf User API key (Nutzer-API-Schlüssel).
  5. Kopieren Sie die folgenden Details und speichern Sie sie an einem sicheren Ort:
    • API-Schlüssel
    • API Secret (API-Secret)
    • Kundennummer
    • API-Domain (abgeleitet von Ihrer Uptycs-URL, z. B. mystack.uptycs.io)

AWS S3-Bucket und IAM für Google SecOps konfigurieren

  1. Erstellen Sie einen Amazon S3-Bucket gemäß dem Nutzerhandbuch unter Bucket erstellen.
  2. Speichern Sie den Namen und die Region des Buckets zur späteren Verwendung (z. B. uptycs-telemetry-export).
  3. Erstellen Sie einen Nutzer gemäß diesem Nutzerhandbuch: IAM-Nutzer erstellen.
  4. Wählen Sie den erstellten Nutzer aus.
  5. Wählen Sie den Tab Sicherheitsanmeldedaten aus.
  6. Klicken Sie im Bereich Access Keys (Zugriffsschlüssel) auf Create Access Key (Zugriffsschlüssel erstellen).
  7. Wählen Sie Drittanbieterdienst als Anwendungsfall aus.
  8. Klicken Sie auf Weiter.
  9. Optional: Fügen Sie ein Beschreibungs-Tag hinzu.
  10. Klicken Sie auf Zugriffsschlüssel erstellen.
  11. Klicken Sie auf CSV-Datei herunterladen, um den Zugriffsschlüssel und den geheimen Zugriffsschlüssel zur späteren Verwendung zu speichern.
  12. Klicken Sie auf Fertig.
  13. Wählen Sie den Tab Berechtigungen aus.
  14. Klicken Sie im Bereich Berechtigungsrichtlinien auf Berechtigungen hinzufügen.
  15. Wählen Sie Berechtigungen hinzufügen aus.
  16. Wählen Sie Richtlinien direkt anhängen aus.
  17. Suchen Sie nach der Richtlinie AmazonS3FullAccess.
  18. Wählen Sie die Richtlinie aus.
  19. Klicken Sie auf Weiter.
  20. Klicken Sie auf Berechtigungen hinzufügen.

IAM-Richtlinie und -Rolle für S3-Uploads konfigurieren

  1. Rufen Sie in der AWS-Konsole die Seite IAM > Richtlinien auf.
  2. Klicken Sie auf Richtlinie erstellen > Tab „JSON“.
  3. Geben Sie die folgende Richtlinie ein:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Sid": "AllowPutObjects",
          "Effect": "Allow",
          "Action": "s3:PutObject",
          "Resource": "arn:aws:s3:::uptycs-telemetry-export/*"
        },
        {
          "Sid": "AllowListBucket",
          "Effect": "Allow",
          "Action": "s3:ListBucket",
          "Resource": "arn:aws:s3:::uptycs-telemetry-export"
        }
      ]
    }
    
    • Ersetzen Sie uptycs-telemetry-export, wenn Sie einen anderen Bucket-Namen eingegeben haben.
  4. Klicken Sie auf Weiter > Richtlinie erstellen.

  5. Geben Sie der Richtlinie den Namen uptycs-s3-write-policy.

  6. Gehen Sie zu IAM > Nutzer.

  7. Wählen Sie den Nutzer aus, der für Uptycs-Exporte erstellt wurde.

  8. Klicken Sie auf Berechtigungen hinzufügen > Richtlinien direkt anhängen.

  9. Suchen Sie nach uptycs-s3-write-policy und wählen Sie die App aus.

  10. Klicken Sie auf Weiter > Berechtigungen hinzufügen.

Uptycs-Export von Roh-Telemetriedaten konfigurieren

  1. Melden Sie sich in der Uptycs-Konsole an.
  2. Rufen Sie den Abschnitt „Exportkonfiguration“ auf.
  3. Konfigurieren Sie das S3-Exportziel.
  4. Geben Sie die folgenden Konfigurationsdetails an:
    • Exporttyp: Wählen Sie Roh-Telemetriedaten aus.
    • Ziel: Wählen Sie Amazon S3 aus.
    • Format: Wählen Sie JSON aus.
    • S3-Bucket: Geben Sie uptycs-telemetry-export ein.
    • S3-Pfadpräfix: Geben Sie telemetry/ ein.
    • AWS-Region: Wählen Sie die Region Ihres Buckets aus.
    • AWS-Zugriffsschlüssel-ID: Geben Sie den Zugriffsschlüssel des IAM-Nutzers ein.
    • Geheimer AWS-Zugriffsschlüssel: Geben Sie den geheimen Zugriffsschlüssel ein.
    • Ereignistypen: Wählen Sie alle erforderlichen Telemetrietypen aus.
  5. Testen und aktivieren Sie den Export.

IAM-Nutzer mit Lesezugriff für Google SecOps erstellen

  1. Rufen Sie die AWS-Konsole > IAM > Nutzer auf.
  2. Klicken Sie auf Nutzer hinzufügen.
  3. Geben Sie die folgenden Konfigurationsdetails an:
    • Nutzer: Geben Sie secops-reader ein.
    • Zugriffstyp: Wählen Sie Zugriffsschlüssel – Programmatischer Zugriff aus.
  4. Klicken Sie auf Nutzer erstellen.
  5. Richtlinie für minimalen Lesezugriff (benutzerdefiniert) anhängen: Nutzer > secops-reader > Berechtigungen > Berechtigungen hinzufügen > Richtlinien direkt anhängen > Richtlinie erstellen.
  6. Geben Sie im JSON-Editor die folgende Richtlinie ein:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject"],
          "Resource": "arn:aws:s3:::uptycs-telemetry-export/*"
        },
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::uptycs-telemetry-export"
        }
      ]
    }
    
  7. Legen Sie secops-reader-policy als Name fest.

  8. Gehen Sie zu Richtlinie erstellen > Suchen/Auswählen > Weiter > Berechtigungen hinzufügen.

  9. Gehen Sie zu Sicherheitsanmeldedaten > Zugriffsschlüssel > Zugriffsschlüssel erstellen.

  10. Laden Sie die CSV herunter. Diese Werte werden in den Feed eingegeben.

Feed in Google SecOps konfigurieren, um Uptycs-Logs aufzunehmen

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf + Neuen Feed hinzufügen.
  3. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. Uptycs EDR logs.
  4. Wählen Sie als Quelltyp Amazon S3 V2 aus.
  5. Wählen Sie Uptycs EDR als Logtyp aus.
  6. Klicken Sie auf Weiter.
  7. Geben Sie Werte für die folgenden Eingabeparameter an:
    • S3-URI: s3://uptycs-telemetry-export/telemetry/
    • Optionen zum Löschen der Quelle: Wählen Sie die gewünschte Löschoption aus.
    • Maximales Dateialter: Dateien einschließen, die in den letzten Tagen geändert wurden. Der Standardwert ist 180 Tage.
    • Zugriffsschlüssel-ID: Der Nutzerzugriffsschlüssel mit Zugriff auf den S3-Bucket.
    • Geheimer Zugriffsschlüssel: Der geheime Schlüssel des Nutzers mit Zugriff auf den S3-Bucket.
    • Asset-Namespace: Der Asset-Namespace.
    • Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet wird.
  8. Klicken Sie auf Weiter.
  9. Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
osquery_raw_data.answer read_only_udm.network.dns.answers.name Wert aus osquery_raw_data.answer, wenn osquery_raw_data.answer nicht leer ist.
osquery_raw_data.container_id read_only_udm.metadata.product_log_id Wert aus osquery_raw_data.container_id, wenn osquery_raw_data.container_id nicht leer ist.
osquery_raw_data.local_address read_only_udm.principal.ip Wert aus osquery_raw_data.local_address, wenn osquery_raw_data.local_address nicht leer und eine gültige IP-Adresse ist.
osquery_raw_data.local read_only_udm.principal.ip Andernfalls wird der Wert aus „osquery_raw_data.local“ übernommen, wenn „osquery_raw_data.local“ nicht leer und eine gültige IP-Adresse ist.
osquery_raw_data.local_port read_only_udm.principal.port Der Wert wird aus „osquery_raw_data.local_port“ übernommen und in eine Ganzzahl konvertiert, wenn „osquery_raw_data.local_port“ nicht leer ist.
osquery_raw_data.md5 read_only_udm.target.process.file.md5 Wert aus osquery_raw_data.md5, wenn osquery_raw_data.md5 nicht leer ist.
osquery_raw_data.port read_only_udm.target.port Der Wert wird aus „osquery_raw_data.port“ übernommen und in eine Ganzzahl umgewandelt, wenn „osquery_raw_data.port“ nicht leer ist.
osquery_raw_data.question read_only_udm.network.dns.questions.name Wert aus osquery_raw_data.question, wenn osquery_raw_data.question nicht leer ist.
osquery_raw_data.remote_address read_only_udm.intermediary.ip Wert aus osquery_raw_data.remote_address, wenn osquery_raw_data.remote_address nicht leer ist.
osquery_raw_data.remote_port read_only_udm.intermediary.port Der Wert wird aus „osquery_raw_data.remote_port“ übernommen und in eine Ganzzahl umgewandelt, wenn „osquery_raw_data.remote_port“ nicht leer ist.
osquery_raw_data.type read_only_udm.network.dns.questions.type Wert aus osquery_raw_data.type, der in eine Ganzzahl konvertiert wird, wenn osquery_raw_data.type nicht leer ist.
osquery_raw_data.uid read_only_udm.principal.user.userid Wert aus osquery_raw_data.uid, wenn osquery_raw_data.uid nicht leer und nicht gleich „0“ ist.
osquery_raw_data.worker_instance_id read_only_udm.principal.user.userid Andernfalls wird der Wert aus osquery_raw_data.worker_instance_id übernommen, wenn osquery_raw_data.worker_instance_id nicht leer ist.
upt_asset_group_id read_only_udm.principal.user.group_identifiers Der Wert wird aus „upt_asset_group_id“ übernommen, wenn „upt_asset_group_id“ nicht leer ist.
upt_asset_group_name read_only_udm.principal.group.group_display_name Wert aus upt_asset_group_name, wenn upt_asset_group_name nicht leer ist.
upt_asset_id read_only_udm.principal.asset.asset_id Verketteter String „UPT ASSET ID:“ mit dem Wert von upt_asset_id, wenn upt_asset_id nicht leer ist.
upt_hash read_only_udm.target.file.md5 Alle Vorkommen von „-“ werden in upt_hash durch „“ ersetzt. Anschließend wird der Wert read_only_udm.target.file.md5 zugewiesen, wenn upt_hash nicht leer ist.
upt_hostname read_only_udm.principal.hostname Wert aus upt_hostname, wenn upt_hostname nicht leer ist.
upt_resource_type read_only_udm.target.resource.type Wert aus upt_resource_type, wenn upt_resource_type nicht leer ist.
upt_time read_only_udm.metadata.event_timestamp.seconds Wert aus „upt_time“, wenn „upt_time“ nicht leer ist.
read_only_udm.metadata.event_type Der Wert wird auf „PROCESS_LAUNCH“ gesetzt, wenn osquery_raw_data.pid nicht leer ist. Der Wert wird auf „NETWORK_DNS“ gesetzt, wenn osquery_raw_data.question nicht leer ist. Der Wert wird auf „GENERIC_EVENT“ gesetzt, wenn „event_type“ leer ist.
read_only_udm.metadata.log_type Der Wert ist auf „UPTYCS_EDR“ festgelegt.
read_only_udm.metadata.product_name Der Wert ist auf „UPTYCS_EDR“ festgelegt.
read_only_udm.metadata.vendor_name Der Wert ist auf „UPTYCS“ festgelegt.
read_only_udm.network.application_protocol Der Wert wird auf „DNS“ gesetzt, wenn osquery_raw_data.question nicht leer ist.
read_only_udm.security_result.action Der Wert wird auf „ALLOW“ gesetzt, wenn osquery_raw_data.return_code gleich „SUCCESS“ oder osquery_raw_data.success gleich „1“ ist.
read_only_udm.target.process.command_line Wert aus osquery_raw_data.cmdline, wenn osquery_raw_data.cmdline nicht leer ist.
read_only_udm.target.process.file.full_path Wert aus osquery_raw_data.path, wenn osquery_raw_data.path nicht leer ist.
read_only_udm.target.process.parent_process Der Wert wird durch Iteration über das Array „ancestor_list“ in „osquery_raw_data.ancestor_list“ erstellt. Für jedes Element im Array werden „command_line“, „full_path“ der Datei und „pid“ extrahiert und in eine JSON-Struktur formatiert, die die Prozesskette darstellt.
read_only_udm.target.process.pid Wert aus osquery_raw_data.pid, wenn osquery_raw_data.pid nicht leer ist.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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