自訂 infoType 偵測工具

Sensitive Data Protection 內建許多 infoType 偵測工具，但您也可以自行建立。您可以定義自己的自訂 infoType 偵測工具，自訂偵測行為，讓 Sensitive Data Protection 檢查或去識別化符合指定模式的機密資料。自訂 infoType 偵測工具的類型如下：

• 一般自訂字典偵測工具是簡單的字詞和詞組清單，Sensitive Data Protection 會比對這些清單。如果字詞數量不超過數十萬個，請使用一般自訂字典偵測工具。
• 大型自訂字典偵測工具是由 Sensitive Data Protection 產生，使用儲存在 Cloud Storage 或 BigQuery 中的大量字詞或詞組清單。如果您有大量字詞或詞組 (最多數千萬個)，請使用大型自訂字典偵測工具。
• 規則運算式 (regex) 偵測工具可讓 Sensitive Data Protection 根據規則運算式模式偵測相符項目。
• 中繼資料標籤偵測工具可讓 Sensitive Data Protection 根據特定中繼資料的存在偵測相符項目。中繼資料標籤偵測工具分為兩種類型：
  • 中繼資料鍵/值運算式偵測工具會比對內容中繼資料中的特定鍵/值組合。
  • 檔案標籤偵測工具會比對特定檔案標籤，這些標籤可能代表 Google 雲端硬碟標籤或 Microsoft 敏感度標籤。
• 代理 infoType 偵測工具會偵測 Sensitive Data Protection 去識別化轉換 CryptoReplaceFfxFpeConfig 的輸出內容。這個自訂 infoType 偵測工具只能與 content:reidentify 方法搭配使用，在 FFX 模式下使用格式保留加密 (FPE) 反向去識別化。因此，這些主題不會詳細說明代理。如要進一步瞭解使用代理值自訂 infoType 偵測工具的方式和時機，請參閱「假名化」。

如要修正掃描結果，可以建立檢查規則。

如需進一步瞭解自訂 infoType 偵測工具，請參閱 InfoType 及 infoType 偵測工具概念網頁。如需可視情況使用或修改的範例，請參閱「自訂 infoType 偵測工具範例」。本主題的其餘部分將說明如何使用 Sensitive Data Protection 建立自訂 infoType 偵測工具。

哪裡可使用自訂 infoType 偵測工具

自訂 infoType 偵測工具定義於 CustomInfoType 物件中。設定下列項目時，請在 InspectConfig 物件中指定 CustomInfoType：

• 使用 projects.content.inspect 進行檢查。
• InspectJobConfig 中的檢查工作。
• InspectTemplate 中的檢查範本。
• 使用 projects.content.deidentify 進行去識別化。
• DeidentifyTemplate 中的去識別化範本。
• 使用 projects.content.reidentify 重新識別在 FFX 模式下使用 FPE 去識別化的內容。這種情況僅適用於代理自訂 infoType 偵測工具。

API 總覽

CustomInfoType 物件可讓您為新內容建立自訂 infoType 偵測工具，或微調預先定義 infoType 偵測工具傳回的結果。

CustomInfoType 物件包含下列欄位，設定方式如下：

• "infotype"：自訂 infoType 偵測工具的名稱，包含在 InfoType 物件中。
• "likelihood"：這個自訂 infoType 偵測工具要傳回的預設 Likelihood 值。您可以在 "detectionRules" 中指定替代 Likelihood 值，如果發現項目符合規則指定的條件，就會取代這個基本 Likelihood。如未加入 "likelihood" 欄位，自訂 infoType 偵測工具會預設為 VERY_LIKELY。如要進一步瞭解可能性，請參閱可能性概念頁面。
• "detectionRules"：一組 DetectionRule 物件，可額外套用至這個自訂 infoType 偵測工具的所有發現項目。您可以在這裡指定啟動字詞規則，做為 HotwordRule 物件。規則會按照其指定的順序套用。這個欄位不適用於 SurrogateType 物件。

• "sensitivityScore"：這個自訂 infoType 偵測工具要傳回的 SensitivityScore 值。如未加入 "sensitivityScore" 欄位，自訂 infoType 偵測工具會預設為 VERY_LIKELY。

  資料剖析會使用敏感度分數。剖析資料時，Sensitive Data Protection 會使用 infoType 的機密程度分數計算機密程度。

• 下列欄位其中之一 (取決於您建立的自訂 infoType 偵測工具種類)：

  • "dictionary"：Dictionary 物件，其中包含要搜尋的字詞或詞組清單。
  • "regex"：Regex 物件，其中包含定義規則運算式的單一模式。
  • "surrogateType"：SurrogateType 物件 (如有) 表示自訂 infoType 偵測工具是代理。如要進一步瞭解如何使用代理值自訂 infoType 偵測工具，請參閱「假名化」。
  • "storedType"：現有 StoredInfoType 物件的參照。建立大型自訂字典偵測工具時，必須填寫這個欄位。雖然您可以透過定義這個欄位來建立一般字典偵測工具或規則運算式偵測工具，但分別定義 dictionary 欄位或 regex 欄位會更簡單。
  • "metadataKeyValueExpression"：MetadataKeyValueExpression 物件，定義要在內容中繼資料中搜尋的鍵和值規則運算式。
  • "fileLabelInfoType"：FileLabelInfoType 物件，定義要搜尋的 Google 雲端硬碟檔案標籤或 Microsoft 敏感度標籤。

後續步驟

請閱讀以下主題，進一步瞭解如何建立自訂 infoType：

• 建立一般自訂字典偵測工具：瞭解如何建立自訂 infoType 偵測工具，比對字詞和詞組清單中的發現項目。
• 建立大型自訂字典偵測工具：瞭解如何比對大量字詞和詞組清單中的發現項目。儲存的自訂 infoType 偵測工具最多可比對數千萬個字詞。
• 建立自訂規則運算式偵測工具：瞭解如何建立自訂 infoType 偵測工具，比對規則運算式的發現項目。
• 建立自訂中繼資料標籤偵測工具：瞭解如何建立自訂 infoType 偵測工具，比對內容中繼資料中的發現項目。
• 修改 infoType 偵測工具，精細調整掃描結果：瞭解如何為內建和自訂 infoType 偵測工具建立修飾符，微調掃描結果。
• 自訂相符可能性：瞭解如何使用偵測規則和啟動字詞，來自訂指派給自訂偵測工具相符項目的可能性值。
• 自訂 infoType 偵測工具範例：多個 JSON 自訂 infoType 偵測工具定義範例，您可以視需要使用或修改。