Fingerabdruck-Logs erfassen
Parserversion: 1.0
In diesem Dokument wird beschrieben, wie Sie Fingerprint (früher FingerprintJS) so konfigurieren, dass Logs über Webhooks an Google Security Operations gesendet werden.
Fingerprint ist eine Device-Intelligence-Plattform, die Funktionen zur Besucheridentifizierung und Betrugserkennung bietet. Es generiert eindeutige Besucher-IDs und liefert intelligente Signale, darunter Bot-Erkennung, VPN-Erkennung, Inkognitomodus-Erkennung und andere Geräteinformationen. Wenn ein Besucher über den FingerprintJS-JavaScript-Agenten identifiziert wird, können Webhooks die Identifikationsereignisdaten in Echtzeit an Google Security Operations senden.
Hinweis
Prüfen Sie, ob die folgenden Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- FingerprintJS-Konto mit Webhook-Unterstützung
- Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)
- FingerprintJS-JavaScript-Agent, der auf Ihrer Website oder in Ihrer Anwendung installiert ist
Webhook-Feed in Google SecOps erstellen
Feed erstellen
- 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 der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
FingerprintJS Identification Events. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie FingerprintJS als Protokolltyp aus.
- Klicken Sie auf Weiter.
- Geben Sie Werte für die folgenden Eingabeparameter an:
- Trennzeichen für Aufteilung (optional): Leer lassen. Jede Webhook-Anfrage enthält ein einzelnes Identifikationsereignis.
- Asset-Namespace: Der Asset-Namespace.
- Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
- Klicken Sie auf Weiter.
- Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
Secret-Schlüssel generieren und speichern
Nachdem Sie den Feed erstellt haben, müssen Sie einen Secret-Schlüssel für die Authentifizierung generieren:
- Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
- In einem Dialogfeld wird der geheime Schlüssel angezeigt.
- Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.
Wichtig: Der geheime Schlüssel wird nur einmal angezeigt und kann später nicht mehr abgerufen werden. Wenn Sie ihn verlieren, müssen Sie einen neuen geheimen Schlüssel generieren.
Feed-Endpunkt-URL abrufen
- Gehen Sie zum Tab Details des Feeds.
- Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
Das URL-Format lautet:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDabei ist
{region}die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1) und{parent}der Ressourcenpfad im Formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Speichern Sie diese URL für die nächsten Schritte.
Klicken Sie auf Fertig.
Google Cloud API-Schlüssel erstellen
Chronicle erfordert einen API-Schlüssel für die Authentifizierung. Erstellen Sie in der Google Cloud Console einen eingeschränkten API-Schlüssel.
API-Schlüssel erstellen
- Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
- Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Chronicle-Instanz verknüpft ist).
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
- Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
- Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.
API-Schlüssel einschränken
- Auf der Seite mit den Einstellungen für den API-Schlüssel:
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
Chronicle FingerprintJS Webhook API Key).
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Gehen Sie unter API-Einschränkungen so vor:
- Wählen Sie Schlüssel einschränken aus.
- Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
- Klicken Sie auf Speichern.
- Kopieren Sie den API-Schlüsselwert aus dem Feld API-Schlüssel oben auf der Seite.
Speichern Sie den API-Schlüssel an einem sicheren Ort.
FingerprintJS-Webhook konfigurieren
Webhook-URL erstellen
Kombinieren Sie die Chronicle-Endpunkt-URL und den API-Schlüssel:
<ENDPOINT_URL>?key=<API_KEY>Beispiel:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
Webhook im FingerprintJS-Dashboard erstellen
- Melden Sie sich im FingerprintJS-Dashboard an.
- Klicken Sie auf Dashboard > Webhooks.
- Klicken Sie auf Add webhook (Webhook hinzufügen).
- Geben Sie die folgenden Konfigurationsdetails an:
- URL: Fügen Sie die vollständige Endpunkt-URL mit dem API-Schlüssel von oben ein.
- Umgebung (optional): Wenn Sie eine Umgebung auswählen, meldet Ihr Webhook nur Ereignisse aus einer übereinstimmenden Umgebung. Lassen Sie das Feld leer, um Ereignisse aus allen Umgebungen zu empfangen.
- Basisauthentifizierung (optional): Maximieren Sie Basisauthentifizierung, wenn Sie eine zusätzliche Authentifizierung hinzufügen möchten. Für die Chronicle-Integration können Sie dieses Feld leer lassen, da die Authentifizierung über den API-Schlüssel und den Secret Key erfolgt.
- Klicken Sie auf Webhook erstellen.
- In einem Erfolgsfenster wird Webhooks erstellt angezeigt.
- Wichtig: Wenn Sie Webhook-Signaturen verwenden (nur Enterprise-Tarif), kopieren und speichern Sie den Verschlüsselungsschlüssel, der im Erfolgsfenster angezeigt wird. Der Schlüssel wird nur einmal angezeigt.
Geheimen Chronicle-Schlüssel zum Webhook hinzufügen
FingerprintJS unterstützt beim Erstellen von Webhooks keine benutzerdefinierten HTTP-Header. Sie müssen den geheimen Chronicle-Schlüssel als Suchparameter in der Webhook-URL hinzufügen.
Aktualisieren Sie die Webhook-URL, um den geheimen Schlüssel einzufügen:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Beispiel:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
So aktualisieren Sie die Webhook-URL:
- Rufen Sie im FingerprintJS-Dashboard Dashboard > Webhooks auf.
- Suchen Sie Ihren Webhook in der Tabelle und klicken Sie auf das Symbol Bearbeiten.
- Aktualisieren Sie das Feld URL mit der vollständigen URL, einschließlich API-Schlüssel und Secret Key.
- Klicken Sie auf Webhook bearbeiten.
Webhook testen
- Rufen Sie im FingerprintJS-Dashboard Dashboard > Webhooks auf.
- Suchen Sie Ihren Webhook in der Tabelle.
- Klicken Sie auf Testereignis senden.
- Warten Sie auf die Bestätigung, dass das Testereignis erfolgreich gesendet wurde.
Prüfen Sie, ob der Webhook einen erfolgreichen Übermittlungsstatus anzeigt.
Referenz zu Authentifizierungsmethoden
Chronicle-Webhook-Feeds unterstützen mehrere Authentifizierungsmethoden. FingerprintJS-Webhooks verwenden Abfrageparameter für die Authentifizierung.
Methode mit Suchparametern
FingerprintJS unterstützt beim Erstellen von Webhooks keine benutzerdefinierten HTTP-Header. Daher müssen die Anmeldedaten an die URL angehängt werden.
URL-Format:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Beispiel:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Anfrageformat:
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "visitorId": "3HNey93AkBW6CRbxV6xP", "requestId": "1708102555327.NLOjmg", "timestamp": 1582299576512 }
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| rawDeviceAttributes.architecture.value, rawDeviceAttributes.audio.value, rawDeviceAttributes.colorDepth.value, rawDeviceAttributes.colorGamut.value, rawDeviceAttributes.contrast.value, rawDeviceAttributes.cookiesEnabled.value, rawDeviceAttributes.deviceMemory.value, rawDeviceAttributes.fonts.value, rawDeviceAttributes.forcedColors.value, rawDeviceAttributes.hardwareConcurrency.value, rawDeviceAttributes.hdr.value, rawDeviceAttributes.indexedDB.value, rawDeviceAttributes.localStorage.value, rawDeviceAttributes.math.value, rawDeviceAttributes.monochrome.value, rawDeviceAttributes.openDatabase.value, rawDeviceAttributes.pdfViewerEnabled.value, rawDeviceAttributes.reducedMotion.value, rawDeviceAttributes.screenFrame.value, rawDeviceAttributes.screenResolution.value, rawDeviceAttributes.sessionStorage.value, rawDeviceAttributes.touchSupport.value.maxTouchPoints, rawDeviceAttributes.languages.value, rawDeviceAttributes.vendorFlavors.value, rawDeviceAttributes.fontPreferences.value.apple, rawDeviceAttributes.fontPreferences.value.default, rawDeviceAttributes.fontPreferences.value.min, rawDeviceAttributes.fontPreferences.value.mono, rawDeviceAttributes.fontPreferences.value.sans, rawDeviceAttributes.fontPreferences.value.serif, rawDeviceAttributes.fontPreferences.value.system | additional.fields | Zusammengeführt aus Labels, die aus Quellfeldern erstellt wurden |
| has_principal, has_target, has_target_resource | metadata.event_type | Wird auf „NETWORK_CONNECTION“ gesetzt, wenn „has_principal“ und „has_target“ wahr sind, andernfalls auf „USER_RESOURCE_ACCESS“, wenn „has_target_resource“ wahr ist, andernfalls auf „STATUS_UPDATE“, wenn „has_principal“ wahr ist, andernfalls auf „GENERIC_EVENT“ |
| source_type | metadata.product_event_type | Wert direkt kopiert |
| requestId | metadata.product_log_id | Wert direkt kopiert |
| browserDetails.userAgent | network.http.parsed_user_agent | Aus browserDetails.userAgent geparst |
| browserDetails.browserName | network.http.parsed_user_agent.browser | Wert direkt kopiert |
| browserDetails.browserFullVersion | network.http.parsed_user_agent.browser_version | Wert direkt kopiert |
| browserDetails.device | network.http.parsed_user_agent.device | Wert direkt kopiert |
| network.http.parsed_user_agent.family | Auf „USER_DEFINED“ festgelegt | |
| browserDetails.os | network.http.parsed_user_agent.os | Wert direkt kopiert |
| browserDetails.clientReferrer | network.http.referral_url | Wert direkt kopiert |
| browserDetails.userAgent, userAgent | network.http.user_agent | Wert aus userAgent, wenn nicht leer, andernfalls browserDetails.userAgent |
| tag.session | network.session_id | Wert direkt kopiert |
| rawDeviceAttributes.vendor.value | principal.administrative_domain | Wert direkt kopiert |
| ip | principal.asset.ip | Wert direkt kopiert |
| ip | principal.ip | Wert direkt kopiert |
| ipInfo.v4.geolocation.city.name | principal.location.city | Wert direkt kopiert |
| ipInfo.v4.geolocation.country.name | principal.location.country_or_region | Wert direkt kopiert |
| ipInfo.v4.geolocation.latitude | principal.location.region_coordinates.latitude | In Gleitkommazahl umgewandelt |
| ipInfo.v4.geolocation.longitude | principal.location.region_coordinates.longitude | In Gleitkommazahl umgewandelt |
| browserDetails.osVersion, rawDeviceAttributes.platform.value | principal.platform_version | Wert aus rawDeviceAttributes.platform.value, wenn nicht leer, andernfalls browserDetails.osVersion |
| ipInfo.v4.asn.asn, ipInfo.v4.asn.network, ipInfo.v4.asn.name, ipInfo.v4.geolocation.accuracyRadius, ipInfo.v4.geolocation.continent.name, ipInfo.v4.geolocation.timezone, ipInfo.v4.geolocation.subdivisions.isoCode, ipInfo.v4.geolocation.subdivisions.name | principal.resource.attribute.labels | Zusammengeführt aus Labels, die aus Quellfeldern erstellt wurden |
| bot.result, browserDetails.browserMajorVersion, confidence.score, confidence.revision, developerTools.result, highActivity.result, incognito, ipBlocklist.result, ipBlocklist.details.attackSource, ipBlocklist.details.emailSpam, visitorFound, visitorId, tag.request, privacySettings.result, proxy.result, suspectScore.result, tor.result, virtualMachine.result, tampering.anomalyScore, tampering.antiDetectBrowser, tampering.result, vpn.confidence, vpn.originCountry, vpn.originTimezone, vpn.result, vpn.methods.auxiliaryMobile, vpn.methods.osMismatch, vpn.methods.publicVPN, vpn.methods.timezoneMismatch, velocity.distinctCountry.intervals.1h, velocity.distinctCountry.intervals.24h, velocity.distinctCountry.intervals.5m, velocity.distinctIp.intervals.1h, velocity.distinctIp.intervals.24h, velocity.distinctIp.intervals.5m, velocity.events.intervals.1h, velocity.events.intervals.24h, velocity.events.intervals.5m, velocity.ipEvents.intervals.1h, velocity.ipEvents.intervals.24h, velocity.ipEvents.intervals.5m, rawDeviceAttributes.webGlBasics.value.renderer, rawDeviceAttributes.webGlBasics.value.rendererUnmasked, rawDeviceAttributes.webGlBasics.value.vendorUnmasked, rawDeviceAttributes.webGlBasics.value.shadingLanguageVersion, rawDeviceAttributes.webGlExtensions.value.contextAttributes, rawDeviceAttributes.webGlExtensions.value.extensions, rawDeviceAttributes.webGlExtensions.value.extensionParameters, rawDeviceAttributes.webGlExtensions.value.parameters, rawDeviceAttributes.webGlExtensions.value.shaderPrecisions, rawDeviceAttributes.mathML.value.bottom, rawDeviceAttributes.mathML.value.top, rawDeviceAttributes.mathML.value.left, rawDeviceAttributes.mathML.value.right, rawDeviceAttributes.mathML.value.width, rawDeviceAttributes.mathML.value.height, rawDeviceAttributes.mathML.value.font, rawDeviceAttributes.mathML.value.x, rawDeviceAttributes.mathML.value.y, rawDeviceAttributes.emoji.value.bottom, rawDeviceAttributes.emoji.value.top, rawDeviceAttributes.emoji.value.left, rawDeviceAttributes.emoji.value.right, rawDeviceAttributes.emoji.value.width, rawDeviceAttributes.emoji.value.height, rawDeviceAttributes.emoji.value.font, rawDeviceAttributes.emoji.value.x, rawDeviceAttributes.emoji.value.y, rawDeviceAttributes.canvas.value.Geometry, rawDeviceAttributes.canvas.value.Text, rawDeviceAttributes.canvas.value.Winding | security_result.detection_fields | Zusammengeführt aus Labels, die aus Quellfeldern erstellt wurden |
| rawDeviceAttributes.webGlBasics.value.vendor | target.administrative_domain | Wert direkt kopiert |
| ipInfo.v6.address | target.asset.ip | Wert direkt kopiert |
| ipInfo.v6.address | target.ip | Wert direkt kopiert |
| ipInfo.v6.geolocation.city.name | target.location.city | Wert direkt kopiert |
| ipInfo.v6.geolocation.country.name | target.location.country_or_region | Wert direkt kopiert |
| ipInfo.v6.geolocation.latitude | target.location.region_coordinates.latitude | In Gleitkommazahl umgewandelt |
| ipInfo.v6.geolocation.longitude | target.location.region_coordinates.longitude | In Gleitkommazahl umgewandelt |
| Pfad | target.path | Wert direkt kopiert |
| rawDeviceAttributes.webGlBasics.value.version | target.platform_version | Wert direkt kopiert |
| ipInfo.v6.asn.asn, ipInfo.v6.asn.network, ipInfo.v6.asn.name, ipInfo.v6.geolocation.accuracyRadius, ipInfo.v6.geolocation.continent.name, ipInfo.v6.geolocation.timezone, ipInfo.v6.geolocation.subdivisions.isoCode, ipInfo.v6.geolocation.subdivisions.name | target.resource.attribute.labels | Zusammengeführt aus Labels, die aus Quellfeldern erstellt wurden |
| URL | target.url | Wert direkt kopiert |
| metadata.product_name | Legen Sie „FINGERPRINT_JS“ fest. | |
| metadata.vendor_name | Legen Sie „FINGERPRINT_JS“ fest. |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten