Crea un rilevatore di etichette di metadati personalizzato

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
    • PDF
    • 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:

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 valore Likelihood 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) La 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 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 specifichi googleDriveLabel. L'ID di un'etichetta di Google Drive da abbinare. Se specifichi solo un LABEL_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 oggetto labelFieldsToMatch.

  • FIELD_ID: obbligatorio se specifichi un oggetto labelFieldsToMatch. L'ID di un campo dell'etichetta di Google Drive da abbinare.

  • FIELD_VALUE: obbligatorio se specifichi un oggetto labelFieldsToMatch. Il valore di un campo dell'etichetta di Google Drive da abbinare.

  • GUID: obbligatorio quando specifichi sensitivityLabel. 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-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 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:

  1. Definisci un CustomInfoType che abbia 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 infoType personalizzato.
    • LIKELIHOOD: (Facoltativo) Il valore Likelihood 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) La 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 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.

  2. Nella richiesta content.inspect, specifica i metadati forniti dal client nel campo ContentMetadata di 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 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).

Passaggi successivi