In diesem Dokument wird beschrieben, wie Sie Sensitive Data Protection so konfigurieren, dass bestimmte Metadatenlabels in Ihren Inhalten erkannt werden.
In diesem Dokument sind Metadatenlabels Dateilabels, die in unterstützte Dateien eingebettet sind, oder Metadaten, die von Ihrer Clientanwendung in der Prüfanfrage bereitgestellt werden. Wenn Sensitive Data Protection Inhalte findet, die Ihren Metadatenkriterien entsprechen, wird ein Ergebnis generiert.
Wenn Sie nach Metadatenlabels suchen möchten, erstellen Sie einen benutzerdefinierten infoType für Metadatenlabels. Konfigurieren Sie dann Ihren Prüf- oder Erkennungsscan so, dass nach diesem infoType gesucht wird.
Vorteile und Anwendungsfälle
Mit dieser Funktion können Sie Ihre vorhandenen Klassifizierungstaxonomien für die Inhaltsprüfung und Richtlinienerzwingung verwenden. Wenn Sie ein benutzerdefiniertes oder Drittanbieter-Klassifizierungssystem verwenden, das Metadatenlabels auf Ihre Dokumente anwendet, können Sie Sensitive Data Protection so konfigurieren, dass diese Metadatenlabels während der Prüfung oder Erkennung erkannt werden.
Beispiel-Anwendungsfälle umfassen Folgendes:
- Dateien auf das Vorhandensein von Google Drive-Labels oder Microsoft-Vertraulichkeitslabels mit bestimmten Metadaten prüfen.
- Kombinieren Sie die Metadaten-Labelerkennung mit der Standard-infoType-Erkennung für einen mehrschichtigen Ansatz.
- Metadaten scannen, die Ihre Clientanwendung zusammen mit dem Inhalt übergibt, auch wenn die Metadaten nicht in die Datei eingebettet sind. In diesem Dokument wird diese Art von Metadaten als vom Client bereitgestellte Metadaten bezeichnet.
- Dokumente mit Model Armor anhand bestimmter Metadatenlabels bereinigen. Wenn Sie diese Funktion mit Model Armor oder Diensten, die Model Armor verwenden, wie Gemini Enterprise, nutzen möchten, müssen Sie in Model Armor eine erweiterte Sensitive Data Protection-Konfiguration erstellen, die auf diesen benutzerdefinierten Metadatenlabel-Detektor verweist.
Unterstützte Metadatenformate
Diese Funktion kann die folgenden Arten von Metadaten erkennen:
- Google Drive-Labels
Microsoft-Vertraulichkeitslabels für die folgenden Dateitypen:
- DOCX
- PPTX
- XLSX
Vom Client bereitgestellte Metadaten
Nicht unterstützte Konfigurationen
Benutzerdefinierte Metadaten-Labelerkennung wird in den folgenden Fällen nicht unterstützt:
Metadaten-Labelerkennung erstellen
Wenn Sie einen Metadaten-Labelerkennung erstellen möchten, definieren Sie ein CustomInfoType in einem InspectConfig-Objekt. Je nach Art der Metadaten, die Sie scannen möchten, definieren Sie eine der folgenden Optionen:
- Wenn Sie nach Google Drive-Labels und Microsoft-Vertraulichkeitslabels suchen möchten, definieren Sie eine
FileLabelInfoType. Weitere Informationen finden Sie unter Metadaten-Labelerkennung zum Scannen nach Dateilabels erstellen in diesem Dokument. - Wenn Sie reguläre Ausdrücke verwenden möchten, um nach benutzerdefinierten Schlüssel/Wert-Paaren zu suchen, definieren Sie einen
MetadataKeyValueExpression. Dieser Typ eignet sich für vom Client bereitgestellte Metadaten. Weitere Informationen finden Sie in diesem Dokument unter Metadaten-Label-Detektor zum Scannen nach Schlüssel/Wert-Paaren erstellen.
Metadatenlabel-Detektor erstellen, um nach Dateilabels zu suchen
Wenn Sie nach Google Drive-Labels oder Microsoft-Vertraulichkeitslabels suchen möchten, definieren Sie eine CustomInfoType mit einem FileLabelInfoType. Geben Sie in fileLabelInfoType entweder googleDriveLabel oder sensitivityLabel an (diese Felder schließen sich gegenseitig aus).
So scannen Sie nach einem Google Drive-Label:
{
"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"
}
]
}
}
}
]
}
}
So suchen Sie nach einem Microsoft-Vertraulichkeitslabel:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
Ersetzen Sie Folgendes:
CUSTOM_METADATA_LABEL_NAME: Der Name, der dem benutzerdefinierten infoType-Detektor zugewiesen werden soll.LIKELIHOOD: Optional. DerLikelihood-Wert, der allen Ergebnissen zugewiesen werden soll, die mit diesem benutzerdefinierten infoType übereinstimmen. Wenn Sie dieses Feld weglassen, ist die StandardwahrscheinlichkeitVERY_LIKELY.SENSITIVITY_SCORE: Optional. DerSensitivityScore, der allen Ergebnissen zugewiesen werden soll, die mit diesem benutzerdefinierten infoType übereinstimmen. Wenn Sie dieses Feld weglassen, ist der Standard-VertraulichkeitswertHIGH.Vertraulichkeitswerte werden in Datenprofilen verwendet. Beim Profiling Ihrer Daten verwendet Sensitive Data Protection die Vertraulichkeitswerte der infoTypes, um die Vertraulichkeitsstufe zu berechnen.
LABEL_ID: Erforderlich, wenn SiegoogleDriveLabelangeben. Die ID eines Google Drive-Labels, das übereinstimmen soll. Wenn Sie nur einLABEL_IDangeben, gleicht der Detektor alle Dateien ab, auf die dieses Google Drive-Label angewendet wurde, unabhängig von den Feldwerten. Wenn Sie bestimmte Feldwerte innerhalb eines Labels abgleichen möchten, fügen Sie einlabelFieldsToMatch-Objekt hinzu.FIELD_ID: Erforderlich, wenn Sie einlabelFieldsToMatch-Objekt angeben. Die ID eines Google Drive-Labelfelds, das übereinstimmen soll.FIELD_VALUE: Erforderlich, wenn Sie einlabelFieldsToMatch-Objekt angeben. Der Wert eines Google Drive-Labelfelds, der übereinstimmen soll.GUID: Erforderlich, wenn SiesensitivityLabelangeben. Die GUID eines Microsoft-Vertraulichkeitslabels, das übereinstimmen soll.
Beispieldetektor für ein Google Drive-Label
In diesem inspectConfig-Beispiel wird ein benutzerdefinierter infoType mit dem Namen CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL definiert. Dieser benutzerdefinierte infoType erkennt ein Google Drive-Label mit folgenden Eigenschaften:
- Die Label-ID
mydrive-label-id - In diesem Label ein Feld mit der ID
sensitivity-field-idund dem Wertconfidential.
Wenn Sie in labelFieldsToMatch keine Feld-ID und keinen Wert angeben, erkennt dieser benutzerdefinierte infoType die Dateien mit dem Label mydrive-label-id, unabhängig davon, ob Labelfelder vorhanden sind.
{
"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"
}
}
Wenn Sie diese Konfiguration in einem Inspektionsjob verwenden, generiert Sensitive Data Protection ein CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL-Ergebnis, wenn eine Übereinstimmung gefunden wird.
Beispieldetektor für ein Microsoft-Vertraulichkeitslabel
In diesem inspectConfig-Beispiel wird ein benutzerdefinierter infoType mit dem Namen CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL definiert. Dieser benutzerdefinierte infoType erkennt ein Microsoft-Vertraulichkeitslabel, das die GUID 12345678-9012-3456-7890-123456789012 enthält:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL"
},
"likelihood": "VERY_LIKELY",
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "12345678-9012-3456-7890-123456789012"
}
}
}
],
"minLikelihood": "POSSIBLE"
}
}
Wenn Sie diese Konfiguration in einem Inspektionsjob verwenden, generiert Sensitive Data Protection ein CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL-Ergebnis, wenn eine Übereinstimmung gefunden wird.
Metadatenlabel-Detektor erstellen, um nach benutzerdefinierten Schlüssel/Wert-Paaren zu suchen
So verwenden Sie reguläre Ausdrücke, um nach benutzerdefinierten Schlüssel/Wert-Paaren in vom Client bereitgestellten Metadaten zu suchen:
Definieren Sie einen
CustomInfoTypemit einemMetadataKeyValueExpression:{ "inspectConfig": { "customInfoTypes": [ { "infoType": { "name": "CUSTOM_METADATA_LABEL_NAME" }, "likelihood": "LIKELIHOOD", "sensitivityScore": { "score": "SENSITIVITY_SCORE" }, "metadataKeyValueExpression": { "keyRegex": "KEY_REGULAR_EXPRESSION", "valueRegex": "VALUE_REGULAR_EXPRESSION" } } ] } }Ersetzen Sie Folgendes:
CUSTOM_METADATA_LABEL_NAME: Der Name, der dem benutzerdefinierten infoType-Detektor zugewiesen werden soll.LIKELIHOOD: Optional. DerLikelihood-Wert, der allen Ergebnissen zugewiesen werden soll, die mit diesem benutzerdefinierten infoType übereinstimmen. Wenn Sie dieses Feld weglassen, ist die StandardwahrscheinlichkeitVERY_LIKELY.SENSITIVITY_SCORE: Optional. DerSensitivityScore, der allen Ergebnissen zugewiesen werden soll, die mit diesem benutzerdefinierten infoType übereinstimmen. Wenn Sie dieses Feld weglassen, ist der Standardwert für die SensitivitätHIGH.Vertraulichkeitswerte werden in Datenprofilen verwendet. Beim Profiling Ihrer Daten verwendet Sensitive Data Protection die Vertraulichkeitswerte der infoTypes, um die Vertraulichkeitsstufe zu berechnen.
KEY_REGULAR_EXPRESSION: Ein regulärer Ausdruck, nach dem in den Schlüsseln von Metadatenlabels gesucht werden soll.VALUE_REGULAR_EXPRESSION: Ein regulärer Ausdruck, nach dem in den Werten von Metadatenlabels gesucht werden soll.
Geben Sie in Ihrer
content.inspect-Anfrage die vom Client bereitgestellten Metadaten im FeldContentMetadataderContentIteman.
Beispielanfrage zum Scannen von vom Client bereitgestellten Metadaten
Das folgende Beispiel zeigt eine content.inspect-Anfrage, die sowohl eine PDF-Datei als auch vom Client bereitgestellte Metadaten enthält. In der Anfrage wird ein benutzerdefinierter infoType namens CUSTOM_METADATA_CLASSIFICATION verwendet, um nach Dateien zu suchen, die als „Vertraulich“ oder „Interne Verwendung“ gekennzeichnet sind.
{
"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"
}
]
}
}
}
Ersetzen Sie BASE64_ENCODED_PDF durch eine base64-codierte Datei, die gescannt werden soll.
Sensitive Data Protection generiert ein Ergebnis, wenn eine Übereinstimmung im Inhalt gefunden wird. Der MetadataType des Ergebnisses für MetadataLocation wird danach ausgefüllt, ob die Übereinstimmung in die Datei eingebettet ist (CONTENT_METADATA) oder vom Client bereitgestellt wird (CLIENT_PROVIDED_METADATA).
Nächste Schritte
- Erstellen Sie eine erweiterte Sensitive Data Protection-Konfiguration in Model Armor.