En este documento, se describe cómo configurar Sensitive Data Protection para detectar etiquetas de metadatos específicas en tu contenido.
En este documento, las etiquetas de metadatos son etiquetas de archivo que se incorporan en los archivos o metadatos compatibles que proporciona tu aplicación cliente en la solicitud de inspección. Si Sensitive Data Protection encuentra contenido que coincide con tus criterios de metadatos, genera un hallazgo.
Para buscar etiquetas de metadatos, crea un Infotipo de etiqueta de metadatos personalizado. Luego, configura tu análisis de inspección o descubrimiento para buscar ese tipo de Infotipo.
Beneficios y casos de uso
Esta función te permite usar tus taxonomías de clasificación existentes para la inspección de contenido y la aplicación de políticas. Si usas un sistema de clasificación personalizado o de terceros que aplica etiquetas de metadatos a tus documentos, puedes configurar Sensitive Data Protection para que detecte estas etiquetas de metadatos durante tus operaciones de inspección o descubrimiento.
Como ejemplo, se incluyen los siguientes casos de uso:
- Analiza los archivos para detectar la presencia de etiquetas de Google Drive o etiquetas de sensibilidad de Microsoft que contengan metadatos específicos.
- Combina la detección de etiquetas de metadatos con la detección de Infotipo estándar para obtener un enfoque de varias capas.
- Analiza los metadatos que tu aplicación cliente pasa junto con el contenido, incluso si los metadatos no están incorporados en el archivo. En este documento, este tipo de metadatos se denomina metadatos proporcionados por el cliente.
- Limpia documentos con Model Armor según etiquetas de metadatos específicas. Para usar esta función con Model Armor o servicios que usan Model Armor, como Gemini Enterprise, debes crear una configuración avanzada de Sensitive Data Protection en Model Armor que haga referencia a este detector de etiquetas de metadatos personalizado.
Formatos de metadatos compatibles
Esta función puede detectar los siguientes tipos de metadatos:
- Etiquetas de Google Drive
Etiquetas de confidencialidad de Microsoft en los siguientes tipos de archivos:
- DOCX
- PPTX
- XLSX
Metadatos proporcionados por el cliente
Opciones de configuración no compatibles
Los detectores de etiquetas de metadatos personalizados no se admiten en los siguientes casos:
Crea un detector de detección de etiquetas de metadatos
Para crear un detector de etiquetas de metadatos, define un objeto CustomInfoType dentro de un objeto InspectConfig. Según el tipo de metadatos que quieras analizar, define una de las siguientes opciones:
- Para analizar las etiquetas de Google Drive y las etiquetas de sensibilidad de Microsoft, define un
FileLabelInfoType. Para obtener más información, consulta Crea un detector de detección de etiquetas de metadatos para buscar etiquetas de archivos en este documento. - Para usar expresiones regulares y analizar pares clave-valor personalizados, define un
MetadataKeyValueExpression. Este tipo es apropiado para los metadatos proporcionados por el cliente. Para obtener más información, consulta Crea un detector de etiquetas de metadatos para analizar pares clave-valor en este documento.
Crea un detector de detección de etiquetas de metadatos para analizar las etiquetas de los archivos
Para analizar las etiquetas de Google Drive o las etiquetas de sensibilidad de Microsoft, define un
CustomInfoType que tenga un
FileLabelInfoType. En
fileLabelInfoType, especifica googleDriveLabel o sensitivityLabel
(estos campos son mutuamente excluyentes).
Para buscar una etiqueta de Google Drive, sigue estos pasos:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"googleDriveLabel": {
"labelId": "LABEL_ID",
"labelFieldsToMatch": [
{
"id": "FIELD_ID",
"value": "FIELD_VALUE"
}
]
}
}
}
]
}
}
Para buscar una etiqueta de confidencialidad de Microsoft, haz lo siguiente:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
Reemplaza lo siguiente:
CUSTOM_METADATA_LABEL_NAME: Es el nombre que se asignará al detector de Infotipo personalizado.LIKELIHOOD: Opcional Es el valor deLikelihoodque se asignará a todos los hallazgos que coincidan con este tipo de Infotipo sensible personalizado. Si omites este campo, el nivel de probabilidad predeterminado esVERY_LIKELY.SENSITIVITY_SCORE: Opcional ElSensitivityScoreque se asignará a todos los hallazgos que coincidan con este tipo de Infotipo personalizado. Si omites este campo, la puntuación de sensibilidad predeterminada esHIGH.Las puntuaciones de sensibilidad se usan en los perfiles de datos. Cuando se genera un perfil de tus datos, Sensitive Data Protection usa las puntuaciones de sensibilidad de los infotipos para calcular el nivel de sensibilidad.
LABEL_ID: Es obligatorio cuando especificasgoogleDriveLabel. Es el ID de una etiqueta de Google Drive que se debe hacer coincidir. Si solo especificas unLABEL_ID, el detector coincide con cualquier archivo que tenga aplicada esa etiqueta de Google Drive, sin importar sus valores de campo. Para hacer coincidir valores de campo específicos dentro de una etiqueta, incluye un objetolabelFieldsToMatch.FIELD_ID: Es obligatorio si especificas un objetolabelFieldsToMatch. Es el ID de un campo de etiqueta de Google Drive que se debe hacer coincidir.FIELD_VALUE: Es obligatorio si especificas un objetolabelFieldsToMatch. Es el valor de un campo de etiqueta de Google Drive que se debe hacer coincidir.GUID: Es obligatorio cuando especificassensitivityLabel. El GUID de una etiqueta de sensibilidad de Microsoft que debe coincidir.
Detector de ejemplo para una etiqueta de Google Drive
En este ejemplo de inspectConfig, se define un infotipo personalizado llamado
CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL. Este detector de Infotipo personalizado detecta una etiqueta de Google Drive que tiene lo siguiente:
- El ID de etiqueta
mydrive-label-id - Dentro de esa etiqueta, un campo con el ID
sensitivity-field-idy el valorconfidential.
Si no especificas un ID de campo y un valor en labelFieldsToMatch, este tipo de Infotipo personalizado
detecta los archivos que tienen la etiqueta mydrive-label-id, sin importar
la presencia de campos de etiqueta.
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL"
},
"likelihood": "VERY_LIKELY",
"fileLabelInfoType": {
"googleDriveLabel": {
"labelId": "mydrive-label-id",
"labelFieldsToMatch": [
{
"id": "sensitivity-field-id",
"value": "confidential"
}
]
}
}
}
],
"minLikelihood": "POSSIBLE"
}
}
Cuando usas esta configuración en un trabajo de inspección,
Sensitive Data Protection genera un
hallazgo de CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL si encuentra una coincidencia.
Detector de ejemplo para una etiqueta de sensibilidad de Microsoft
En este ejemplo de inspectConfig, se define un infotipo personalizado llamado
CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL. Este detector de Infotipo personalizado detecta una
etiqueta de sensibilidad de Microsoft que contiene el GUID
12345678-9012-3456-7890-123456789012:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL"
},
"likelihood": "VERY_LIKELY",
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "12345678-9012-3456-7890-123456789012"
}
}
}
],
"minLikelihood": "POSSIBLE"
}
}
Cuando usas esta configuración en un trabajo de inspección,
Sensitive Data Protection genera un hallazgo de CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL
si encuentra una coincidencia.
Crea un detector de detección de etiquetas de metadatos para buscar pares clave-valor personalizados
Para usar expresiones regulares y analizar pares clave-valor personalizados en los metadatos proporcionados por el cliente, sigue estos pasos:
Define un objeto
CustomInfoTypeque tenga un objetoMetadataKeyValueExpression:{ "inspectConfig": { "customInfoTypes": [ { "infoType": { "name": "CUSTOM_METADATA_LABEL_NAME" }, "likelihood": "LIKELIHOOD", "sensitivityScore": { "score": "SENSITIVITY_SCORE" }, "metadataKeyValueExpression": { "keyRegex": "KEY_REGULAR_EXPRESSION", "valueRegex": "VALUE_REGULAR_EXPRESSION" } } ] } }Reemplaza lo siguiente:
CUSTOM_METADATA_LABEL_NAME: Es el nombre que se asignará al detector de Infotipo personalizado.LIKELIHOOD: Opcional Es el valor deLikelihoodque se asignará a todos los hallazgos que coincidan con este tipo de Infotipo sensible personalizado. Si omites este campo, el nivel de probabilidad predeterminado esVERY_LIKELY.SENSITIVITY_SCORE: Opcional ElSensitivityScoreque se asignará a todos los hallazgos que coincidan con este tipo de Infotipo personalizado. Si omites este campo, la puntuación de sensibilidad predeterminada esHIGH.Las puntuaciones de sensibilidad se usan en los perfiles de datos. Cuando se genera un perfil de tus datos, Sensitive Data Protection usa las puntuaciones de sensibilidad de los infotipos para calcular el nivel de sensibilidad.
KEY_REGULAR_EXPRESSION: Es una expresión regular para buscar en las claves de las etiquetas de metadatos.VALUE_REGULAR_EXPRESSION: Es una expresión regular para buscar en los valores de las etiquetas de metadatos.
En tu solicitud
content.inspect, especifica los metadatos proporcionados por el cliente en el campoContentMetadatadelContentItem.
Ejemplo de solicitud para analizar metadatos proporcionados por el cliente
En el siguiente ejemplo, se muestra una solicitud content.inspect que incluye un archivo PDF
y metadatos proporcionados por el cliente. La solicitud usa un Infotipo personalizado llamado
CUSTOM_METADATA_CLASSIFICATION para buscar archivos marcados como
"Confidencial" o "Uso interno".
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_CLASSIFICATION"
},
"likelihood": "VERY_LIKELY",
"metadataKeyValueExpression": {
"keyRegex": "classification",
"valueRegex": "Confidential|Internal Use"
}
}
]
},
"item": {
"byteItem": {
"type": "PDF",
"data": "BASE64_ENCODED_PDF"
},
"contentMetadata": {
"properties": [
{
"key": "classification",
"value": "Confidential"
}
]
}
}
}
Reemplaza BASE64_ENCODED_PDF por un archivo codificado en base64
para analizarlo.
Sensitive Data Protection genera un hallazgo si encuentra una coincidencia en el
contenido. El campo MetadataType del hallazgo para MetadataLocation se completa en función de si la coincidencia está incorporada en el archivo (CONTENT_METADATA) o si la proporciona el cliente (CLIENT_PROVIDED_METADATA).