Collecter les journaux d'empreintes digitales

Version de l'analyseur : 1.0

Compatible avec :

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

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  3. Sur la page suivante, cliquez sur Configurer un seul flux.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, FingerprintJS Identification Events).
  5. Sélectionnez Webhook comme type de source.
  6. Sélectionnez FingerprintJS comme type de journal.
  7. Cliquez sur Suivant.
  8. 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.
  9. Cliquez sur Suivant.
  10. 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 :

  1. Sur la page d'informations du flux, cliquez sur Générer une clé secrète.
  2. Une boîte de dialogue affiche la clé secrète.
  3. 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

  1. Accédez à l'onglet Détails du flux.
  2. Dans la section Informations sur le point de terminaison, copiez l'URL du point de terminaison du flux.
  3. Le format d'URL est le suivant :

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Où {region} est la région de votre instance Google SecOps (par exemple, us, europe ou asia-southeast1) et {parent} est le chemin d'accès à la ressource au format projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Enregistrez cette URL pour les étapes suivantes.

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

  1. Accédez à la page Identifiants de la consoleGoogle Cloud .
  2. Sélectionnez votre projet (celui associé à votre instance Chronicle).
  3. Cliquez sur Créer des identifiants > Clé API.
  4. Une clé API est créée et s'affiche dans une boîte de dialogue.
  5. Cliquez sur Modifier la clé API pour restreindre la clé.

Restreindre la clé API

  1. Sur la page des paramètres de la clé API :
    • Nom : saisissez un nom descriptif (par exemple, Chronicle FingerprintJS Webhook API Key).
  2. Sous Restrictions relatives aux API :
    1. Sélectionnez Restreindre la clé.
    2. Dans le menu déroulant Sélectionner des API, recherchez et sélectionnez API Google SecOps (ou API Chronicle).
  3. Cliquez sur Enregistrer.
  4. Copiez la valeur de la clé API dans le champ Clé API en haut de la page.
  5. 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

  1. Connectez-vous au tableau de bord FingerprintJS.
  2. Accédez à Tableau de bord > Webhooks.
  3. Cliquez sur Add webhook (Ajouter un Webhook).
  4. 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.
  5. Cliquez sur Créer un webhook.
  6. Un message de confirmation s'affiche : Webhooks créés.
  7. 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 :

  1. Dans le tableau de bord FingerprintJS, accédez à Tableau de bord > Webhooks.
  2. Recherchez votre webhook dans le tableau, puis cliquez sur l'icône Modifier.
  3. Mettez à jour le champ URL avec l'URL complète, y compris la clé API et la clé secrète.
  4. Cliquez sur Modifier le webhook.

Tester le webhook

  1. Dans le tableau de bord FingerprintJS, accédez à Tableau de bord > Webhooks.
  2. Recherchez votre webhook dans le tableau.
  3. Cliquez sur Envoyer un événement de test.
  4. Attendez de recevoir la confirmation que l'événement de test a bien été envoyé.
  5. 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.