Uptycs-EDR-Logs erfassen
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
- Melden Sie sich in der Uptycs-Admin-Konsole an.
- Gehen Sie zu Konfiguration > Nutzer.
- Wählen Sie Ihren Nutzer aus oder erstellen Sie einen Dienstkontonutzer.
- Klicken Sie auf User API key (Nutzer-API-Schlüssel).
- 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
- Erstellen Sie einen Amazon S3-Bucket gemäß dem Nutzerhandbuch unter Bucket erstellen.
- Speichern Sie den Namen und die Region des Buckets zur späteren Verwendung (z. B.
uptycs-telemetry-export). - Erstellen Sie einen Nutzer gemäß diesem Nutzerhandbuch: IAM-Nutzer erstellen.
- Wählen Sie den erstellten Nutzer aus.
- Wählen Sie den Tab Sicherheitsanmeldedaten aus.
- Klicken Sie im Bereich Access Keys (Zugriffsschlüssel) auf Create Access Key (Zugriffsschlüssel erstellen).
- Wählen Sie Drittanbieterdienst als Anwendungsfall aus.
- Klicken Sie auf Weiter.
- Optional: Fügen Sie ein Beschreibungs-Tag hinzu.
- Klicken Sie auf Zugriffsschlüssel erstellen.
- Klicken Sie auf CSV-Datei herunterladen, um den Zugriffsschlüssel und den geheimen Zugriffsschlüssel zur späteren Verwendung zu speichern.
- Klicken Sie auf Fertig.
- Wählen Sie den Tab Berechtigungen aus.
- Klicken Sie im Bereich Berechtigungsrichtlinien auf Berechtigungen hinzufügen.
- Wählen Sie Berechtigungen hinzufügen aus.
- Wählen Sie Richtlinien direkt anhängen aus.
- Suchen Sie nach der Richtlinie AmazonS3FullAccess.
- Wählen Sie die Richtlinie aus.
- Klicken Sie auf Weiter.
- Klicken Sie auf Berechtigungen hinzufügen.
IAM-Richtlinie und -Rolle für S3-Uploads konfigurieren
- Rufen Sie in der AWS-Konsole die Seite IAM > Richtlinien auf.
- Klicken Sie auf Richtlinie erstellen > Tab „JSON“.
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.
- Ersetzen Sie
Klicken Sie auf Weiter > Richtlinie erstellen.
Geben Sie der Richtlinie den Namen
uptycs-s3-write-policy.Gehen Sie zu IAM > Nutzer.
Wählen Sie den Nutzer aus, der für Uptycs-Exporte erstellt wurde.
Klicken Sie auf Berechtigungen hinzufügen > Richtlinien direkt anhängen.
Suchen Sie nach
uptycs-s3-write-policyund wählen Sie die App aus.Klicken Sie auf Weiter > Berechtigungen hinzufügen.
Uptycs-Export von Roh-Telemetriedaten konfigurieren
- Melden Sie sich in der Uptycs-Konsole an.
- Rufen Sie den Abschnitt „Exportkonfiguration“ auf.
- Konfigurieren Sie das S3-Exportziel.
- 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-exportein. - 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.
- Testen und aktivieren Sie den Export.
IAM-Nutzer mit Lesezugriff für Google SecOps erstellen
- Rufen Sie die AWS-Konsole > IAM > Nutzer auf.
- Klicken Sie auf Nutzer hinzufügen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Nutzer: Geben Sie
secops-readerein. - Zugriffstyp: Wählen Sie Zugriffsschlüssel – Programmatischer Zugriff aus.
- Nutzer: Geben Sie
- Klicken Sie auf Nutzer erstellen.
- Richtlinie für minimalen Lesezugriff (benutzerdefiniert) anhängen: Nutzer > secops-reader > Berechtigungen > Berechtigungen hinzufügen > Richtlinien direkt anhängen > Richtlinie erstellen.
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" } ] }Legen Sie
secops-reader-policyals Name fest.Gehen Sie zu Richtlinie erstellen > Suchen/Auswählen > Weiter > Berechtigungen hinzufügen.
Gehen Sie zu Sicherheitsanmeldedaten > Zugriffsschlüssel > Zugriffsschlüssel erstellen.
Laden Sie die CSV herunter. Diese Werte werden in den Feed eingegeben.
Feed in Google SecOps konfigurieren, um Uptycs-Logs aufzunehmen
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf + Neuen Feed hinzufügen.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
Uptycs EDR logs. - Wählen Sie als Quelltyp Amazon S3 V2 aus.
- Wählen Sie Uptycs EDR als Logtyp aus.
- Klicken Sie auf Weiter.
- 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.
- S3-URI:
- Klicken Sie auf Weiter.
- 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