Questo documento descrive come configurare Sensitive Data Protection per rilevare etichette di metadati specifiche nei tuoi contenuti.
In questo documento, le etichette dei metadati sono etichette dei file incorporate nei file supportati o nei metadati forniti dall'applicazione client nella richiesta di ispezione. Se Sensitive Data Protection trova contenuti che corrispondono ai criteri dei metadati, genera un risultato.
Per eseguire la scansione delle etichette dei metadati, crea un infoType di etichetta dei metadati personalizzato. Poi, configura l'ispezione o la scansione di rilevamento per cercare questo infoType.
Vantaggi e casi d'uso
Questa funzionalità ti consente di utilizzare le tassonomie di classificazione esistenti per l'ispezione dei contenuti e l'applicazione delle policy. Se utilizzi un sistema di classificazione personalizzato o di terze parti che applica etichette di metadati ai tuoi documenti, puoi configurare Sensitive Data Protection in modo che rilevi queste etichette di metadati durante le operazioni di ispezione o rilevamento.
Esempi di casi d'uso:
- Scansiona i file per verificare la presenza di etichette di Google Drive o etichette di sensibilità Microsoft che contengono metadati specifici.
- Combina il rilevamento delle etichette dei metadati con il rilevamento degli infoType standard per un approccio multilivello.
- Analizza i metadati che l'applicazione client trasmette insieme ai contenuti, anche se non sono incorporati nel file. In questo documento, questo tipo di metadati è chiamato metadati forniti dal client.
- Sanitizza i documenti utilizzando Model Armor in base a etichette di metadati specifiche. Per utilizzare questa funzionalità con Model Armor o con servizi che utilizzano Model Armor come Gemini Enterprise, devi creare una configurazione avanzata di Sensitive Data Protection in Model Armor che faccia riferimento a questo rilevatore di etichette di metadati personalizzati.
Formati di metadati supportati
Questa funzionalità può rilevare i seguenti tipi di metadati:
- Etichette di Google Drive
Etichette di sensibilità Microsoft sui seguenti tipi di file:
- DOCX
- PPTX
- XLSX
Metadati forniti dal client
Configurazioni non supportate
I rilevatori di etichette dei metadati personalizzati non sono supportati nei seguenti casi:
Crea un rilevatore di rilevamento etichette dei metadati
Per creare un rilevatore di etichette dei metadati, definisci un
CustomInfoType all'interno di un
oggetto InspectConfig. A seconda del tipo di metadati che vuoi analizzare, definisci una delle seguenti opzioni:
- Per cercare le etichette di Google Drive e le etichette di sensibilità Microsoft, definisci una
FileLabelInfoType. Per saperne di più, consulta Crea un rilevatore di rilevamento etichette dei metadati per scansionare le etichette dei file in questo documento. - Per utilizzare le espressioni regolari per cercare coppie chiave-valore personalizzate, definisci un
MetadataKeyValueExpression. Questo tipo è appropriato per i metadati forniti dal client. Per ulteriori informazioni, consulta Crea un rilevatore di rilevamento etichette dei metadati per cercare coppie chiave-valore in questo documento.
Crea un rilevatore di etichette dei metadati per cercare le etichette dei file
Per eseguire la scansione delle etichette di Google Drive o delle etichette di sensibilità Microsoft, definisci un
CustomInfoType con un
FileLabelInfoType. All'interno di fileLabelInfoType, specifica googleDriveLabel o sensitivityLabel (questi campi si escludono a vicenda).
Per eseguire la scansione di un'etichetta di 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"
}
]
}
}
}
]
}
}
Per eseguire la scansione di un'etichetta di sensibilità Microsoft:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
Sostituisci quanto segue:
CUSTOM_METADATA_LABEL_NAME: il nome da assegnare al rilevatore infoType personalizzato.LIKELIHOOD: (Facoltativo) Il valoreLikelihoodda assegnare a tutti i risultati che corrispondono a questo infoType personalizzato. Se ometti questo campo, il livello di probabilità predefinito èVERY_LIKELY.SENSITIVITY_SCORE: (Facoltativo) LaSensitivityScoreda assegnare a tutti i risultati che corrispondono a questo infoType personalizzato. Se ometti questo campo, il punteggio di sensibilità predefinito èHIGH.I punteggi di sensibilità vengono utilizzati nei profili dati. Quando esegue la profilazione dei dati, Sensitive Data Protection utilizza i punteggi di sensibilità degli infoType per calcolare il livello di sensibilità.
LABEL_ID: obbligatorio quando specifichigoogleDriveLabel. L'ID di un'etichetta di Google Drive da abbinare. Se specifichi solo unLABEL_ID, il rilevatore trova tutti i file a cui è applicata l'etichetta di Google Drive, indipendentemente dai valori dei campi. Per trovare valori di campi specifici all'interno di un'etichetta, includi un oggettolabelFieldsToMatch.FIELD_ID: obbligatorio se specifichi un oggettolabelFieldsToMatch. L'ID di un campo dell'etichetta di Google Drive da abbinare.FIELD_VALUE: obbligatorio se specifichi un oggettolabelFieldsToMatch. Il valore di un campo dell'etichetta di Google Drive da abbinare.GUID: obbligatorio quando specifichisensitivityLabel. Il GUID di un'etichetta di sensibilità Microsoft da abbinare.
Rilevatore di esempio per un'etichetta di Google Drive
Questo esempio di inspectConfig definisce un infoType personalizzato denominato CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL. Questo rilevatore infoType personalizzato rileva un'etichetta di Google Drive con le seguenti caratteristiche:
- L'ID etichetta
mydrive-label-id - All'interno di questa etichetta, un campo con l'ID
sensitivity-field-ide il valoreconfidential.
Se non specifichi un ID e un valore del campo in labelFieldsToMatch, questo infoType personalizzato rileva i file con l'etichetta mydrive-label-id, indipendentemente dalla presenza di eventuali campi dell'etichetta.
{
"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 utilizzi questa configurazione in un job di ispezione, Sensitive Data Protection genera un risultato CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL se trova una corrispondenza.
Rilevatore di esempio per un'etichetta di sensibilità Microsoft
Questo esempio di inspectConfig definisce un infoType personalizzato denominato CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL. Questo rilevatore infoType personalizzato rileva un'etichetta di sensibilità Microsoft che contiene il 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 utilizzi questa configurazione in un job di ispezione, Sensitive Data Protection genera un risultato CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL se trova una corrispondenza.
Crea un rilevatore di etichette dei metadati per cercare coppie chiave-valore personalizzate
Per utilizzare le espressioni regolari per cercare coppie chiave-valore personalizzate nei metadati forniti dal client, segui questi passaggi:
Definisci un
CustomInfoTypeche abbia unMetadataKeyValueExpression:{ "inspectConfig": { "customInfoTypes": [ { "infoType": { "name": "CUSTOM_METADATA_LABEL_NAME" }, "likelihood": "LIKELIHOOD", "sensitivityScore": { "score": "SENSITIVITY_SCORE" }, "metadataKeyValueExpression": { "keyRegex": "KEY_REGULAR_EXPRESSION", "valueRegex": "VALUE_REGULAR_EXPRESSION" } } ] } }Sostituisci quanto segue:
CUSTOM_METADATA_LABEL_NAME: il nome da assegnare al rilevatore infoType personalizzato.LIKELIHOOD: (Facoltativo) Il valoreLikelihoodda assegnare a tutti i risultati che corrispondono a questo infoType personalizzato. Se ometti questo campo, il livello di probabilità predefinito èVERY_LIKELY.SENSITIVITY_SCORE: (Facoltativo) LaSensitivityScoreda assegnare a tutti i risultati che corrispondono a questo infoType personalizzato. Se ometti questo campo, il punteggio di sensibilità predefinito èHIGH.I punteggi di sensibilità vengono utilizzati nei profili dati. Quando esegue la profilazione dei dati, Sensitive Data Protection utilizza i punteggi di sensibilità degli infoType per calcolare il livello di sensibilità.
KEY_REGULAR_EXPRESSION: un'espressione regolare da cercare nelle chiavi delle etichette dei metadati.VALUE_REGULAR_EXPRESSION: un'espressione regolare da cercare nei valori delle etichette dei metadati.
Nella richiesta
content.inspect, specifica i metadati forniti dal client nel campoContentMetadatadiContentItem.
Esempio di richiesta per la scansione dei metadati forniti dal client
L'esempio seguente mostra una richiesta content.inspect che include sia un file PDF sia i metadati forniti dal client. La richiesta utilizza un infoType personalizzato denominato CUSTOM_METADATA_CLASSIFICATION per cercare i file contrassegnati come "Riservato" 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"
}
]
}
}
}
Sostituisci BASE64_ENCODED_PDF con un file con codifica base64 da scansionare.
Sensitive Data Protection genera un risultato se trova una corrispondenza nei contenuti. Il campo MetadataType del risultato per MetadataLocation viene compilato in base al fatto che la corrispondenza sia incorporata nel file (CONTENT_METADATA) o fornita dal client (CLIENT_PROVIDED_METADATA).