このドキュメントでは、コンテンツ内の特定のメタデータ ラベルを検出するように Sensitive Data Protection を構成する方法について説明します。
このドキュメントでは、メタデータ ラベルは、サポートされているファイルに埋め込まれたファイルラベル、または検査リクエストでクライアント アプリケーションから提供されたメタデータです。Sensitive Data Protection でメタデータの条件に一致するコンテンツが見つかると、検出結果が生成されます。
メタデータ ラベルをスキャンするには、カスタム メタデータ ラベル infoType を作成します。次に、その infoType を検索するように検査スキャンまたは検出スキャンを構成します。
利点と使用例
この機能を使用すると、既存の分類タクソノミーをコンテンツ検査とポリシーの適用に使用できます。ドキュメントにメタデータ ラベルを適用するカスタムまたはサードパーティの分類システムを使用している場合は、検査または検出オペレーション中にこれらのメタデータ ラベルを検出するように Sensitive Data Protection を構成できます。
使用例には、次のようなものがあります。
- 特定のメタデータを含む Google ドライブのラベルまたは Microsoft 秘密度ラベルの有無をスキャンします。
- メタデータ ラベル検出と標準の infoType 検出を組み合わせて、多層的なアプローチを実現します。
- クライアント アプリケーションがコンテンツとともに渡すメタデータをスキャンします。メタデータがファイルに埋め込まれていない場合でもスキャンされます。このドキュメントでは、このタイプのメタデータをクライアント提供のメタデータと呼びます。
- 特定のメタデータ ラベルに基づいて、Model Armor を使用してドキュメントをサニタイズします。Model Armor(または Gemini Enterprise などの Model Armor を使用するサービス)でこの機能を使用するには、このカスタム メタデータ ラベル検出器を参照する Model Armor で Sensitive Data Protection の詳細の構成を作成する必要があります。
サポートされているメタデータ形式
この機能では、次のタイプのメタデータを検出できます。
- Google ドライブのラベル
次のファイル形式の Microsoft 秘密度ラベル:
- DOCX
- PPTX
- XLSX
クライアント提供のメタデータ
サポートされていない構成
カスタム メタデータ ラベル検出機能は、次の機能ではサポートされていません。
メタデータ ラベル検出器を作成する
メタデータ ラベル検出項目を作成するには、InspectConfig オブジェクト内に CustomInfoType を定義します。スキャンするメタデータの種類に応じて、次のいずれかを定義します。
- Google ドライブのラベルと Microsoft 秘密度ラベルをスキャンするには、
FileLabelInfoTypeを定義します。詳細については、このドキュメントのメタデータ ラベル検出器を作成してファイルラベルをスキャンするをご覧ください。 - 正規表現を使用してカスタム Key-Value ペアをスキャンするには、
MetadataKeyValueExpressionを定義します。このタイプは、クライアントから提供されたメタデータに適しています。詳細については、このドキュメントのKey-Value ペアをスキャンするメタデータ ラベル検出器を作成するをご覧ください。
メタデータ ラベル検出器を作成してファイルラベルをスキャンする
Google ドライブのラベルまたは Microsoft 秘密度ラベルをスキャンするには、FileLabelInfoType を含む CustomInfoType を定義します。fileLabelInfoType 内で、googleDriveLabel または sensitivityLabel を指定します(これらのフィールドは相互に排他的です)。
Google ドライブのラベルをスキャンするには:
{
"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"
}
]
}
}
}
]
}
}
Microsoft 秘密度ラベルをスキャンするには:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
次のように置き換えます。
CUSTOM_METADATA_LABEL_NAME: カスタム infoType 検出機能に割り当てる名前。LIKELIHOOD: 省略可。このカスタム infoType に一致するすべての検出結果に割り当てるLikelihood値。このフィールドを省略した場合、デフォルトの可能性レベルはVERY_LIKELYです。SENSITIVITY_SCORE: 省略可。このカスタム infoType に一致するすべての検出結果に割り当てるSensitivityScore。このフィールドを省略した場合、デフォルトの機密スコアはHIGHです。機密性スコアはデータ プロファイルで使用されます。データのプロファイリング時に、Sensitive Data Protection は、infoType の機密性スコアを使用して機密性レベルを計算します。
LABEL_ID:googleDriveLabelを指定する場合は必須。照合する Google ドライブ ラベルの ID。LABEL_IDのみを指定すると、検出機能は、フィールド値に関係なく、その Google ドライブのラベルが適用されているすべてのファイルと一致します。ラベル内の特定のフィールド値を照合するには、labelFieldsToMatchオブジェクトを含めます。FIELD_ID:labelFieldsToMatchオブジェクトを指定する場合は必須。照合する Google ドライブ ラベル フィールドの ID。FIELD_VALUE:labelFieldsToMatchオブジェクトを指定する場合は必須。照合する Google ドライブ ラベル フィールドの値。GUID:sensitivityLabelを指定する場合は必須。一致する Microsoft 秘密度ラベルの GUID。
Google ドライブ ラベルの検出機能の例
この inspectConfig の例では、CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL という名前のカスタム infoType を定義しています。このカスタム infoType は、次の Google ドライブ ラベルを検出します。
- ラベル ID
mydrive-label-id - そのラベル内の、ID が
sensitivity-field-idで値がconfidentialのフィールド。
labelFieldsToMatch でフィールド ID と値を指定しない場合、このカスタム infoType は、ラベル フィールドの有無に関係なく、mydrive-label-id ラベルを持つファイルを検出します。
{
"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"
}
}
この構成を検査ジョブで使用すると、一致が見つかった場合に Sensitive Data Protection によって CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL 検出結果が生成されます。
Microsoft 秘密度ラベルの検出機能の例
この inspectConfig の例では、CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL という名前のカスタム infoType を定義しています。このカスタム infoType は、GUID 12345678-9012-3456-7890-123456789012 を含む Microsoft 秘密度ラベルを検出します。
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL"
},
"likelihood": "VERY_LIKELY",
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "12345678-9012-3456-7890-123456789012"
}
}
}
],
"minLikelihood": "POSSIBLE"
}
}
検査ジョブでこの構成を使用すると、一致が見つかった場合に Sensitive Data Protection によって CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL 検出結果が生成されます。
メタデータ ラベル検出器を作成して、カスタム Key-Value ペアをスキャンする
正規表現を使用して、クライアント提供のメタデータ内のカスタム Key-Value ペアをスキャンする手順は次のとおりです。
MetadataKeyValueExpressionを持つCustomInfoTypeを定義します。{ "inspectConfig": { "customInfoTypes": [ { "infoType": { "name": "CUSTOM_METADATA_LABEL_NAME" }, "likelihood": "LIKELIHOOD", "sensitivityScore": { "score": "SENSITIVITY_SCORE" }, "metadataKeyValueExpression": { "keyRegex": "KEY_REGULAR_EXPRESSION", "valueRegex": "VALUE_REGULAR_EXPRESSION" } } ] } }次のように置き換えます。
CUSTOM_METADATA_LABEL_NAME: カスタム infoType 検出機能に割り当てる名前。LIKELIHOOD: 省略可。このカスタム infoType に一致するすべての検出結果に割り当てるLikelihood値。このフィールドを省略した場合、デフォルトの可能性レベルはVERY_LIKELYです。SENSITIVITY_SCORE: 省略可。このカスタム infoType に一致するすべての検出結果に割り当てるSensitivityScore。このフィールドを省略すると、デフォルトの機密スコアはHIGHになります。機密性スコアはデータ プロファイルで使用されます。データのプロファイリング時に、Sensitive Data Protection は、infoType の機密性スコアを使用して機密性レベルを計算します。
KEY_REGULAR_EXPRESSION: メタデータ ラベルのキーで検索する正規表現。VALUE_REGULAR_EXPRESSION: メタデータ ラベルの値で検索する正規表現。
content.inspectリクエストで、ContentItemのContentMetadataフィールドにクライアント提供のメタデータを指定します。
クライアント提供のメタデータをスキャンするリクエストの例
次の例は、PDF ファイルとクライアント提供のメタデータの両方を含む content.inspect リクエストを示しています。このリクエストでは、CUSTOM_METADATA_CLASSIFICATION という名前のカスタム infoType を使用して、「機密」または「内部使用」としてマークされているファイルをスキャンします。
{
"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"
}
]
}
}
}
BASE64_ENCODED_PDF は、スキャンする base64 でエンコードされたファイルに置き換えます。
Sensitive Data Protection は、コンテンツに一致するものが見つかると、検出結果を生成します。MetadataLocation の検出結果の MetadataType は、一致がファイルに埋め込まれているか(CONTENT_METADATA)、クライアントから提供されているか(CLIENT_PROVIDED_METADATA)に基づいて入力されます。