建立自訂中繼資料標籤偵測工具

本文說明如何設定 Sensitive Data Protection,偵測內容中的特定中繼資料標籤。

在本文件中,「中繼資料標籤」是指嵌入支援檔案中的檔案標籤,或用戶端應用程式在檢查要求中提供的中繼資料。如果 Sensitive Data Protection 找到符合中繼資料條件的內容,就會產生發現項目。

如要掃描中繼資料標籤,請建立自訂中繼資料標籤 infoType。接著,設定檢查或探索掃描作業,搜尋該 infoType。

優點及用途

這項功能可讓您使用現有的分類法,進行內容檢查和政策違規處置。如果您使用自訂或第三方分類系統,將中繼資料標籤套用至文件,可以設定 Sensitive Data Protection,在檢查或探索作業期間偵測這些中繼資料標籤。

應用實例包括:

  • 掃描檔案,找出含有特定中繼資料的 Google 雲端硬碟標籤或 Microsoft 敏感度標籤。
  • 結合中繼資料標籤偵測和標準 infoType 偵測,採取多層式做法。
  • 掃描用戶端應用程式與內容一併傳遞的中繼資料,即使中繼資料未嵌入檔案也一樣。在本文中,這類中繼資料稱為「用戶端提供的中繼資料」。
  • 使用 Model Armor,根據特定中繼資料標籤清理文件。如要搭配 Model Armor (或使用 Model Armor 的服務,例如 Gemini Enterprise) 使用這項功能,您必須在 Model Armor 中建立進階 Sensitive Data Protection 設定,並參照這個自訂中繼資料標籤偵測工具。

支援的中繼資料格式

這項功能可偵測下列類型的中繼資料:

  • Google 雲端硬碟標籤
  • 下列檔案類型的 Microsoft 敏感度標籤:

    • DOCX
    • PDF
    • PPTX
    • XLSX
  • 用戶端提供的中繼資料

不支援的設定

下列項目不支援自訂中繼資料標籤偵測工具:

建立中繼資料標籤偵測工具

如要建立中繼資料標籤偵測工具,請在 InspectConfig 物件中定義 CustomInfoType。請根據要掃描的中繼資料類型,定義下列其中一項:

建立中繼資料標籤偵測工具,掃描檔案標籤

如要掃描 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 發現項目。

建立中繼資料標籤偵測工具,掃描自訂鍵/值組合

如要使用規則運算式掃描用戶端提供的中繼資料,找出自訂鍵/值組合,請按照下列步驟操作:

  1. 定義具有 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:用於搜尋中繼資料標籤值的規則運算式。

  2. 在 content.inspect 要求中,於 ContentItem 的 ContentMetadata 欄位指定用戶端提供的中繼資料。

掃描用戶端提供中繼資料的要求範例

以下範例顯示 content.inspect 要求,其中包含 PDF 檔案和用戶端提供的中繼資料。這項要求會使用名為 CUSTOM_METADATA_CLASSIFICATION 的自訂 infoType,掃描標示為「Confidential」或「Internal Use」的檔案。

{
  "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 在內容中找到相符項目,就會產生發現項目。系統會根據比對結果是嵌入在檔案中 (CONTENT_METADATA),還是由用戶端提供 (CLIENT_PROVIDED_METADATA),填入MetadataLocation 的發現項目 MetadataType。

後續步驟