カスタムの infoType 検出器

Sensitive Data Protection には多くの infoType 検出器がありますが、独自に作成することもできます。独自のカスタム infoType 検出機能を定義すると、検出の動作をカスタマイズできます。これにより、指定したパターンと一致するセンシティブ データが Sensitive Data Protection によって検査、匿名化されます。カスタム infoType 検出器の種類は次のとおりです。

  • 標準のカスタム辞書検出器は、Sensitive Data Protection が照合の対象とする単純な単語とフレーズのリストです。単語数が最大で数十万個ある場合、標準のカスタム辞書検出器を使用します。
  • 大規模なカスタム辞書検出機能は、Cloud Storage または BigQuery に保存されている単語やフレーズの大規模なリストを使用して、Sensitive Data Protection によって生成されます。含まれる単語やフレーズの数が数千万個までの大規模なリストでは、格納されるカスタム辞書検出器を使用します。
  • 正規表現（regex）検出機能により、Sensitive Data Protection を使用して正規表現パターンに基づいて一致を検出できます。
  • メタデータ ラベル検出機能を使用すると、Sensitive Data Protection は特定のメタデータの存在に基づいて一致を検出できます。メタデータ ラベル検出器には、次の 2 種類があります。
    • メタデータ Key-Value 式検出機能は、コンテンツ メタデータの特定の Key-Value ペアと一致します。
    • ファイルラベル検出器は、特定のファイルラベル（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 を指定します。

API の概要

CustomInfoType オブジェクトを使用すると、新しいコンテンツ用のカスタム infoType 検出機能を作成したり、事前定義された infoType 検出機能から返される結果を微調整したりできます。

CustomInfoType オブジェクトは次のフィールドで構成され、それぞれの記述内容に従って設定します。

  • "infotype": カスタム infoType 検出機能の名前。InfoType オブジェクトに含まれます。
  • "likelihood": このカスタム infoType 検出機能に対して返すデフォルトの Likelihood 値。検出結果がルールで指定された基準を満たしている場合、この基本の Likelihood に優先する代替 Likelihood 値を "detectionRules" に指定できます。"likelihood" フィールドを含めない場合、カスタム infoType 検出機能はデフォルトの VERY_LIKELY になります。可能性の詳細については、可能性のコンセプト ページをご覧ください。
  • "detectionRules": このカスタム infoType 検出器のすべての検出結果に追加で適用される一連の DetectionRule オブジェクト。ここに起動ワードルールを 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": 検索対象の Google ドライブのラベルまたは Microsoft 秘密度ラベルを定義する FileLabelInfoType オブジェクト。

次のステップ

カスタム infoType の作成方法については、次のトピックをご覧ください。