JumpCloud Directory Insights-Protokolle erfassen

Unterstützt in:

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

  1. Gehen Sie zur Google Cloud Console.
  2. Wählen Sie Ihr Projekt aus oder erstellen Sie ein neues.
  3. Rufen Sie im Navigationsmenü Cloud Storage > Buckets auf.
  4. Klicken Sie auf Bucket erstellen.
  5. 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
  6. 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.

  1. Generieren Sie einen JumpCloud-API-Schlüssel:

    1. Melden Sie sich im JumpCloud-Admin-Portal an.
    2. Gehen Sie zu Ihrem Profilsymbol und wählen Sie Mein API-Schlüssel aus.
    3. Kopieren Sie den API-Schlüssel.
  2. Erstellen Sie eine Cloud Run-Funktion, die die JumpCloud Directory Insights API abfragt, Ereignisse abruft und in GCS schreibt.

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

  1. Melden Sie sich in der Google SecOps-Konsole an.
  2. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  3. Klicken Sie auf Neuen Feed hinzufügen.
  4. Klicken Sie auf Einzelnen Feed konfigurieren.
  5. Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
  6. Wählen Sie JumpCloud Directory Insights als Logtyp aus.
  7. 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.com
    
  8. Kopieren Sie diese E-Mail-Adresse. Sie verwenden es in der nächsten Aufgabe.

Dem Google SecOps-Dienstkonto IAM-Berechtigungen gewähren

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets.
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. 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.
  6. Klicken Sie auf Speichern.

Feed in Google SecOps konfigurieren, um JumpCloud Directory Insights-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. Klicken Sie auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. JumpCloud Directory Insights Logs.
  5. Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
  6. Wählen Sie JumpCloud Directory Insights als Logtyp aus.
  7. Klicken Sie auf Weiter.
  8. 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-logs durch den tatsächlichen Namen Ihres GCS-Buckets.
    • Fügen Sie am Ende des URI immer den abschließenden Schrägstrich (/) ein.
  9. Klicken Sie auf Weiter.

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