En este tema, se describe cómo usar trabajos híbridos y activadores de trabajos híbridos para inspeccionar datos externos en busca de información sensible. Para obtener más información sobre los trabajos híbridos y los activadores de trabajos híbridos, incluidos ejemplos de entornos híbridos, consulta Trabajos híbridos y activadores de trabajos híbridos.
Introducción a los trabajos híbridos y los activadores de trabajos híbridos
Los trabajos híbridos y los activadores de trabajos híbridos te permiten ampliar el alcance de la protección que proporciona la Protección de datos sensibles más allá de solicitudes de inspección de contenido simple y análisis del repositorio de Google Cloud Storage. Con trabajos híbridos y activadores de trabajos híbridos, puedes transmitir datos desde prácticamente cualquier fuente, incluido fuera de Google Cloud, directamente a Sensitive Data Protection y permitir que Sensitive Data Protection inspeccione los datos en busca de información sensible. La Protección de datos sensibles guarda y agrega automáticamente los resultados del análisis para un análisis posterior.
Comparación de trabajos híbridos y activadores de trabajos híbridos
Cuando creas trabajos híbridos, se ejecutan hasta que los detengas. Aceptan todos los datos entrantes, siempre y cuando estén enrutados y formateados correctamente.
Los activadores de trabajos híbridos funcionan de manera similar a los trabajos híbridos, pero no necesitas detener un trabajo de forma explícita dentro de un activador de trabajos híbridos. La Protección de datos sensibles detiene automáticamente los trabajos dentro de los activadores de trabajos híbridos al final de cada día.
Además, con un activador de trabajo híbrido, puedes detener e iniciar trabajos nuevos dentro del activador sin tener que volver a configurar tus solicitudes de hybridInspect
. Por ejemplo, puedes enviar datos a un activador de trabajo híbrido, luego detener el trabajo activo, cambiar su configuración, iniciar un trabajo nuevo dentro de ese activador y, luego, seguir enviando datos al mismo activador.
Para obtener más orientación sobre qué opción se ajusta a tu caso de uso, consulta Situaciones típicas de inspección híbrida en esta página.
Definición de términos
En este tema, se usan los siguientes términos:
Datos externos: Datos almacenados fuera de Google Cloud o datos que la Protección de datos sensibles no admite de forma nativa.
Trabajo híbrido: Es un trabajo de inspección que se configura para analizar datos de prácticamente cualquier fuente.
Activador de trabajo híbrido: Es un activador de trabajo que se configura para analizar datos de prácticamente cualquier fuente.
Solicitud
hybridInspect
: Es una solicitud que contiene los datos externos que deseas inspeccionar. Cuando envías esta solicitud, especificas el trabajo híbrido o el activador de trabajo híbrido al que se enviará la solicitud.
Para obtener información general sobre los trabajos y los activadores de trabajo, consulta Trabajos y activadores de trabajo.
Proceso de inspección híbrida
El proceso de inspección híbrida consta de tres pasos.
Elige los datos que quieres enviar a la Protección de datos sensibles.
Los datos pueden provenir de Google Cloud o de fuera de ella. Por ejemplo, puedes configurar una secuencia de comandos o una aplicación personalizada para enviar datos a Sensitive Data Protection, lo que te permite inspeccionar los datos en tránsito, desde otro servicio en la nube, un repositorio de datos local o prácticamente cualquier otra fuente de datos.
Configura un trabajo híbrido o un activador de trabajo híbrido en Sensitive Data Protection desde cero o con una plantilla de inspección.
Después de configurar un trabajo o activador de trabajo híbrido, Sensitive Data Protection escucha de forma activa los datos que se le envían. Cuando tu secuencia de comandos o aplicación personalizada envía datos a este trabajo o activador de trabajo híbrido, los datos se inspeccionan y sus resultados se almacenan según la configuración.
Cuando configuras el trabajo híbrido o el activador de trabajo híbrido, puedes especificar dónde quieres guardar o publicar los resultados. Entre las opciones, se incluyen guardar en BigQuery y publicar notificaciones en Pub/Sub, Cloud Monitoring o correo electrónico.
Envía una solicitud
hybridInspect
al trabajo híbrido o al activador de trabajo híbrido.Una solicitud
hybridInspect
contiene los datos que se analizarán. En la solicitud, incluye metadatos (también conocidos como etiquetas y identificadores de tablas) que describan el contenido y permitan que la Protección de datos sensibles identifique la información de la que deseas hacer un seguimiento. Por ejemplo, si analizas datos relacionados en varias solicitudes (como filas en la misma tabla de base de datos), puedes usar los mismos metadatos en esas solicitudes relacionadas. Luego, puedes recopilar, sumar y analizar los resultados de esa tabla de base de datos.
A medida que se ejecuta el trabajo híbrido y se inspeccionan las solicitudes, los resultados de la inspección están disponibles cuando Sensitive Data Protection los genera. Por el contrario, las acciones, como las notificaciones de Pub/Sub, no se producen hasta que tu aplicación finaliza la tarea híbrida.
Consideraciones
Cuando trabajes con trabajos híbridos y activadores de trabajos, ten en cuenta los siguientes puntos:
- Los trabajos híbridos y los activadores de trabajos híbridos no admiten el filtrado ni el muestreo.
- Las tareas y los activadores de tareas no están sujetos a los objetivos de nivel de servicio (SLO), pero hay pasos que puedes seguir para reducir la latencia. Para obtener más información, consulta Latencia de trabajo.
Antes de comenzar
Antes de configurar y usar trabajos híbridos o activadores de trabajos híbridos, asegúrate de haber hecho lo siguiente:
Crea un proyecto nuevo, habilita la facturación y habilita la protección de datos sensibles
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Sensitive Data Protection API.
Configurar la fuente de datos.
Para que Sensitive Data Protection pueda inspeccionar tus datos, debes enviarlos a la función. Independientemente del método que uses para configurar el trabajo híbrido o el activador de trabajo híbrido, debes configurar tu fuente externa para enviar datos a la API de DLP.
Para obtener información sobre el formato requerido para las solicitudes de inspección híbrida, consulta Formato de los elementos de contenido híbrido. Para obtener información sobre los tipos de metadatos que puedes incluir con los datos de tu solicitud, consulta Tipos de metadatos que puedes proporcionar.
Crea un trabajo híbrido o un activador de trabajo híbrido
Para permitir que Sensitive Data Protection inspeccione los datos que le envías, primero debes configurar un trabajo híbrido o un activador de trabajo híbrido. Para obtener información sobre cuál crear, consulta Situaciones típicas de inspección híbrida en esta página.
Console
En la consola de Google Cloud, ve a la página Crear un trabajo o un activador de trabajo:
Ir a Crear trabajo o activador de trabajo
En las siguientes secciones, se describe cómo completar las secciones de la página Crear trabajo o activador de trabajo que son relevantes para las operaciones de inspección híbrida.
Elige los datos de entrada
En esta sección, especificas los datos de entrada que Sensitive Data Protection debe inspeccionar.
- Opcional: En Nombre, ingresa un valor en el campo ID del trabajo para asignarle un nombre al trabajo. Si dejas este campo en blanco, Sensitive Data Protection generará automáticamente un identificador.
- Opcional: En el menú Ubicación del recurso, elige la región en la que quieres almacenar el trabajo híbrido o el activador de trabajo híbrido. Para obtener más información, consulta Cómo especificar ubicaciones de procesamiento.
En Tipo de almacenamiento, selecciona Híbrido.
Opcional: En Descripción, describe el trabajo híbrido o el activador de trabajo híbrido que estás creando. Por ejemplo, puedes incluir información sobre la fuente de los datos que se inspeccionarán.
Opcional: En Etiquetas obligatorias, haz clic en Agregar etiqueta y, luego, ingresa una etiqueta que desees que se requiera en las solicitudes de
hybridInspect
. Esta tarea híbrida o el activador de tareas híbridas no procesan una solicitudhybridInspect
que no especifique esta etiqueta. Puedes agregar hasta 10 etiquetas obligatorias. Para obtener más información, consulta Cómo exigir etiquetas de las solicitudes dehybridInspect
en esta página.Opcional: En Etiquetas opcionales, ingresa los pares clave-valor que desees vincular a los resultados de todas las solicitudes
hybridInspect
que se envíen a este trabajo o activador de trabajo. Puedes agregar hasta 10 etiquetas opcionales. Para obtener más información, consulta Etiquetas opcionales.Opcional: En Opciones de datos tabulares, ingresa el nombre del campo de la columna de clave primaria si planeas enviar datos tabulares en tus solicitudes de
hybridInspect
. Para obtener más información, consulta Opciones de datos tabulares.Haga clic en Continuar.
Configura la detección
En esta sección, especificas los tipos de datos sensibles que Sensitive Data Protection inspeccionará en los datos de entrada. Tus opciones son las siguientes:
- Plantilla: Si ya creaste una plantilla en el proyecto actual que deseas usar para definir los parámetros de detección de Sensitive Data Protection, haz clic en el campo Nombre de la plantilla y, luego, elige la plantilla en la lista que aparece.
- InfoTypes: La Protección de datos sensibles selecciona los infotipos integrados más comunes para detectar. Para cambiar los infotipos o elegir uno personalizado, haz clic en Administrar infotipos. También puedes ajustar los criterios de detección en las secciones Conjuntos de reglas de inspección y Umbral de confianza. Para obtener más detalles, consulta Configura la detección.
Después de configurar los parámetros de detección, haz clic en Continuar.
Agrega acciones
En esta sección, debes especificar dónde guardar los resultados de cada análisis de inspección y si deseas recibir notificaciones por correo electrónico o por mensaje de notificación de Pub/Sub cada vez que se complete un análisis. Si no guardas los resultados en BigQuery, los resultados del análisis solo contienen estadísticas sobre el número y los infotipos de los resultados.
- Guardar en BigQuery: Cada vez que se ejecuta un análisis, la protección de datos sensibles guarda los resultados del análisis en la tabla de BigQuery que especifiques aquí. Si no especificas un ID de tabla, BigQuery asignará un nombre predeterminado a una tabla nueva la primera vez que se ejecute el análisis. Si especificas una tabla existente, Sensitive Data Protection agrega los resultados del análisis a ella.
Publicar en Pub/Sub: Cuando se complete un trabajo, se emitirá un mensaje de Pub/Sub.
Notificar por correo electrónico: Cuando se termine un trabajo, se enviará un mensaje de correo electrónico.
Publicar en Cloud Monitoring: Cuando se completa un trabajo, sus resultados se publican en Monitoring
Después de elegir las acciones, haz clic en Continuar.
Programar
En esta sección, especificas si deseas crear un solo trabajo que se ejecute inmediatamente o un activador de trabajo que se ejecute cada vez que Sensitive Data Protection reciba datos con el formato y la ruta de acceso correctos.
Realiza una de las siguientes acciones:
Para ejecutar el trabajo híbrido de inmediato, elige Ninguna (ejecutar el trabajo de un solo uso inmediatamente después de su creación).
Para configurar el trabajo de modo que los datos recibidos de la fuente lo activen, elige Crear un activador para ejecutar el trabajo de forma periódica.
Los activadores de trabajos híbridos agregan llamadas a la API, lo que te permite ver los resultados de los hallazgos y las tendencias en el tiempo.
Para obtener más información, consulta Comparación de trabajos híbridos y activadores de trabajos híbridos.
Revisar
Puedes revisar un resumen JSON del análisis aquí. Asegúrate de anotar el nombre del objeto híbrido o el activador de trabajo híbrido. Necesitarás esta información cuando envíes datos a Protección de datos sensibles para su inspección.
Después de revisar el resumen de JSON, haz clic en Crear.
La Protección de datos sensibles inicia el trabajo híbrido o el activador de trabajo híbrido de inmediato.
Se inicia un análisis de inspección cuando envías una solicitud de hybridInspect
a este trabajo híbrido o activador de trabajo híbrido.
API
Un trabajo se representa en la API de DLP con el recurso DlpJobs
. Para crear un trabajo híbrido, llama al método projects.locations.dlpJobs.create
.
Un activador de trabajo se representa en la API de DLP con el recurso JobTrigger
. Para crear un activador de trabajo híbrido, llama al método projects.locations.jobTriggers.create
.
El objeto DlpJobs
o JobTrigger
que crees debe tener la siguiente configuración:
- En el campo
inspectJob
, establece un objetoInspectJobConfig
. - En el objeto
InspectJobConfig
, en el campostorageConfig
, establece un objetoStorageConfig
. - En el objeto
StorageConfig
, en el campohybridOptions
, establece un objetoHybridOptions
. Este objeto contiene metadatos sobre los datos que deseas inspeccionar. En el objeto
InspectJobConfig
, en el campoactions
, agrega las acciones (Action
) que deseas que la Protección de datos sensibles realice al final de cada trabajo.Las acciones
publishSummaryToCscc
ypublishFindingsToCloudDataCatalog
no son compatibles con esta operación. Para obtener más información sobre las acciones, consulta Acciones.Para especificar qué buscar y cómo hacerlo, realiza una de las siguientes acciones o ambas:
Si está disponible, establece el campo
inspectTemplateName
en el nombre completo del recurso de la plantilla de inspección que deseas usar.Configura el campo
inspectConfig
.
Si configuras los campos
inspectTemplateName
yinspectConfig
, se combinará su configuración.
Acerca de los ejemplos de JSON
Las siguientes pestañas contienen ejemplos de JSON que puedes enviar a Protección de datos sensibles para crear un trabajo híbrido o un activador de trabajo híbrido. Estos ejemplos de trabajos híbridos y activadores de trabajos híbridos están configurados para hacer lo siguiente:
- Procesa cualquier solicitud
hybridInspect
si tiene la etiquetaappointment-bookings-comments
. - Analiza el contenido de la solicitud
hybridInspect
en busca de direcciones de correo electrónico. - Adjunta la etiqueta
"env": "prod"
a los hallazgos. - Para los datos tabulares, obtén el valor de la celda en la columna
booking_id
(la clave primaria) que está en la misma fila que la celda en la que se encontraron los datos sensibles. Sensitive Data Protection adjunta este identificador al hallazgo para que puedas rastrearlo hasta la fila específica de la que proviene. - Enviar un correo electrónico cuando se detenga el trabajo El correo electrónico se envía a los propietarios del proyecto de IAM y a los Contactos esenciales técnicos.
- Enviar los resultados a Cloud Monitoring cuando se detenga el trabajo
Para ver los ejemplos de JSON, consulta las siguientes pestañas.
Trabajo híbrido
Esta pestaña contiene un ejemplo de JSON que puedes usar para crear un trabajo híbrido.
Para crear un trabajo híbrido, envía una solicitud POST
al siguiente extremo.
Método HTTP y URL
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/dlpJobs
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto en el que deseas almacenar la tarea híbrida.
- REGION: Es la región geográfica en la que deseas almacenar el trabajo híbrido.
Entrada de JSON
{
"jobId": "postgresql-table-comments",
"inspectJob": {
"actions": [
{
"jobNotificationEmails": {}
},
{
"publishToStackdriver": {}
}
],
"inspectConfig": {
"infoTypes": [
{
"name": "EMAIL_ADDRESS"
}
],
"minLikelihood": "POSSIBLE",
"includeQuote": true
},
"storageConfig": {
"hybridOptions": {
"description": "Hybrid job for data from the comments field of a table that contains customer appointment bookings",
"requiredFindingLabelKeys": [
"appointment-bookings-comments"
],
"labels": {
"env": "prod"
},
"tableOptions": {
"identifyingFields": [
{
"name": "booking_id"
}
]
}
}
}
}
}
Salida de JSON
{ "name": "projects/PROJECT_ID/locations/REGION/dlpJobs/i-postgresql-table-comments", "type": "INSPECT_JOB", "state": "ACTIVE", "inspectDetails": { "requestedOptions": { "snapshotInspectTemplate": {}, "jobConfig": { "storageConfig": { "hybridOptions": { "description": "Hybrid job for data from the comments field of a table that contains customer appointment bookings", "requiredFindingLabelKeys": [ "appointment-bookings-comments" ], "labels": { "env": "prod" }, "tableOptions": { "identifyingFields": [ { "name": "booking_id" } ] } } }, "inspectConfig": { "infoTypes": [ { "name": "EMAIL_ADDRESS" } ], "minLikelihood": "POSSIBLE", "limits": {}, "includeQuote": true }, "actions": [ { "jobNotificationEmails": {} }, { "publishToStackdriver": {} } ] } }, "result": { "hybridStats": {} } }, "createTime": "JOB_CREATION_DATETIME", "startTime": "JOB_START_DATETIME" }
Sensitive Data Protection crea el trabajo híbrido y genera un ID de trabajo. En este
ejemplo, el ID del trabajo es i-postgresql-table-comments
. Toma nota del ID del trabajo.
La necesitarás en tu solicitud de hybridInspect
.
Para detener un trabajo híbrido, debes llamar al método projects.locations.dlpJobs.finish
de forma explícita. La API de DLP no detiene automáticamente las tareas híbridas. Por el contrario, la API de DLP detiene automáticamente los trabajos dentro de los activadores de trabajos híbridos al final de cada día.
Activador de trabajo híbrido
Esta pestaña contiene un ejemplo de JSON que puedes usar para crear un activador de trabajos híbridos.
Para crear un activador de trabajo híbrido, envía una solicitud POST
al siguiente extremo.
Método HTTP y URL
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobTriggers
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto en el que deseas almacenar el activador de trabajos híbridos.
- REGION: Es la región geográfica en la que deseas almacenar el activador de trabajo híbrido.
Entrada de JSON
{
"triggerId": "postgresql-table-comments",
"jobTrigger": {
"triggers": [
{
"manual": {}
}
],
"inspectJob": {
"actions": [
{
"jobNotificationEmails": {}
},
{
"publishToStackdriver": {}
}
],
"inspectConfig": {
"infoTypes": [
{
"name": "EMAIL_ADDRESS"
}
],
"minLikelihood": "POSSIBLE",
"limits": {},
"includeQuote": true
},
"storageConfig": {
"hybridOptions": {
"description": "Hybrid job trigger for data from the comments field of a table that contains customer appointment bookings",
"requiredFindingLabelKeys": [
"appointment-bookings-comments"
],
"labels": {
"env": "prod"
},
"tableOptions": {
"identifyingFields": [
{
"name": "booking_id"
}
]
}
}
}
}
}
}
Salida de JSON
{ "name": "projects/PROJECT_ID/locations/REGION/jobTriggers/postgresql-table-comments", "inspectJob": { "storageConfig": { "hybridOptions": { "description": "Hybrid job trigger for data from the comments field of a table that contains customer appointment bookings", "requiredFindingLabelKeys": [ "appointment-bookings-comments" ], "labels": { "env": "prod" }, "tableOptions": { "identifyingFields": [ { "name": "booking_id" } ] } } }, "inspectConfig": { "infoTypes": [ { "name": "EMAIL_ADDRESS" } ], "minLikelihood": "POSSIBLE", "limits": {}, "includeQuote": true }, "actions": [ { "jobNotificationEmails": {} }, { "publishToStackdriver": {} } ] }, "triggers": [ { "manual": {} } ], "createTime": ""JOB_CREATION_DATETIME", "updateTime": "TRIGGER_UPDATE_DATETIME", "status": "HEALTHY" }
Sensitive Data Protection crea el activador de trabajo híbrido. El resultado contiene el nombre del activador de trabajos híbridos. En este ejemplo, es postgresql-table-comments
. Toma nota del nombre. La necesitarás en tu solicitud de hybridInspect
.
A diferencia de los trabajos híbridos, la API de DLP detiene automáticamente los trabajos dentro de los activadores de trabajos híbridos al final de cada día. Por lo tanto, no necesitas llamar de forma explícita al método projects.locations.dlpJobs.finish
.
Cuando crees un trabajo híbrido o un activador de trabajo híbrido, puedes usar el Explorador de APIs en las siguientes páginas de referencia de la API, respectivamente:
En el campo Parámetros de solicitud, ingresa projects/PROJECT_ID/locations/REGION
. Luego, en el campo Cuerpo de la solicitud, pega el JSON de muestra del objeto que intentas crear.
Una solicitud correcta, incluso una creada en el Explorador de APIs, crea un trabajo híbrido o un activador de trabajo híbrido.
Si quieres obtener información general sobre el uso de JSON para enviar solicitudes a la API de DLP, consulta la Guía de inicio rápido de JSON.
Envía datos al trabajo híbrido o al activador de trabajo híbrido
Para inspeccionar los datos, debes enviar una solicitud hybridInspect
, en el formato correcto,
a un trabajo híbrido o a un activador de trabajo híbrido.
Formato de los elementos de contenido híbrido
El siguiente es un ejemplo sencillo de una solicitud hybridInspect
que se envía a Sensitive Data Protection para que la procese un trabajo híbrido o un activador de trabajo híbrido.
Ten en cuenta la estructura del objeto JSON, incluido el campo hybridItem
, que contiene los siguientes campos:
item
: Contiene el contenido real que se inspeccionará.findingDetails
: Contiene metadatos para asociar con el contenido.
{
"hybridItem": {
"item": {
"value": "My email is test@example.org"
},
"findingDetails": {
"containerDetails": {
"fullPath": "10.0.0.2:logs1:app1",
"relativePath": "app1",
"rootPath": "10.0.0.2:logs1",
"type": "logging_sys",
"version": "1.2"
},
"labels": {
"env": "prod",
"appointment-bookings-comments": ""
}
}
}
}
Para obtener información completa sobre el contenido de los elementos de inspección híbrida, consulta el contenido de la referencia de la API para el objeto HybridContentItem
.
Extremos de inspección híbrida
Para que los datos se inspeccionen con un trabajo híbrido o un activador de trabajo híbrido, debes enviar una solicitud hybridInspect
al extremo correcto.
Método HTTP y URL para trabajos híbridos
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/dlpJobs/JOB_ID:hybridInspect
Para obtener más información sobre este extremo, consulta la página de referencia de la API del método projects.locations.dlpJobs.hybridInspect
.
Método HTTP y URL para activadores de trabajos híbridos
https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobTriggers/TRIGGER_NAME:hybridInspect
Para obtener más información sobre este extremo, consulta la página de referencia de la API del método projects.locations.jobTriggers.hybridInspect
.
Reemplaza lo siguiente:
- PROJECT_ID: Es el identificador de tu proyecto.
- REGION: Es la región geográfica en la que deseas almacenar la solicitud
hybridInspect
. Esta región debe ser la misma que la de la tarea híbrida. JOB_ID: Es el ID que le asignaste al trabajo híbrido, con el prefijo
i-
.Para buscar el ID de trabajo, en Protección de datos sensibles, haz clic en Inspección > Inspeccionar trabajos.
TRIGGER_NAME: Es el nombre que le asignaste al activador del trabajo híbrido.
Para buscar el nombre del activador de trabajo, en Protección de datos sensibles, haz clic en Inspección > Activadores de trabajo.
Se requieren etiquetas de las solicitudes de hybridInspect
Si deseas controlar qué solicitudes de hybridInspect
puede procesar un trabajo híbrido o un activador de trabajo híbrido, puedes establecer etiquetas obligatorias. Se rechazan todas las solicitudes de hybridInspect
para ese trabajo híbrido o activador de trabajo híbrido que no incluyan estas etiquetas obligatorias.
Para establecer una etiqueta obligatoria, haz lo siguiente:
Cuando crees el trabajo híbrido o el activador de trabajo híbrido, establece el campo
requiredFindingLabelKeys
en una lista de etiquetas obligatorias.En el siguiente ejemplo, se establece
appointment-bookings-comments
como una etiqueta obligatoria en un trabajo híbrido o un activador de trabajo híbrido."hybridOptions": { ... "requiredFindingLabelKeys": [ "appointment-bookings-comments" ], "labels": { "env": "prod" }, ... }
En la solicitud
hybridInspect
, en el campolabels
, agrega cada etiqueta obligatoria como una clave en un par clave-valor. El valor correspondiente puede ser una cadena vacía.En el siguiente ejemplo, se establece la etiqueta requerida,
appointment-bookings-comments
, en una solicitudhybridInspect
.{ "hybridItem": { "item": { "value": "My email is test@example.org" }, "findingDetails": { "containerDetails": {...}, "labels": { "appointment-bookings-comments": "" } } } }
Si no incluyes la etiqueta requerida en tu solicitud hybridInspect
, recibirás un error como el siguiente:
{ "error": { "code": 400, "message": "Trigger required labels that were not included: [appointment-bookings-comments]", "status": "INVALID_ARGUMENT" } }
Ejemplo de código: Crea un activador de trabajo híbrido y envíale datos
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Protección de datos sensibles, consulta las Bibliotecas cliente de Protección de datos sensibles.
Para autenticarte en la Protección de datos sensibles, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Protección de datos sensibles, consulta las Bibliotecas cliente de Protección de datos sensibles.
Para autenticarte en la Protección de datos sensibles, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Protección de datos sensibles, consulta las Bibliotecas cliente de Protección de datos sensibles.
Para autenticarte en la Protección de datos sensibles, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Protección de datos sensibles, consulta las Bibliotecas cliente de Protección de datos sensibles.
Para autenticarte en la Protección de datos sensibles, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Protección de datos sensibles, consulta las Bibliotecas cliente de Protección de datos sensibles.
Para autenticarte en la Protección de datos sensibles, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Protección de datos sensibles, consulta las Bibliotecas cliente de Protección de datos sensibles.
Para autenticarte en la Protección de datos sensibles, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Situaciones típicas de inspección híbrida
En las siguientes secciones, se describen los usos típicos de la inspección híbrida y sus flujos de trabajo correspondientes.
Cómo realizar un análisis único
Ejecutar un análisis único de una base de datos fuera de Google Cloud como parte de una verificación de datos trimestral
Crea un trabajo híbrido con la consola de Google Cloud o la API de DLP.
Llama a
projects.locations.dlpJobs.hybridInspect
para enviar datos al trabajo. Si deseas inspeccionar más datos, repite este paso tantas veces como sea necesario.Después de enviar los datos para su inspección, llama al método
projects.locations.dlpJobs.finish
.Sensitive Data Protection realiza las acciones especificadas en tu solicitud
projects.locations.dlpJobs.create
.
Configura la supervisión continua
Supervisar todo el contenido nuevo que se agrega a diario a una base de datos que la Protección de datos sensibles no admite de forma nativa
Crea un activador de trabajo híbrido con la consola de Google Cloud o la API de DLP.
Para activar el activador de trabajo, llama al método
projects.locations.jobTriggers.activate
.Llama a
projects.locations.jobTriggers.hybridInspect
para enviar datos al activador del trabajo. Si deseas inspeccionar más datos, repite este paso tantas veces como sea necesario.
En este caso, no necesitas llamar al método projects.locations.dlpJobs.finish
. La Protección de datos sensibles particiona automáticamente los datos que envías. Mientras el activador de trabajo esté activo, al final de cada día, Sensitive Data Protection realizará las acciones que especificaste cuando creaste el activador de trabajo híbrido.
Analiza los datos que ingresan a una base de datos
Analiza los datos que ingresan a una base de datos y, al mismo tiempo, controla cómo se particionan los datos. Cada trabajo en un activador de trabajo es una sola partición.
Crea un activador de trabajo híbrido con la consola de Google Cloud o la API de DLP.
Para activar el activador de trabajo, llama al método
projects.locations.jobTriggers.activate
.El sistema muestra el ID de un solo trabajo. Necesitarás este ID de trabajo en el siguiente paso.
Llama a
projects.locations.dlpJobs.hybridInspect
para enviar datos al trabajo.En este caso, envías los datos a la tarea en lugar del activador de la tarea. Este enfoque te permite controlar cómo se particiona la información que envías para la inspección. Si deseas agregar más datos para la inspección en la partición actual, repite este paso.
Después de enviar datos a la tarea, llama al método
projects.locations.dlpJobs.finish
.Sensitive Data Protection realiza las acciones especificadas en tu solicitud
projects.locations.jobTriggers.create
.Si deseas crear otro trabajo para la siguiente partición, vuelve a activar el activador de trabajos y, luego, envía los datos al trabajo resultante.
Supervisa el tráfico desde un proxy
Supervisa el tráfico de un proxy instalado entre dos aplicaciones personalizadas.
Crea un activador de trabajo híbrido con la consola de Google Cloud o la API de DLP.
Para activar el activador de trabajo, llama al método
projects.locations.jobTriggers.activate
.Llama a
projects.locations.jobTriggers.hybridInspect
para enviar datos al activador del trabajo. Si deseas inspeccionar más datos, repite este paso tantas veces como sea necesario.Puedes llamar a esta solicitud de forma indefinida para todo el tráfico de red. Asegúrate de incluir metadatos en cada solicitud.
En este caso, no necesitas llamar al método projects.locations.dlpJobs.finish
. La Protección de datos sensibles particiona automáticamente los datos que envías. Mientras el activador de trabajo esté activo, al final de cada día, Sensitive Data Protection realizará las acciones que especificaste cuando creaste el activador de trabajo híbrido.
¿Qué sigue?
- Obtén más información sobre cómo funcionan los trabajos híbridos y los activadores de trabajos híbridos.