JumpCloud Directory Insights-Protokolle erfassen
In diesem Dokument wird beschrieben, wie Sie JumpCloud Directory Insights-Logs mit Google Cloud Storage V2 in Google Security Operations aufnehmen.
JumpCloud ist eine Cloud-Verzeichnisplattform, die Identitätsverwaltung, SSO und Geräteverwaltung bietet. Directory Insights liefert Audit- und Aktivitätsprotokolle zu Nutzerauthentifizierung, Administratoraktionen und Systemereignissen. Der Parser ordnet Logfelder dem Unified Data Model (UDM) zu und verarbeitet Ereignistypen wie Nutzeranmeldungen, Ressourcenänderungen und Sicherheitsaktionen.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Ein GCP-Projekt mit aktivierter Cloud Storage API
- Berechtigungen zum Erstellen und Verwalten von GCS-Buckets und IAM-Richtlinien
- Ein JumpCloud-Konto mit der Rolle Admin oder Manager und einem gültigen API-Schlüssel
Google Cloud Storage-Bucket erstellen
- Gehen Sie zur Google Cloud Console.
- Wählen Sie Ihr Projekt aus oder erstellen Sie ein neues.
- Rufen Sie im Navigationsmenü Cloud Storage > Buckets auf.
- Klicken Sie auf Bucket erstellen.
Geben Sie die folgenden Konfigurationsdetails an:
Einstellung Wert Bucket benennen Geben Sie einen global eindeutigen Namen ein (z. B. jumpcloud-directory-insights-logs).Standorttyp Wählen Sie die Option, die am besten zu Ihren Anforderungen passt (Region, Dual-Region, Multi-Region). Standort Wählen Sie den Standort aus (z. B. us-central1).Speicherklasse Standard (empfohlen für Logs, auf die häufig zugegriffen wird) Zugriffssteuerung Einheitlich (empfohlen) Schutztools Optional: Objektversionsverwaltung oder Aufbewahrungsrichtlinie aktivieren Klicken Sie auf Erstellen.
JumpCloud Directory Insights-Logs nach Google Cloud Storage exportieren
JumpCloud Directory Insights stellt Ereignisse über die Directory Insights API bereit. Verwenden Sie ein geplantes Script oder eine Cloud Run-Funktion, um Ereignisse abzurufen und in GCS zu schreiben.
Generieren Sie einen JumpCloud-API-Schlüssel:
- Melden Sie sich im JumpCloud-Admin-Portal an.
- Gehen Sie zu Ihrem Profilsymbol und wählen Sie Mein API-Schlüssel aus.
- Kopieren Sie den API-Schlüssel.
Erstellen Sie eine Cloud Run-Funktion, die die JumpCloud Directory Insights API abfragt, Ereignisse abruft und in GCS schreibt.
Funktion nach einem Zeitplan mit Cloud Scheduler und Pub/Sub auslösen
- Achten Sie darauf, dass die exportierten Dateien ihr ursprüngliches JSON-Format behalten.
- Jede Datei sollte einen oder mehrere Ereignisdatensätze enthalten.
Google SecOps-Dienstkonto abrufen
- Melden Sie sich in der Google SecOps-Konsole an.
- 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.
- Klicken Sie auf Einzelnen Feed konfigurieren.
- Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
- Wählen Sie JumpCloud Directory Insights als Logtyp aus.
Klicken Sie auf Dienstkonto abrufen. Eine eindeutige E-Mail-Adresse für das Dienstkonto wird angezeigt, z. B.:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comKopieren Sie diese E-Mail-Adresse. Sie verwenden es in der nächsten Aufgabe.
Dem Google SecOps-Dienstkonto IAM-Berechtigungen gewähren
- Rufen Sie Cloud Storage > Buckets auf.
- Klicken Sie auf den Namen Ihres Buckets.
- Wechseln Sie zum Tab Berechtigungen.
- Klicken Sie auf Zugriff erlauben.
- Geben Sie die folgenden Konfigurationsdetails an:
- Hauptkonten hinzufügen: Fügen Sie die E‑Mail-Adresse des Google SecOps-Dienstkontos ein.
- Rollen zuweisen: Wählen Sie Storage Object Viewer aus.
- Klicken Sie auf Speichern.
Feed in Google SecOps konfigurieren, um JumpCloud Directory Insights-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.
- Klicken Sie auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
JumpCloud Directory Insights Logs. - Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
- Wählen Sie JumpCloud Directory Insights als Logtyp aus.
- Klicken Sie auf Weiter.
Geben Sie Werte für die folgenden Eingabeparameter an:
Feld Wert Storage-Bucket-URI gs://jumpcloud-directory-insights-logs/jumpcloud/Option zum Löschen der Quelle Wählen Sie die gewünschte Löschoption aus. Maximales Dateialter (Tage) Der Standardwert ist 180 Tage. Asset-Namespace Der Asset-Namespace Labels für Datenaufnahme Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll - Ersetzen Sie
jumpcloud-directory-insights-logsdurch den tatsächlichen Namen Ihres GCS-Buckets. - Fügen Sie am Ende des URI immer den abschließenden Schrägstrich (
/) ein.
- Ersetzen Sie
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 |
|---|---|---|
| data.profile_list.payload_content.payload_type, data.profile_list.payload_content.payload_identifier, data.profile_list.payload_content.payload_uuid, data.profile_list.payload_content.payload_organization, data.profile_list.payload_content.payload_display_name, data.profile_list.payload_content.payload_description | über | Zusammengeführt mit Attributlabels aus payloadContent |
| data.association.op, data.association.action_source, data.geoip.region_code, data.service, data.event_type, data.@version, data.application.version, data.application.publisher, data.application.uninstall_string, data.changes.0.field, data.changes.0.from, data.changes.0.to, data.available_os_updates.allows_install_later | additional.fields | Mit entsprechenden Labels zusammengeführt |
| extensions.auth.type | Wird auf „MACHINE“ gesetzt, wenn „event_type“ „USER_LOGIN“ ist | |
| data.timestamp | metadata.event_timestamp | Konvertiert mit Datumsübereinstimmung ISO8601, RFC 3339, yyyy-MM-ddTHH:mm:ss.SSSSSSZ |
| data.message, data.client_ip, data.initiated_by.username, data.system.hostname | metadata.event_type | Wird auf USER_LOGIN gesetzt, wenn die Nachricht „angemeldet“ enthält und das Ziel nicht leer ist. Andernfalls wird USER_UNCATEGORIZED gesetzt, wenn IP und Nutzer-ID vorhanden sind. Andernfalls wird STATUS_UPDATE gesetzt, wenn Hostname oder IP vorhanden sind. Andernfalls wird USER_UNCATEGORIZED gesetzt, wenn die Nutzer-ID vorhanden ist. Andernfalls wird GENERIC_EVENT gesetzt. |
| data.id | metadata.product_log_id | Wert direkt kopiert |
| data.@version, data.application.version | metadata.product_version | Auf data.@version festgelegt und dann durch data.application.version ersetzt |
| data.application.name | principal.application | Wert direkt kopiert |
| data.mdm_type | principal.asset.hardware | Zusammengeführt mit Hersteller, festgelegt auf data.mdm_type |
| data.command_uuid | principal.asset_id | Verkettet als „commandUuid:“ + data.command_uuid |
| data.system.hostname | principal.hostname | Wert direkt kopiert |
| data.client_ip | principal.ip | Zusammengeführt aus data.client_ip |
| data.geoip.country_code | principal.location.country_or_region | Wert direkt kopiert |
| data.geoip.region_code | principal.location.name | Wert direkt kopiert |
| data.geoip.latitude | principal.location.region_latitude | In String und dann in Gleitkommazahl konvertiert |
| data.geoip.longitude | principal.location.region_longitude | In String und dann in Gleitkommazahl konvertiert |
| data.geoip.region_name | principal.location.state | Wert direkt kopiert |
| data.application.path, data.process_name | principal.process.file.full_path | Auf „data.application.path“ festgelegt und dann durch „data.process_name“ ersetzt |
| data.association.connection.from.name, data.mdm_device_manager_id, data.request_type | principal.resource.attribute.labels | Zusammengeführt mit Labels für connection_from_name, mdm_device_manager_id, request_type |
| data.system.id, data.resource.id, data.mdm_device_id | principal.resource.id | Auf „data.system.id“ festgelegt, dann durch „data.resource.id“ ersetzt, dann durch „data.mdm_device_id“ ersetzt |
| data.resource.username | principal.resource.name | Wert direkt kopiert |
| data.association.connection.from.object_id | principal.resource.product_object_id | Wert direkt kopiert |
| data.association.connection.from.type | principal.resource.type | Wert direkt kopiert |
| data.initiated_by.email | principal.user.email_addresses | Zusammengeführt, wenn die E-Mail-Adresse mit ^.+@.+$ übereinstimmt |
| data.system.displayName | principal.user.user_display_name | Wert direkt kopiert |
| data.initiated_by.username, data.admin_info.name | principal.user.userid | Auf data.initiated_by.username festgelegt, dann durch data.admin_info.name ersetzt, dann durch data.initiated_by.username ersetzt |
| data.success, data.status | sec_result.action | Set to ALLOW if success true or status Acknowledged, BLOCK if success false |
| data.status, data.success | sec_result.action_details | Set to status if not empty, else success |
| data.success, data.status, data.security_info.management_status.is_activation_lock_manageable, data.security_info.management_status.is_user_enrollment, data.security_info.management_status.enrolled_via_dep, data.organization, data.windows_meta.logon_type, data.security_info.management_status.user_approved_enrollment | sec_result.detection_fields | Zusammengeführt mit Labels für is_activation_lock_manageable, is_user_enrollment, enrolled_via_dep, organization, logon_type, user_approved_enrollment |
| data.query_responses.device_name | target.hostname | Wert direkt kopiert |
| data.query_responses.wifi_mac | target.mac | Zusammengeführt aus data.query_responses.wifi_mac |
| data.query_responses.model_name | target.platform | Wird auf „MAC“ gesetzt, wenn (?i)mac übereinstimmt. |
| data.query_responses.os_version | target.platform_version | Wert direkt kopiert |
| data.query_responses.available_device_capacity, data.query_responses.device_capacity | target.resource.attribute.labels | Zusammengeführt mit Labels für available_device_capacity, device_capacity |
| data.association.connection.to.name | target.resource.name | Wert direkt kopiert |
| data.association.connection.to.object_id | target.resource.product_object_id | Wert direkt kopiert |
| data.association.connection.to.type | target.resource.type | Wert direkt kopiert |
| data.profile_list.payload_organization | target.user.department | Zusammengeführt aus profile_payload_organization |
| metadata.vendor_name | Legen Sie diesen Wert auf „JUMPCLOUD_DIRECTORY_INSIGHTS“ fest. | |
| metadata.product_name | Legen Sie diesen Wert auf „JUMPCLOUD_DIRECTORY_INSIGHTS“ fest. | |
data.alert_id |
event.idm.read_only_udm.metadata.product_log_id |
Aus Änderungsprotokoll zugeordnet |
data.alert_title |
event.idm.read_only_udm.security_result.summary |
Aus Änderungsprotokoll zugeordnet |
data.category |
event.idm.read_only_udm.security_result.category_details |
Aus Änderungsprotokoll zugeordnet |
data.description |
event.idm.read_only_udm.security_result.description |
Aus Änderungsprotokoll zugeordnet |
data.priority |
event.idm.read_only_udm.security_result.priority |
Aus Änderungsprotokoll zugeordnet |
data.rule_id |
event.idm.read_only_udm.security_result.rule_id |
Aus Änderungsprotokoll zugeordnet |
data.event_description |
event.idm.read_only_udm.metadata.description |
Aus Änderungsprotokoll zugeordnet |
data.di_event.event_type |
event.idm.read_only_udm.metadata.product_event_type |
Aus Änderungsprotokoll zugeordnet |
data.di_event.initiated_by.email |
event.idm.read_only_udm.principal.user.email_addresses |
Aus Änderungsprotokoll zugeordnet |
data.di_event.initiated_by.id |
event.idm.read_only_udm.principal.user.product_object_id |
Aus Änderungsprotokoll zugeordnet |
data.di_event.client_ip |
event.idm.read_only_udm.principal.ip |
Aus Änderungsprotokoll zugeordnet |
data.di_event.association.connection.from.name |
event.idm.read_only_udm.target.group.group_display_name |
Aus Änderungsprotokoll zugeordnet |
data.di_event.association.connection.to.name |
event.idm.read_only_udm.about.user.userid |
Aus Änderungsprotokoll zugeordnet |
data.di_event.association.connection.to.object_id |
event.idm.read_only_udm.about.user.product_object_id |
Aus Änderungsprotokoll zugeordnet |
data.di_event.success |
event.idm.read_only_udm.security_result.action |
Aus Änderungsprotokoll zugeordnet |
data.di_event.service |
event.idm.read_only_udm.target.application |
Aus Änderungsprotokoll zugeordnet |
data.di_event.geoip.country_code |
event.idm.read_only_udm.principal.location.country_or_region |
Aus Änderungsprotokoll zugeordnet |
data.organization_name |
event.idm.read_only_udm.principal.user.company_name |
Aus Änderungsprotokoll zugeordnet |
data.di_event.@version |
event.idm.read_only_udm.metadata.product_version |
Aus Änderungsprotokoll zugeordnet |
data.source_url |
event.idm.read_only_udm.principal.url |
Aus Änderungsprotokoll zugeordnet |
data.di_event.initiated_by.source |
event.idm.read_only_udm.principal.hostname |
Aus Änderungsprotokoll zugeordnet |
data.source_name |
event.idm.read_only_udm.principal.user.userid |
Aus Änderungsprotokoll zugeordnet |
data.di_event.geoip.latitude |
event.idm.read_only_udm.principal.location.region_latitude |
Aus Änderungsprotokoll zugeordnet |
data.di_event.geoip.longitude |
event.idm.read_only_udm.principal.location.region_longitude |
Aus Änderungsprotokoll zugeordnet |
data.di_event.geoip.region_name |
event.idm.read_only_udm.principal.location.state |
Aus Änderungsprotokoll zugeordnet |
data.di_event.organization |
event.idm.read_only_udm.security_result.detection_fields |
Aus Änderungsprotokoll zugeordnet |
association_op", "action_source", and "sso_token_success |
additional.fields |
Aus Änderungsprotokoll zugeordnet |
connection_from_type |
principal.resource.resource_type |
Aus Änderungsprotokoll zugeordnet |
connection_from_object_id |
principal.resource.product_object_id |
Aus Änderungsprotokoll zugeordnet |
connection_to_name |
target.resource.name |
Aus Änderungsprotokoll zugeordnet |
connection_to_type |
target.resource.resource_type |
Aus Änderungsprotokoll zugeordnet |
connection_to_object_id |
target.resource.product_object_id |
Aus Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten