Exportar registros a BigQuery

Puedes enrutar los registros de plataforma que genera Google Cloud Fraud Defense desde Cloud Logging a BigQuery mediante la creación de un receptor de registros en el Enrutador de registros.

Puedes exportar registros de plataforma a BigQuery para retener datos de evaluación a largo plazo, analizar las puntuaciones de riesgo y los códigos de motivo con SQL, y visualizar las tendencias de tráfico en Data Studio. Los registros de plataforma en Logging tienen un período de retención predeterminado de 30 días, que puedes configurar hasta 3,650 días.

Fraud Defense admite el registro de plataforma para las siguientes operaciones de la API v1:

• Assessment respuesta de projects.assessments.create
• AnnotateAssessmentRequest solicitud a projects.assessments.annotate

Nota: El registro de plataforma no está disponible para las APIs v1beta1 y heredadasSiteVerify. Para proteger la privacidad, los registros de plataforma no incluyen información de identificación personal (PII) que se proporciona para la prevención del fraude.

Antes de comenzar

Para obtener los permisos que necesitas para habilitar los registros de plataforma y enrutarlos a BigQuery, pídele a tu administrador que te otorgue los siguientes Identity and Access Management roles en tu Google Cloud proyecto:

• Habilitar el registro de plataforma de Fraud Defense: Administrador de reCAPTCHA Enterprise (roles/recaptchaenterprise.admin)
• Crear y administrar receptores de Logging: Escritor de configuración de registros (roles/logging.configWriter)
• Crear conjuntos de datos de BigQuery y otorgar permisos de escritura del receptor: Editor de datos de BigQuery (roles/bigquery.dataEditor)

Habilita los registros de plataforma

Antes de enrutar los registros a BigQuery, habilita los registros de plataforma en Fraud Defense:

1. En la Google Cloud consola de, ve a la página Fraud Defense.

   Ir a Fraud Defense

2. Verifica que el nombre de tu proyecto aparezca en el selector de recursos.

   Si no ves el nombre de tu proyecto, haz clic en el selector de recursos y, luego, selecciona tu proyecto.

3. Haz clic en Configuración.

4. En la tarjeta Registro de plataforma, haz clic en Configurar.

5. En el panel Registro de plataforma, haz clic en el botón de activación de Habilitar registros de evaluación.

6. Opcional: Para exportar solicitudes de anotación, haz clic en el botón de activación junto a Habilitar registros de anotación.

7. Haz clic en Guardar.

Para obtener más información sobre la administración de la configuración de los registros de plataforma, consulta Trabaja con registros de plataforma.

Crea un receptor de BigQuery

Después de habilitar los registros de plataforma, crea un receptor en el Enrutador de registros para exportar las entradas de registro de evaluación de reCAPTCHA nuevas a BigQuery:

1. En la Google Cloud consola de, ve a la página Enrutador de registros.

   Ir a Enrutador de registros

2. Haz clic en Crear un receptor.

3. En la sección Detalles del receptor , ingresa un nombre de receptor y una descripción opcional, y, luego, haz clic en Siguiente.

4. Para configurar el conjunto de datos de destino, completa los siguientes pasos en la sección Destino del receptor:

   1. En el menú Selecciona el servicio del receptor, selecciona Conjunto de datos de BigQuery.
   2. En el menú Selecciona un conjunto de datos de BigQuery, selecciona un conjunto de datos existente o Crea un conjunto de datos de BigQuery nuevo.
   3. Si creas un conjunto de datos nuevo, ingresa un nombre para el conjunto de datos y, luego, haz clic en Crear conjunto de datos.
   4. Selecciona Usar tablas particionadas y, luego, haz clic en Siguiente.

5. Para incluir todas las entradas de registro de evaluación, en la sección Elige registros para incluirlos en el receptor, ingresa el siguiente filtro de inclusión en el campo Crear filtro de inclusión:

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

6. Opcional: Para incluir los registros de plataforma assessment y annotation en el receptor, ingresa el siguiente filtro:

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

7. Haz clic en Siguiente.

8. Opcional: Configura los filtros de exclusión si es necesario y, luego, haz clic en Crear un receptor.

Una vez que se crea el receptor, Logging muestra un mensaje de confirmación y aprovisiona automáticamente una cuenta de servicio de escritor con permisos para escribir entradas de registro en tu conjunto de datos de BigQuery.

Nota: Los receptores de registros exportan solo las entradas de registro nuevas que se reciben después de que se crea el receptor. No puedes exportar de forma retroactiva las entradas de registro que Logging recibió antes de que crearas el receptor.

Precios

La exportación de registros de plataforma a BigQuery genera cargos estándar para Logging y BigQuery:

• Para conocer los costos de la ingesta y el enrutamiento de registros, consulta los precios de Logging.
• Para conocer los costos del almacenamiento de datos y las consulta en SQL, consulta los precios de BigQuery.

Nota: Para evitar la facturación de registros redundantes, asegúrate de que los registros de auditoría DATA_WRITE obsoletos no estén habilitados para reCAPTCHA. Para obtener más información, consulta el registro de auditoría de Fraud Defense .

¿Qué sigue?

• Crea paneles con Data Studio.
• Obtén más información sobre el almacenamiento de BigQuery.
• Obtén más información sobre las estadísticas de BigQuery.