Exporter des journaux vers BigQuery

Vous pouvez acheminer les journaux de plate-forme générés par Google Cloud Fraud Defense depuis Cloud Logging vers BigQuery en créant un récepteur de journaux dans Log Router.

Vous pouvez exporter les journaux de plate-forme vers BigQuery pour conserver les données d'évaluation à long terme, analyser les scores de risque et les codes de motif avec SQL, et visualiser les tendances du trafic dans Data Studio. Les journaux de plate-forme dans Logging ont une période de conservation par défaut de 30 jours, que vous pouvez configurer pour qu'elle dure jusqu'à 3 650 jours.

Fraud Defense est compatible avec la journalisation de la plate-forme pour les opérations d'API v1 suivantes :

• Assessment réponse de projects.assessments.create
• AnnotateAssessmentRequest requête à projects.assessments.annotate

Remarque : La journalisation de la plate-forme n'est pas disponible pour les API v1beta1 et SiteVerify héritées. Pour protéger la confidentialité, les journaux de plate-forme n'incluent pas les informations permettant d'identifier personnellement l'utilisateur fournies pour la prévention de la fraude.

Avant de commencer

Pour obtenir les autorisations nécessaires pour activer les journaux de plate-forme et les acheminer vers BigQuery, demandez à votre administrateur de vous accorder les rôles Identity and Access Management suivants sur votre Google Cloud projet :

• Activer la journalisation de la plate-forme Fraud Defense : Administrateur reCAPTCHA Enterprise (roles/recaptchaenterprise.admin)
• Créer et gérer des récepteurs Logging: Rédacteur de configuration des journaux (roles/logging.configWriter)
• Créer des ensembles de données BigQuery et accorder des autorisations d'écriture au récepteur : Éditeur de données BigQuery (roles/bigquery.dataEditor)

Activer les journaux de plate-forme

Avant d'acheminer les journaux vers BigQuery, activez les journaux de plate-forme dans Fraud Defense :

1. Dans la Google Cloud console, accédez à la page Fraud Defense.

   Accéder à Fraud Defense

2. Vérifiez que le nom de votre projet apparaît dans le sélecteur de ressources.

   Si le nom de votre projet ne s'affiche pas, cliquez sur le sélecteur de ressources, puis sélectionnez votre projet.

3. Cliquez sur Paramètres.

4. Sur la carte Journalisation de la plate-forme, cliquez sur Configurer.

5. Dans le volet Journalisation de la plate-forme, cliquez sur le bouton bascule pour Activer les journaux d'évaluation.

6. (Facultatif) Pour exporter les requêtes d'annotation, cliquez sur le bouton bascule à côté de Activer les journaux d'annotation.

7. Cliquez sur Enregistrer.

Pour en savoir plus sur la gestion des paramètres des journaux de plate-forme, consultez Utiliser les journaux de plate-forme.

Créer un récepteur BigQuery

Une fois que vous avez activé les journaux de plate-forme, créez un récepteur dans le routeur de journaux pour exporter les nouvelles entrées de journal d'évaluation reCAPTCHA vers BigQuery :

1. Dans la Google Cloud console, accédez à la page Routeur de journaux.

   Accéder au routeur de journaux

2. Cliquez sur Créer un récepteur.

3. Dans la section Détails du récepteur, saisissez un nom de récepteur et une description facultative, puis cliquez sur Suivant.

4. Pour configurer l'ensemble de données de destination, procédez comme suit dans la section Destination du récepteur :

   1. Dans le menu Sélectionner le service de récepteur, sélectionnez Ensemble de données BigQuery.
   2. Dans le menu Sélectionner un ensemble de données BigQuery, sélectionnez un ensemble de données existant ou Créer un ensemble de données BigQuery.
   3. Si vous créez un ensemble de données, saisissez son nom, puis cliquez sur Créer un ensemble de données.
   4. Sélectionnez Utiliser des tables partitionnées, puis cliquez sur Suivant.

5. Pour inclure toutes les entrées de journal d'évaluation, dans la section Sélectionner les journaux à inclure dans le récepteur, saisissez le filtre d'inclusion suivant dans le champ Créer un filtre d'inclusion :

   resource.type="recaptchaenterprise.googleapis.com/Key"
   log_id("recaptchaenterprise.googleapis.com/assessment")
   

6. (Facultatif) Pour inclure les journaux de plate-forme assessment et annotation dans le récepteur, saisissez plutôt le filtre suivant :

   resource.type="recaptchaenterprise.googleapis.com/Key"
   (log_id("recaptchaenterprise.googleapis.com/assessment") OR
     log_id("recaptchaenterprise.googleapis.com/annotation"))
   

7. Cliquez sur Suivant.

8. (Facultatif) Configurez des filtres d'exclusion si nécessaire, puis cliquez sur Créer un récepteur.

Une fois le récepteur créé, Logging affiche un message de confirmation et provisionne automatiquement un compte de service rédacteur avec les autorisations nécessaires pour écrire des entrées de journal dans votre ensemble de données BigQuery.

Remarque : Les récepteurs de journaux n'exportent que les nouvelles entrées de journal reçues après leur création. Vous ne pouvez pas exporter rétroactivement les entrées de journal que Logging a reçues avant la création du récepteur.

Tarifs

L'exportation de journaux de plate-forme vers BigQuery entraîne des frais standards pour Logging et BigQuery :

• Pour connaître les coûts d'ingestion et de routage des journaux, consultez les tarifs de Logging.
• Pour connaître les coûts de stockage des données et des requêtes SQL, consultez les tarifs de BigQuery.

Remarque : Pour éviter une facturation redondante des journaux, assurez-vous que les journaux d'audit DATA_WRITE obsolètes ne sont pas activés pour reCAPTCHA. Pour en savoir plus, consultez la section Journaux d'audit de Fraud Defense.

Étape suivante

• Créez des tableaux de bord avec Data Studio.
• En savoir plus sur le stockage BigQuery.
• En savoir plus sur les analyses BigQuery.