Collecter les journaux d'empreintes digitales
Version de l'analyseur : 1.0
Ce document explique comment configurer Fingerprint (anciennement FingerprintJS) pour envoyer des journaux à Google Security Operations à l'aide de webhooks.
Fingerprint est une plate-forme d'intelligence des appareils qui fournit des fonctionnalités d'identification des visiteurs et de détection des fraudes. Il génère des identifiants de visiteur uniques et fournit des signaux intelligents, y compris la détection des bots, des VPN, du mode navigation privée et d'autres insights sur l'intelligence des appareils. Lorsqu'un visiteur est identifié via l'agent JavaScript FingerprintJS, les webhooks peuvent envoyer les données d'événement d'identification à Google Security Operations en temps réel.
Avant de commencer
Assurez-vous de remplir les conditions suivantes :
- Une instance Google SecOps
- Compte FingerprintJS compatible avec les webhooks
- Accès à la console Google Cloud (pour la création de clés API)
- Agent JavaScript FingerprintJS installé sur votre site Web ou votre application
Créer un flux de webhook dans Google SecOps
Créer le flux
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Sur la page suivante, cliquez sur Configurer un seul flux.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
FingerprintJS Identification Events). - Sélectionnez Webhook comme type de source.
- Sélectionnez FingerprintJS comme type de journal.
- Cliquez sur Suivant.
- Spécifiez les valeurs des paramètres d'entrée suivants :
- Délimiteur de division (facultatif) : laissez ce champ vide. Chaque requête de webhook contient un seul événement d'identification.
- Espace de noms de l'élément : espace de noms de l'élément.
- Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux.
- Cliquez sur Suivant.
- Vérifiez la configuration de votre nouveau flux sur l'écran Finaliser, puis cliquez sur Envoyer.
Générer et enregistrer une clé secrète
Après avoir créé le flux, vous devez générer une clé secrète pour l'authentification :
- Sur la page d'informations du flux, cliquez sur Générer une clé secrète.
- Une boîte de dialogue affiche la clé secrète.
- Copiez et enregistrez la clé secrète de manière sécurisée.
Important : La clé secrète ne s'affiche qu'une seule fois et ne peut pas être récupérée ultérieurement. Si vous la perdez, vous devrez en générer une nouvelle.
Obtenir l'URL du point de terminaison du flux
- Accédez à l'onglet Détails du flux.
- Dans la section Informations sur le point de terminaison, copiez l'URL du point de terminaison du flux.
Le format d'URL est le suivant :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importOù
{region}est la région de votre instance Google SecOps (par exemple,us,europeouasia-southeast1) et{parent}est le chemin d'accès à la ressource au formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Enregistrez cette URL pour les étapes suivantes.
Cliquez sur OK.
Créer Google Cloud une clé API
Chronicle nécessite une clé API pour l'authentification. Créez une clé API restreinte dans la console Google Cloud .
Créer la clé API
- Accédez à la page Identifiants de la consoleGoogle Cloud .
- Sélectionnez votre projet (celui associé à votre instance Chronicle).
- Cliquez sur Créer des identifiants > Clé API.
- Une clé API est créée et s'affiche dans une boîte de dialogue.
- Cliquez sur Modifier la clé API pour restreindre la clé.
Restreindre la clé API
- Sur la page des paramètres de la clé API :
- Nom : saisissez un nom descriptif (par exemple,
Chronicle FingerprintJS Webhook API Key).
- Nom : saisissez un nom descriptif (par exemple,
- Sous Restrictions relatives aux API :
- Sélectionnez Restreindre la clé.
- Dans le menu déroulant Sélectionner des API, recherchez et sélectionnez API Google SecOps (ou API Chronicle).
- Cliquez sur Enregistrer.
- Copiez la valeur de la clé API dans le champ Clé API en haut de la page.
Enregistrez la clé API de manière sécurisée.
Configurer le webhook FingerprintJS
Créer l'URL de webhook
Combinez l'URL du point de terminaison Chronicle et la clé API :
<ENDPOINT_URL>?key=<API_KEY>Exemple :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
Créer un webhook dans le tableau de bord FingerprintJS
- Connectez-vous au tableau de bord FingerprintJS.
- Accédez à Tableau de bord > Webhooks.
- Cliquez sur Add webhook (Ajouter un Webhook).
- Fournissez les informations de configuration suivantes :
- URL : collez l'URL complète du point de terminaison avec la clé API ci-dessus.
- Environnement (facultatif) : si vous sélectionnez un environnement, votre webhook ne signalera que les événements provenant d'un environnement correspondant. Laissez ce champ vide pour recevoir des événements de tous les environnements.
- Authentification de base (facultatif) : développez Authentification de base si vous souhaitez ajouter une authentification supplémentaire. Pour l'intégration de Chronicle, vous pouvez laisser ce champ vide, car l'authentification est gérée via la clé API et la clé secrète.
- Cliquez sur Créer un webhook.
- Un message de confirmation s'affiche : Webhooks créés.
- Important : Si vous utilisez des signatures de webhook (forfait Enterprise uniquement), copiez et enregistrez la clé de chiffrement affichée dans la fenêtre modale de réussite. La clé ne s'affiche qu'une seule fois.
Ajouter la clé secrète Chronicle au webhook
FingerprintJS n'est pas compatible avec les en-têtes HTTP personnalisés lors de la création de webhooks. Vous devez ajouter la clé secrète Chronicle en tant que paramètre de requête dans l'URL de webhook.
Mettez à jour l'URL de webhook pour inclure la clé secrète :
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Exemple :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Pour mettre à jour l'URL du webhook :
- Dans le tableau de bord FingerprintJS, accédez à Tableau de bord > Webhooks.
- Recherchez votre webhook dans le tableau, puis cliquez sur l'icône Modifier.
- Mettez à jour le champ URL avec l'URL complète, y compris la clé API et la clé secrète.
- Cliquez sur Modifier le webhook.
Tester le webhook
- Dans le tableau de bord FingerprintJS, accédez à Tableau de bord > Webhooks.
- Recherchez votre webhook dans le tableau.
- Cliquez sur Envoyer un événement de test.
- Attendez de recevoir la confirmation que l'événement de test a bien été envoyé.
Vérifiez que le webhook affiche un état de distribution réussi.
Référence des méthodes d'authentification
Les flux de webhook Chronicle sont compatibles avec plusieurs méthodes d'authentification. Les webhooks FingerprintJS utilisent des paramètres de requête pour l'authentification.
Méthode des paramètres de requête
FingerprintJS n'est pas compatible avec les en-têtes HTTP personnalisés lors de la création de webhooks. Les identifiants doivent donc être ajoutés à l'URL.
Format d'URL :
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Exemple :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Format de la requête :
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "visitorId": "3HNey93AkBW6CRbxV6xP", "requestId": "1708102555327.NLOjmg", "timestamp": 1582299576512 }
Table de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
| 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 | Fusionné à partir des libellés créés à partir des champs sources |
| has_principal, has_target, has_target_resource | metadata.event_type | Définissez sur "NETWORK_CONNECTION" si has_principal et has_target sont définis sur "true", sinon sur "USER_RESOURCE_ACCESS" si has_target_resource est défini sur "true", sinon sur "STATUS_UPDATE" si has_principal est défini sur "true", sinon sur "GENERIC_EVENT". |
| source_type | metadata.product_event_type | Valeur copiée directement |
| requestId | metadata.product_log_id | Valeur copiée directement |
| browserDetails.userAgent | network.http.parsed_user_agent | Analysé à partir de browserDetails.userAgent |
| browserDetails.browserName | network.http.parsed_user_agent.browser | Valeur copiée directement |
| browserDetails.browserFullVersion | network.http.parsed_user_agent.browser_version | Valeur copiée directement |
| browserDetails.device | network.http.parsed_user_agent.device | Valeur copiée directement |
| network.http.parsed_user_agent.family | Définissez cette option sur "USER_DEFINED". | |
| browserDetails.os | network.http.parsed_user_agent.os | Valeur copiée directement |
| browserDetails.clientReferrer | network.http.referral_url | Valeur copiée directement |
| browserDetails.userAgent, userAgent | network.http.user_agent | Valeur de userAgent si elle n'est pas vide, sinon browserDetails.userAgent |
| tag.session | network.session_id | Valeur copiée directement |
| rawDeviceAttributes.vendor.value | principal.administrative_domain | Valeur copiée directement |
| ip | principal.asset.ip | Valeur copiée directement |
| ip | principal.ip | Valeur copiée directement |
| ipInfo.v4.geolocation.city.name | principal.location.city | Valeur copiée directement |
| ipInfo.v4.geolocation.country.name | principal.location.country_or_region | Valeur copiée directement |
| ipInfo.v4.geolocation.latitude | principal.location.region_coordinates.latitude | Converti en float |
| ipInfo.v4.geolocation.longitude | principal.location.region_coordinates.longitude | Converti en float |
| browserDetails.osVersion, rawDeviceAttributes.platform.value | principal.platform_version | Valeur de rawDeviceAttributes.platform.value si elle n'est pas vide, sinon 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 | Fusionné à partir des libellés créés à partir des champs sources |
| 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 | Fusionné à partir des libellés créés à partir des champs sources |
| rawDeviceAttributes.webGlBasics.value.vendor | target.administrative_domain | Valeur copiée directement |
| ipInfo.v6.address | target.asset.ip | Valeur copiée directement |
| ipInfo.v6.address | target.ip | Valeur copiée directement |
| ipInfo.v6.geolocation.city.name | target.location.city | Valeur copiée directement |
| ipInfo.v6.geolocation.country.name | target.location.country_or_region | Valeur copiée directement |
| ipInfo.v6.geolocation.latitude | target.location.region_coordinates.latitude | Converti en float |
| ipInfo.v6.geolocation.longitude | target.location.region_coordinates.longitude | Converti en float |
| chemin d'accès | target.path | Valeur copiée directement |
| rawDeviceAttributes.webGlBasics.value.version | target.platform_version | Valeur copiée directement |
| 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 | Fusionné à partir des libellés créés à partir des champs sources |
| url | target.url | Valeur copiée directement |
| metadata.product_name | Définissez cette option sur "FINGERPRINT_JS". | |
| metadata.vendor_name | Définissez cette option sur "FINGERPRINT_JS". |
Journal des modifications
Afficher le journal des modifications de cet analyseur
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.