Cloud Data Loss Prevention (Cloud DLP) ora fa parte di Sensitive Data Protection. Il nome dell'API rimane invariato: API Cloud Data Loss Prevention (API DLP). Per informazioni sui servizi che compongono Sensitive Data Protection, consulta la panoramica di Sensitive Data Protection.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Crea un rilevatore di etichette di metadati personalizzato

Questo documento descrive come configurare Sensitive Data Protection per rilevare etichette di metadati specifiche nei contenuti.

In questo documento, le etichette di metadati sono etichette di file incorporate nei file supportati o 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 di metadati, crea un infoType di etichetta di metadati personalizzato. Poi, configura la scansione di ispezione o 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 norme. Se utilizzi un sistema di classificazione personalizzato o di terze parti che applica etichette di metadati ai documenti, puoi configurare Sensitive Data Protection per rilevare queste etichette di metadati durante le operazioni di ispezione o rilevamento.

Alcuni esempi di casi d'uso sono:

Eseguire la scansione dei file per verificare la presenza di etichette di Google Drive o etichette di sensibilità Microsoft che contengono metadati specifici.
Combinare il rilevamento delle etichette di metadati con il rilevamento degli infoType standard per un approccio a più livelli.
Eseguire la scansione dei metadati che l'applicazione client passa insieme ai contenuti, anche se i metadati non sono incorporati nel file. In questo documento, questo tipo di metadati è chiamato metadati forniti dal client.
Sanificare 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 personalizzato.

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
- PDF
- PPTX
- XLSX
Metadati forniti dal client

Configurazioni non supportate

I rilevatori di etichette di metadati personalizzati non sono supportati in:

Creare un rilevatore di etichette di metadati

Per creare un rilevatore di etichette di metadati, definisci un CustomInfoType all'interno di un InspectConfig oggetto. A seconda del tipo di metadati di cui vuoi eseguire la scansione, definisci uno dei seguenti:

Per eseguire la scansione delle etichette di Google Drive e delle etichette di sensibilità Microsoft, definisci un FileLabelInfoType. Per saperne di più, consulta Creare un rilevatore di etichette di metadati per eseguire la scansione delle etichette dei file in questo documento.
Per utilizzare le espressioni regolari per eseguire la scansione delle coppie chiave-valore personalizzate, definisci un MetadataKeyValueExpression. Questo tipo è appropriato per i metadati forniti dal client. Per saperne di più, consulta Creare un rilevatore di etichette di metadati per eseguire la scansione delle coppie chiave-valore in questo documento.

Creare un rilevatore di etichette di metadati per eseguire la scansione delle etichette dei file

Per eseguire la scansione delle etichette di Google Drive o delle etichette di sensibilità Microsoft, definisci un CustomInfoType con un FileLabelInfoType:

{
  "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"
              }
            ]
          },
          "sensitivityLabel": {
            "guid": "GUID"
          }
        }
      }
    ]
  }
}

Sostituisci quanto segue:

CUSTOM_METADATA_LABEL_NAME: il nome da assegnare al rilevatore di infoType personalizzato.
LIKELIHOOD: (facoltativo) Il Likelihood valore da 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) Il SensitivityScore da 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 profila i dati, Sensitive Data Protection utilizza i punteggi di sensibilità degli infoType per calcolare il livello di sensibilità.
LABEL_ID: (facoltativo) L'ID di un'etichetta di Google Drive da trovare. Se specifichi solo un LABEL_ID, il rilevatore trova qualsiasi file a cui è applicata l'etichetta di Google Drive, indipendentemente dai valori dei campi. Per trovare valori di campo specifici all'interno di un'etichetta, includi un oggetto labelFieldsToMatch.
FIELD_ID: obbligatorio se specifichi un oggetto labelFieldsToMatch. L'ID di un campo di etichetta di Google Drive da trovare.
FIELD_VALUE: obbligatorio se specifichi un oggetto labelFieldsToMatch. Il valore di un campo di etichetta di Google Drive da trovare.
GUID: (facoltativo) Il GUID di un'etichetta di sensibilità Microsoft da trovare.

Esempio di rilevatore per un'etichetta di Google Drive

Questo esempio di inspectConfig definisce un infoType personalizzato denominato CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL. Questo infoType personalizzato rileva un'etichetta di Google Drive con le seguenti caratteristiche:

L'ID etichetta mydrive-label-id
All'interno dell'etichetta, un campo con l'ID sensitivity-field-id e il valore confidential.

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 campi di 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.

Esempio di rilevatore per un'etichetta di sensibilità Microsoft

Questo esempio di inspectConfig definisce un infoType personalizzato denominato CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL. Questo 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.

Creare un rilevatore di etichette di metadati per eseguire la scansione delle coppie chiave-valore personalizzate

Per utilizzare le espressioni regolari per eseguire la scansione delle coppie chiave-valore personalizzate nei metadati forniti dal client:

Definisci un CustomInfoType che ha un MetadataKeyValueExpression:
```
{
  "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 di infoType personalizzato.
- LIKELIHOOD: (facoltativo) Il Likelihood valore da 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) Il SensitivityScore da 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 profila i 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 di metadati.
- VALUE_REGULAR_EXPRESSION: un'espressione regolare da cercare nei valori delle etichette di metadati.
Nella tua content.inspect richiesta, specifica i metadati forniti dal client nel ContentMetadata campo del ContentItem.

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 eseguire la scansione dei file contrassegnati come "Confidential" o "Internal Use".

{
  "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 analizzare.

Sensitive Data Protection genera un risultato se trova una corrispondenza nei contenuti. Il 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).

Passaggi successivi

Crea una configurazione avanzata di Sensitive Data Protection in Model Armor.

Crea un rilevatore di etichette di metadati personalizzato Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.