Puedes usar plantillas para crear y conservar información de configuración que se pueda usar con Protección de Datos Sensibles. Las plantillas son útiles para desacoplar la configuración (por ejemplo, qué inspeccionar y cómo desidentificarlo) de la implementación de tus solicitudes. Las plantillas ofrecen una forma eficaz de reutilizar la configuración y permiten mantener la coherencia entre usuarios y conjuntos de datos.
Protección de Datos Sensibles admite dos tipos de plantillas:
- Plantillas de desidentificación: plantillas para guardar información de configuración de trabajos de desidentificación, incluidas las transformaciones de infoType y de registro (conjunto de datos estructurado).
- Plantillas de inspección: plantillas para conservar la información de configuración de los trabajos de análisis de inspección, incluidos los detectores predefinidos o personalizados que se van a usar. Para obtener más información sobre las plantillas de inspección, consulta el artículo Crear plantillas de inspección de Protección de Datos Sensibles.
Para obtener información conceptual sobre las plantillas de Protección de Datos Sensibles, consulte Plantillas.
En el resto de este tema se explica cómo crear plantillas de desidentificación para usarlas con Protección de Datos Sensibles.
Crear una plantilla de desidentificación
Consola
En la Google Cloud consola, ve a la página Crear plantilla.
En las siguientes secciones se describe cómo rellenar la página Crear plantilla.
Definir la plantilla
En la sección Definir plantilla, rellena los campos de la siguiente manera:
- En Tipo de plantilla, selecciona Desidentificar (eliminar datos sensibles).
En Tipo de transformación de datos, seleccione el tipo de transformación que quiera aplicar:
InfoType. Protección de Datos Sensibles aplica cada transformación solo al valor que se ha identificado como el infoType específico. Este tipo de transformación es útil para el texto no estructurado.
Registro. Protección de Datos Sensibles tiene en cuenta el formato estructurado de los datos cuando aplica una transformación. Este tipo de transformación es útil para datos tabulares.
Imagen Protección de Datos Sensibles oculta todo el texto detectado en una imagen o solo el texto que coincide con un infoType específico.
En Template ID (ID de plantilla), introduce un identificador único para la plantilla.
En Nombre visible, escriba el nombre de la plantilla.
En Descripción, describe la plantilla.
En Ubicación del recurso, selecciona Global o la ubicación de los datos que quieras anonimizar.
Haz clic en Continuar.
Configurar la desidentificación
Los campos que aparecen en Configurar desidentificación se basan en el tipo de transformación de datos que elijas.
InfoType
Si has seleccionado InfoType como tipo de transformación de datos, haz lo siguiente:
En el campo Transformación, seleccione un método de transformación para aplicarlo a los resultados.
Aparecerán más campos en función de lo que selecciones. Rellena los campos según sea necesario. Para obtener más información, consulta la referencia de transformación.
En la sección InfoTypes que transformar, especifica si quieres aplicar la transformación a todos los infoTypes detectados que se definan en tu configuración de inspección.
Si seleccionas Especificar infoTypes, elige los infoTypes a los que quieras aplicar el método de transformación.
Si quiere añadir reglas de transformación para infoTypes que no estén cubiertos por su regla de transformación, haga clic en Añadir regla de transformación. A continuación, rellena los campos según sea necesario. Repite este paso hasta que hayas configurado una regla de transformación para todos los infoTypes que quieras transformar.
Haz clic en Crear.
Grabar
Si has seleccionado Registro como tipo de transformación de datos, haz lo siguiente:
- En Campos o columnas que transformar, escriba el nombre de la columna de la tabla que contiene los datos que quiere transformar. A continuación, pulsa
ENTER
. Repite este paso con cada columna que contenga datos que quieras transformar. Especifica el tipo de transformación:
Coincidencia en infoType. Protección de Datos Sensibles trata cada celda como texto no estructurado y aplica la transformación solo a los infoTypes que encuentra en la celda. Protección de Datos Sensibles no transforma ningún dato que rodee a un infoType.
Si selecciona esta opción, haga lo siguiente:
- Haz clic en Añadir transformación. En el campo Transformación, seleccione un método de transformación para aplicarlo a los resultados.
Especifique si quiere aplicar la transformación a todos los infoTypes detectados que estén definidos en su configuración de inspección.
Si seleccionas Especificar infoTypes, elige los infoTypes a los que quieras aplicar la regla de transformación.
Si quieres asignar determinadas reglas de transformación a determinados infoTypes, puedes añadir más transformaciones según sea necesario.
Transformación de campos primitivos. Protección de Datos Sensibles siempre transforma toda la celda según el método de transformación que elijas. Esta opción es útil si quiere transformar columnas enteras de datos, independientemente de si las celdas de esas columnas tienen infoTypes detectados.
Si selecciona esta opción, en el campo Transformación, elija un método de transformación para aplicarlo a las columnas que haya especificado.
En ambos casos, aparecerán más campos según el método de transformación que hayas seleccionado. Rellena los campos según sea necesario. Para obtener más información, consulta la referencia de transformación.
Haz clic en Crear.
Imagen
Si has seleccionado Imagen como tipo de transformación de datos, haz lo siguiente:
Opcional: Para cambiar el color del recuadro que cubre el texto censurado, haz clic en el recuadro negro del campo Color de la censura y elige otro color.
En la sección InfoTypes to transform (InfoTypes que se van a transformar), especifica qué quieres ocultar: todo el texto detectado, todos los infoTypes definidos en tu configuración de inspección o solo infoTypes específicos.
Si selecciona Especificar infoTypes, elija los infoTypes a los que quiera aplicar la regla de transformación.
Si quiere añadir reglas de transformación para infoTypes que no estén cubiertos por su regla de transformación, haga clic en Añadir regla de transformación. A continuación, rellena los campos según sea necesario. Repite este paso hasta que hayas configurado una regla de transformación para todos los infoTypes que quieras transformar.
Haz clic en Crear.
Protocolo
Es importante tener en cuenta que una plantilla de desidentificación es simplemente una configuración de desidentificación reutilizable más algunos metadatos. En términos de API, el objeto
DeidentifyTemplate
es, en realidad, un objeto
DeidentifyConfig
que incluye algunos campos de metadatos más, como un nombre visible y una descripción. Por lo tanto, para crear una plantilla de desidentificación, los pasos básicos son los siguientes:
- Empieza con un objeto
DeidentifyConfig
. - Llama o envía por POST al método
create
del recursoprojects.deidentifyTemplates
e incluye en tu solicitud un objetoDeidentifyTemplate
que contenga un nombre visible, una descripción y el objetoDeidentifyConfig
.
El DeidentifyTemplate
devuelto se podrá usar inmediatamente. Puedes hacer referencia a ella en otras llamadas o trabajos por su name
. Puedes enumerar las plantillas que ya tengas llamando al método *.deidentifyTemplates.list
. Para ver una plantilla específica, llama al método *.deidentifyTemplates.get
. Ten en cuenta que el límite de plantillas que puedes crear es de 1000.
Si ya tienes experiencia en anonimizar datos sensibles de texto, imágenes o contenido estructurado con Protección de Datos Sensibles, ya habrás creado un objeto DeidentifyConfig
. Con un paso más, se convierte en un objeto DeidentifyTemplate
.
Ejemplo de REST
El siguiente JSON es un ejemplo de lo que podrías enviar al método
projects.deidentifyTemplates.create
. Este JSON crea una plantilla con el nombre visible y la descripción proporcionados, y busca coincidencias en los infoTypes EMAIL_ADDRESS
y GENERIC_ID
. Cuando encuentre contenido que coincida con esos infoTypes, enmascarará los tres primeros caracteres con un asterisco (*
).
Método HTTP y URL
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/deidentifyTemplates
Sustituye PROJECT_ID
por el ID del proyecto.
Entrada JSON
{
"deidentifyTemplate":{
"displayName":"Email and id masker",
"description":"De-identifies emails and ids with a series of asterisks.",
"deidentifyConfig":{
"infoTypeTransformations":{
"transformations":[
{
"infoTypes":[
{
"name":"GENERIC_ID"
}
],
"primitiveTransformation":{
"replaceWithInfoTypeConfig":{
}
}
},
{
"infoTypes":[
{
"name":"EMAIL_ADDRESS"
}
],
"primitiveTransformation":{
"characterMaskConfig":{
"charactersToIgnore":[
{
"charactersToSkip":"@"
}
],
"maskingCharacter":"*"
}
}
}
]
}
}
}
}
Salida JSON
{ "name":"projects/PROJECT_ID/deidentifyTemplates/JOB-ID", "displayName":"Email and id masker", "description":"De-identifies emails and ids with a series of asterisks.", "createTime":"2018-11-30T07:17:59.536022Z", "updateTime":"2018-11-30T07:17:59.536022Z", "deidentifyConfig":{ "infoTypeTransformations":{ "transformations":[ { "infoTypes":[ { "name":"GENERIC_ID" } ], "primitiveTransformation":{ "replaceWithInfoTypeConfig":{ } } }, { "infoTypes":[ { "name":"EMAIL_ADDRESS" } ], "primitiveTransformation":{ "characterMaskConfig":{ "maskingCharacter":"*", "charactersToIgnore":[ { "charactersToSkip":"@" } ] } } } ] } } }
Para probarlo rápidamente, puedes usar el Explorador de APIs que se incluye más abajo. Para obtener información general sobre cómo usar JSON para enviar solicitudes a la API DLP, consulta la guía de inicio rápido de JSON.
Usar plantillas de desidentificación
Una vez que hayas creado una plantilla, podrás usar su identificador name
en cualquier lugar donde se acepte deidentifyTemplateName
, como:
projects.content.deidentify
: Desidentifica datos potencialmente sensibles en el contenido mediante la plantilla como configuración. Ten en cuenta que este método puede usar una plantilla de inspección o una plantilla de desidentificación.
Consultar una lista de plantillas de desidentificación
Para obtener una lista de todas las plantillas de desidentificación que se han creado, utilice uno de los siguientes métodos:*.*.list
En esta sección se muestra cómo usar Protección de Datos Sensibles para enumerar plantillas de inspección. El proceso es idéntico al de las plantillas de desidentificación de fichas.
C#
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Go
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
PHP
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Eliminar plantillas de desidentificación
Para eliminar una plantilla de desidentificación específica, utilice uno de los *.*.delete
métodos:
Con cada método *.*.delete
, se incluye el nombre del recurso de la plantilla que se va a eliminar.
C#
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Go
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
PHP
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Para saber cómo instalar y usar la biblioteca de cliente de Protección de Datos Sensibles, consulta el artículo sobre las bibliotecas de cliente de Protección de Datos Sensibles.
Para autenticarte en Protección de Datos Sensibles, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.