Benutzerdefinierte infoType-Detektoren

Sensitive Data Protection enthält viele integrierte infoType-Detektoren, Sie können aber auch eigene erstellen. Sie können das Erkennungsverhalten anpassen, indem Sie eigene benutzerdefinierte infoType-Detektoren definieren. Sensitive Data Protection prüft oder de-identifiziert dann sensible Daten, die den von Ihnen angegebenen Mustern entsprechen. Es gibt folgende Arten von benutzerdefinierten infoType-Detektoren:

• Reguläre benutzerdefinierte Wörterbuchdetektoren sind einfache Listen mit Wörtern und Wortgruppen, die von Sensitive Data Protection abgeglichen werden. Verwenden Sie normale benutzerdefinierte Wörterbuchdetektoren, wenn Ihre Wortzahl nicht mehr als mehrere hunderttausend Wörter beträgt.
• Detektoren für große benutzerdefinierte Wörterbücher werden von Sensitive Data Protection mithilfe großer Listen von Wörtern oder Wortgruppen generiert, die entweder in Cloud Storage oder BigQuery gespeichert sind. Verwenden Sie Detektoren für große benutzerdefinierte Wörterbücher, wenn Sie eine große Liste von Wörtern oder Wortgruppen haben – bis zu mehreren zehn Millionen.
• Mit Detektoren für reguläre Ausdrücke (Regex) kann Sensitive Data Protection Übereinstimmungen anhand eines regulären Ausdrucksmusters erkennen.
• Mit Metadatenlabel-Detektoren kann Sensitive Data Protection Übereinstimmungen anhand des Vorhandenseins bestimmter Metadaten erkennen. Es gibt zwei Arten von Metadaten-Label-Detektoren:
  • Detektoren für Metadaten-Schlüssel/Wert-Ausdrücke suchen nach bestimmten Schlüssel/Wert-Paaren in Content-Metadaten.
  • Dateilabel-Detektoren gleichen bestimmte Dateilabels ab, die Google Drive-Labels oder Microsoft-Vertraulichkeitslabels darstellen können.
• Surrogat-infoType-Detektoren erkennen die Ausgabe der De-Identifikationstransformation CryptoReplaceFfxFpeConfig von Sensitive Data Protection. Dieser benutzerdefinierte infoType-Detektor wird nur mit der Methode content:reidentify verwendet, um die De-Identifikation mithilfe der formaterhaltenden Verschlüsselung (Format-Preserving Encryption, FPE) im FFX-Modus rückgängig zu machen. Aus diesem Grund werden Surrogates in diesen Themen nicht ausführlich beschrieben. Weitere Informationen dazu, wie und wann Sie benutzerdefinierte infoType-Detektoren für Ersatzwerte verwenden, finden Sie unter Pseudonymisierung.

Wenn Sie die Scanergebnisse verfeinern möchten, können Sie Prüfregeln erstellen.

Weitere Informationen zu benutzerdefinierten infoType-Detektoren finden Sie auf der Seite, auf der das Konzept InfoTypes und infoType-Detektoren erläutert wird. Einige Beispiele, die Sie nach Belieben verwenden oder ändern können, finden Sie unter Beispiele für benutzerdefinierte infoType-Detektoren. Im weiteren Verlauf dieses Themas wird beschrieben, wie Sie mit Sensitive Data Protection eigene benutzerdefinierte infoType-Detektoren erstellen.

Einsatzmöglichkeiten für benutzerdefinierte infoType-Detektoren

Benutzerdefinierte infoType-Detektoren werden im Objekt CustomInfoType definiert. Sie geben im Objekt InspectConfig einen CustomInfoType an, wenn Sie Folgendes konfigurieren:

• Inspektion mit projects.content.inspect
• Inspektionsjobs in InspectJobConfig
• Inspektionsvorlagen in InspectTemplate
• De-Identifikation mit projects.content.deidentify
• De-Identifikationsvorlagen in DeidentifyTemplate
• Re-Identifikation von Inhalten, die im FX-Modus mit FPE de-identifiziert wurden, mithilfe von projects.content.reidentify Dieses Szenario gilt nur für benutzerdefinierte Ersatz-infoType-Detektoren.

API-Übersicht

Mit dem Objekt CustomInfoType können Sie einen benutzerdefinierten infoType-Detektor für neuen Inhalt erstellen oder die Ergebnisse vordefinierter infoType-Detektoren optimieren.

Das Objekt CustomInfoType besteht aus den folgenden Feldern, die wie beschrieben festgelegt werden:

• "infotype": Name des benutzerdefinierten infoType-Detektors in einem InfoType-Objekt
• "likelihood": Standardwert Likelihood, der für diesen benutzerdefinierten infoType-Detektor zurückgegeben werden soll. Sie können in "detectionRules" alternative Likelihood-Werte angeben, die diese Basis-Likelihood ersetzen, wenn das Ergebnis den Kriterien der Regel entspricht. Wenn Sie das Feld "likelihood" nicht einfügen, wird der benutzerdefinierte infoType-Detektor standardmäßig auf VERY_LIKELY gesetzt. Weitere Informationen zur Wahrscheinlichkeit finden Sie auf der Konzeptseite Wahrscheinlichkeit.
• "detectionRules": Eine Reihe von Objekten DetectionRule, die zusätzlich auf alle Ergebnisse dieses benutzerdefinierten infoType-Detektors angewendet werden sollen. Hier geben Sie Hotword-Regeln als Objekt HotwordRule an. Regeln werden in der Reihenfolge angewendet, in der sie angegeben sind. Dieses Feld gilt nicht für SurrogateType-Objekte

• "sensitivityScore": Der SensitivityScore-Wert, der für diesen benutzerdefinierten infoType-Detektor zurückgegeben werden soll. Wenn Sie das Feld "sensitivityScore" nicht angeben, wird der benutzerdefinierte infoType-Detektor standardmäßig auf VERY_LIKELY gesetzt.

  Vertraulichkeitswerte werden in Datenprofilen verwendet. Beim Profiling Ihrer Daten verwendet Sensitive Data Protection die Vertraulichkeitswerte der infoTypes, um die Vertraulichkeitsstufe zu berechnen.

• Eines der folgenden Felder, abhängig von der Art des benutzerdefinierten infoType-Detektors, den Sie erstellen:

  • "dictionary": Ein Objekt Dictionary, das eine Liste von Wörtern oder Wortgruppen enthält, nach denen gesucht werden soll
  • "regex": Ein Objekt Regex mit einem einzelnen Muster, das den regulären Ausdruck definiert
  • "surrogateType": Ein Objekt SurrogateType gibt, falls vorhanden, an, dass der benutzerdefinierte infoType-Detektor ein Ersatzwert ist. Weitere Informationen zur Verwendung von benutzerdefinierten infoType-Ersatzdetektoren finden Sie unter Pseudonymisierung.
  • "storedType": Ein Verweis auf ein vorhandenes StoredInfoType-Objekt. Dieses Feld ist beim Erstellen eines Detektors für große benutzerdefinierte Wörterbücher erforderlich. Sie können zwar reguläre Wörterbuchdetektoren oder Detektoren für reguläre Ausdrücke erstellen, indem Sie dieses Feld definieren, aber es ist einfacher, diese durch Definieren des Felds dictionary bzw. regex zu erstellen.
  • "metadataKeyValueExpression": Ein MetadataKeyValueExpression-Objekt, das reguläre Ausdrücke für den Schlüssel und den Wert definiert, nach denen in den Inhaltsmetadaten gesucht werden soll.
  • "fileLabelInfoType": Ein FileLabelInfoType-Objekt, das ein Google Drive-Dateilabel oder ein Microsoft-Vertraulichkeitslabel definiert, nach dem gesucht werden soll.

Nächste Schritte

Mehr zum Erstellen von benutzerdefinierten infoTypes finden Sie in den folgenden Themen:

• Benutzerdefinierten Wörterbuch-Detektor erstellen: Hier erfahren Sie, wie Sie einen benutzerdefinierten infoType-Detektor erstellen, um Ergebnisse mit einer Liste von Wörtern und Wortgruppen abzugleichen.
• Detektor für ein großes benutzerdefiniertes Wörterbuch erstellen: Hier erfahren Sie, wie Sie Ergebnisse mit einer sehr großen Liste von Wörtern und Wortgruppen abgleichen. Gespeicherte benutzerdefinierte infoType-Detektoren können bis zu mehrere Millionen Wörter abgleichen.
• Benutzerdefinierten Regex-Detektor erstellen: Hier erfahren Sie, wie Sie einen benutzerdefinierten infoType-Detektor erstellen, um Ergebnisse mit einem regulären Ausdruck abzugleichen.
• Benutzerdefinierten Metadatenlabel-Detektor erstellen: Hier erfahren Sie, wie Sie einen benutzerdefinierten infoType-Detektor erstellen, um Ergebnisse in Inhaltsmetadaten abzugleichen.
• infoType-Detektoren ändern, um Scanergebnisse zu verfeinern: Hier erfahren Sie, wie Sie Modifikatoren für integrierte und benutzerdefinierte infoType-Detektoren erstellen, um Scanergebnisse zu optimieren.
• Übereinstimmungswahrscheinlichkeit anpassen: Erfahren Sie, wie Sie Erkennungsregeln und Hotwords verwenden, um die Wahrscheinlichkeitswerte anzupassen, die Übereinstimmungen mit benutzerdefinierten Detektoren zugeordnet sind.
• Beispiele für benutzerdefinierte infoType-Detektoren: Mehrere Definitionen benutzerdefinierter JSON-infoType-Detektoren, die Sie nach Belieben verwenden oder ändern können.