カスタムの infoType 検出器

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

  • 標準のカスタム辞書検出機能は、Sensitive Data Protection が照合の対象とする単純な単語とフレーズのリストです。単語数が最大で数十万個ある場合、標準のカスタム辞書検出器を使用します。
  • 大規模なカスタム辞書検出器は、Cloud Storage または BigQuery に保存されている単語やフレーズの大規模なリストを使用して、Sensitive Data Protection によって生成されます。含まれる単語やフレーズの数が数千万個までの大規模なリストでは、格納されるカスタム辞書検出器を使用します。
  • 正規表現（regex）検出器を使用すると、機密データの保護は正規表現パターンに基づいて一致を検出できます。
  • メタデータ ラベル検出機能を使用すると、Sensitive Data Protection は特定のメタデータの存在に基づいて一致を検出できます。メタデータ ラベル検出器には次の 2 種類があります。
    • メタデータ Key-Value 式検出器は、コンテンツ メタデータ内の特定の Key-Value ペアと照合します。
    • ファイル ラベル検出器は、特定のファイル ラベルと照合します。これは、Google ドライブ ラベルまたは Microsoft の機密ラベルを表すことができます。
  • サロゲート infoType 検出器は、機密データの保護 の匿名化変換 CryptoReplaceFfxFpeConfigからの出力を検出します。 このカスタム infoType 検出器を使用するのは、content:reidentify メソッドで、FFX モードのフォーマット保持暗号化（FPE）を使用して匿名化を元に戻す場合のみです。そのため、これらのトピックではサロゲートについて詳しく説明していません。サロゲート カスタム infoType 検出器をいつどのように使用するかについては、仮名化をご覧ください。

スキャン結果を絞り込むには、検査ルール を作成します。

カスタム infoType 検出器の詳細については、infoType と infoType 検出器の概念のページをご覧ください。必要に応じて使用または変更できる例については、カスタム infoType 検出器の例をご覧ください。この後のトピックでは、Sensitive Data Protection を使用して独自のカスタム infoType 検出器を作成する方法について説明します。

カスタム infoType 検出器を使用する場所

カスタム infoType 検出器は CustomInfoType オブジェクトで定義します。以下を構成するときには、InspectConfig オブジェクトに CustomInfoType を指定します。

API の概要

The 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": コンテンツ メタデータで検索する Key と Value の正規表現を定義する MetadataKeyValueExpression オブジェクト。
    • "fileLabelInfoType"：検索する Google ドライブ ファイル ラベルまたは Microsoft の機密ラベルを定義するFileLabelInfoType オブジェクト。

次のステップ

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