Neste documento, descrevemos como configurar a Proteção de Dados Sensíveis para detectar rótulos de metadados específicos no seu conteúdo.
Neste documento, os rótulos de metadados são rótulos de arquivo incorporados em arquivos ou metadados compatíveis fornecidos pelo aplicativo cliente na solicitação de inspeção. Se a Proteção de Dados Sensíveis encontrar conteúdo que corresponda aos seus critérios de metadados, ela vai gerar uma descoberta.
Para verificar rótulos de metadados, crie um infoType de rótulo de metadados personalizado. Em seguida, configure a verificação de inspeção ou descoberta para pesquisar esse infoType.
Benefícios e casos de uso
Esse recurso permite usar as taxonomias de classificação atuais para inspeção de conteúdo e aplicação de políticas. Se você usa um sistema de classificação personalizado ou de terceiros que aplica rótulos de metadados aos seus documentos, é possível configurar a Proteção de Dados Sensíveis para detectar esses rótulos durante as operações de inspeção ou descoberta.
Exemplos de casos de uso:
- Verifique se os arquivos têm marcadores do Google Drive ou marcadores de confidencialidade da Microsoft que contêm metadados específicos.
- Combine a detecção de rótulos de metadados com a detecção de infoType padrão para uma abordagem em várias camadas.
- Verificar os metadados que o aplicativo cliente transmite junto com o conteúdo, mesmo que eles não estejam incorporados ao arquivo. Neste documento, esse tipo de metadados é chamado de metadados fornecidos pelo cliente.
- Limpar documentos usando o Model Armor com base em rótulos de metadados específicos. Para usar esse recurso com o Model Armor ou serviços que usam o Model Armor, como o Gemini Enterprise, é necessário criar uma configuração avançada de Proteção de Dados Sensíveis no Model Armor que faça referência a esse detector de rótulos de metadados personalizados.
Formatos de metadados compatíveis
Esse recurso pode detectar os seguintes tipos de metadados:
- Marcadores do Google Drive
Rótulos de confidencialidade da Microsoft nos seguintes tipos de arquivo:
- DOCX
- PPTX
- XLSX
Metadados fornecidos pelo cliente
Configurações incompatíveis
Os detectores de rótulos de metadados personalizados não são compatíveis com:
Criar um detector de rótulos de metadados
Para criar um detector de rótulos de metadados, defina um
CustomInfoType em um objeto
InspectConfig. Dependendo do tipo de metadados que você quer verificar, defina uma das seguintes opções:
- Para verificar marcadores do Google Drive e rótulos de confidencialidade da Microsoft, defina um
FileLabelInfoType. Para mais informações, consulte Criar um detector de rótulos de metadados para verificar rótulos de arquivos neste documento. - Para usar expressões regulares para verificar pares de chave-valor personalizados, defina um
MetadataKeyValueExpression. Esse tipo é apropriado para metadados fornecidos pelo cliente. Para mais informações, consulte Criar um detector de rótulos de metadados para verificar pares de chave-valor neste documento.
Criar um detector de rótulos de metadados para verificar rótulos de arquivos
Para verificar rótulos do Google Drive ou de confidencialidade da Microsoft, defina um
CustomInfoType que tenha um
FileLabelInfoType. Em
fileLabelInfoType, especifique googleDriveLabel ou sensitivityLabel
(esses campos são mutuamente exclusivos).
Para verificar um marcador do Google Drive:
{
"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 verificar um rótulo de sensibilidade da Microsoft:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
Substitua:
CUSTOM_METADATA_LABEL_NAME: o nome a ser atribuído ao detector de infoType personalizado.LIKELIHOOD: opcional. O valorLikelihooda ser atribuído a todas as descobertas que correspondem a esse infoType personalizado. Se você omitir esse campo, o nível de probabilidade padrão seráVERY_LIKELY.SENSITIVITY_SCORE: opcional. OSensitivityScorea ser atribuído a todas as descobertas que correspondem a esse infoType personalizado. Se você omitir esse campo, a pontuação de sensibilidade padrão seráHIGH.As pontuações de sensibilidade são usadas em perfis de dados. Ao criar o perfil dos dados, a Proteção de Dados Sensíveis usa as pontuações de confidencialidade dos infoTypes para calcular o nível de confidencialidade.
LABEL_ID: obrigatório quando você especificagoogleDriveLabel. O ID de um marcador do Google Drive que deve corresponder. Se você especificar apenas umLABEL_ID, o detector vai corresponder a qualquer arquivo que tenha esse marcador do Google Drive aplicado, independentemente dos valores de campo. Para corresponder a valores de campo específicos em um marcador, inclua um objetolabelFieldsToMatch.FIELD_ID: obrigatório se você especificar um objetolabelFieldsToMatch. O ID de um campo de marcador do Google Drive que deve corresponder.FIELD_VALUE: obrigatório se você especificar um objetolabelFieldsToMatch. O valor de um campo de marcador do Google Drive que deve corresponder.GUID: obrigatório quando você especificasensitivityLabel. O GUID de um rótulo de sensibilidade da Microsoft para correspondência.
Exemplo de detector para um marcador do Google Drive
Este exemplo de inspectConfig define um infoType personalizado chamado
CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL. Este detector de infoType personalizado detecta um rótulo do Google Drive que tem o seguinte:
- O ID do marcador
mydrive-label-id - Nesse rótulo, um campo com o ID
sensitivity-field-ide o valorconfidential.
Se você não especificar um ID e um valor de campo em labelFieldsToMatch, esse infoType personalizado vai detectar os arquivos que têm o marcador mydrive-label-id, independentemente da presença de campos de marcador.
{
"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"
}
}
Quando você usa essa configuração em um job de inspeção,
a Proteção de Dados Sensíveis gera uma descoberta
CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL se encontrar uma correspondência.
Exemplo de detector para um rótulo de sensibilidade da Microsoft
Este exemplo de inspectConfig define um infoType personalizado chamado
CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL. Esse detector de infoType personalizado detecta um
rótulo de sensibilidade da Microsoft que contém o 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"
}
}
Quando você usa essa configuração em um job de inspeção,
a Proteção de Dados Sensíveis gera uma descoberta CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL
se encontrar uma correspondência.
Criar um detector de rótulos de metadados para verificar pares de chave-valor personalizados
Para usar expressões regulares para verificar pares de chave-valor personalizados em metadados fornecidos pelo cliente, siga estas etapas:
Defina um
CustomInfoTypeque tenha umMetadataKeyValueExpression:{ "inspectConfig": { "customInfoTypes": [ { "infoType": { "name": "CUSTOM_METADATA_LABEL_NAME" }, "likelihood": "LIKELIHOOD", "sensitivityScore": { "score": "SENSITIVITY_SCORE" }, "metadataKeyValueExpression": { "keyRegex": "KEY_REGULAR_EXPRESSION", "valueRegex": "VALUE_REGULAR_EXPRESSION" } } ] } }Substitua:
CUSTOM_METADATA_LABEL_NAME: o nome a ser atribuído ao detector de infoType personalizado.LIKELIHOOD: opcional. O valorLikelihooda ser atribuído a todas as descobertas que correspondem a esse infoType personalizado. Se você omitir esse campo, o nível de probabilidade padrão seráVERY_LIKELY.SENSITIVITY_SCORE: opcional. OSensitivityScorea ser atribuído a todas as descobertas que correspondem a esse infoType personalizado. Se você omitir esse campo, a pontuação de sensibilidade padrão seráHIGH.As pontuações de sensibilidade são usadas em perfis de dados. Ao criar o perfil dos dados, a Proteção de Dados Sensíveis usa as pontuações de confidencialidade dos infoTypes para calcular o nível de confidencialidade.
KEY_REGULAR_EXPRESSION: uma expressão regular para pesquisar nas chaves de rótulos de metadados.VALUE_REGULAR_EXPRESSION: uma expressão regular para pesquisar nos valores dos rótulos de metadados.
Na solicitação
content.inspect, especifique os metadados fornecidos pelo cliente no campoContentMetadatadoContentItem.
Exemplo de solicitação para verificar metadados fornecidos pelo cliente
O exemplo a seguir mostra uma solicitação content.inspect que inclui um arquivo PDF e metadados fornecidos pelo cliente. A solicitação usa um infoType personalizado chamado
CUSTOM_METADATA_CLASSIFICATION para verificar arquivos marcados como
"Confidencial" ou "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"
}
]
}
}
}
Substitua BASE64_ENCODED_PDF por um arquivo codificado em base64
para verificar.
A Proteção de Dados Sensíveis gera uma descoberta se encontrar uma correspondência no
conteúdo. O MetadataType da descoberta para MetadataLocation é preenchido com base na correspondência incorporada no arquivo (CONTENT_METADATA) ou fornecida pelo cliente (CLIENT_PROVIDED_METADATA).