Membuat pendeteksi label metadata kustom

Dokumen ini menjelaskan cara mengonfigurasi Sensitive Data Protection untuk mendeteksi label metadata tertentu dalam konten Anda.

Dalam dokumen ini, label metadata adalah label file yang disematkan dalam file yang didukung atau metadata yang disediakan oleh aplikasi klien Anda dalam permintaan pemeriksaan. Jika Sensitive Data Protection menemukan konten yang cocok dengan kriteria metadata Anda, Sensitive Data Protection akan menghasilkan temuan.

Untuk memindai label metadata, buat infoType label metadata kustom. Kemudian, konfigurasi pemindaian penemuan atau inspeksi Anda untuk menelusuri infoType tersebut.

Manfaat dan kasus penggunaan

Fitur ini memungkinkan Anda menggunakan taksonomi klasifikasi yang ada untuk pemeriksaan konten dan penegakan kebijakan. Jika Anda menggunakan sistem klasifikasi kustom atau pihak ketiga yang menerapkan label metadata ke dokumen Anda, Anda dapat mengonfigurasi Sensitive Data Protection untuk mendeteksi label metadata ini selama operasi inspeksi atau penemuan Anda.

Contoh kasus penggunaan mencakup:

  • Memindai file untuk mengetahui keberadaan label Google Drive atau label sensitivitas Microsoft yang berisi metadata tertentu.
  • Gabungkan deteksi label metadata dengan deteksi infoType standar untuk pendekatan berlapis-lapis.
  • Memindai metadata yang diteruskan oleh aplikasi klien Anda bersama konten, meskipun metadata tidak disematkan dalam file. Dalam dokumen ini, jenis metadata ini disebut metadata yang disediakan klien.
  • Bersihkan dokumen menggunakan Model Armor berdasarkan label metadata tertentu. Untuk menggunakan fitur ini dengan Model Armor—atau layanan yang menggunakan Model Armor seperti Gemini Enterprise—Anda harus membuat konfigurasi Sensitive Data Protection lanjutan di Model Armor yang mereferensikan detektor label metadata kustom ini.

Format metadata yang didukung

Fitur ini dapat mendeteksi jenis metadata berikut:

  • Label Google Drive

  • Label sensitivitas Microsoft pada jenis file berikut:

    • DOCX
    • PDF
    • PPTX
    • XLSX

  • Metadata yang disediakan klien

Konfigurasi yang tidak didukung

Detektor label metadata kustom tidak didukung di bagian berikut:

Membuat detektor label metadata

Untuk membuat pendeteksi label metadata, tentukan CustomInfoType dalam objek InspectConfig. Bergantung pada jenis metadata yang ingin Anda pindai, tentukan salah satu hal berikut:

Membuat detektor label metadata untuk memindai label file

Untuk memindai label Google Drive atau label sensitivitas Microsoft, tentukan CustomInfoType yang memiliki FileLabelInfoType:

{
  "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"
              }
            ]
          },
          "sensitivityLabel": {
            "guid": "GUID"
          }
        }
      }
    ]
  }
}

Ganti kode berikut:

  • CUSTOM_METADATA_LABEL_NAME: Nama yang akan ditetapkan ke detektor infoType kustom.
  • LIKELIHOOD: Opsional. Nilai Likelihood yang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, tingkat kemungkinan defaultnya adalah VERY_LIKELY.

  • SENSITIVITY_SCORE: Opsional. SensitivityScore yang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, skor sensitivitas default adalah HIGH.

    Skor sensitivitas digunakan dalam profil data. Saat membuat profil data Anda, Sensitive Data Protection menggunakan skor sensitivitas infoType untuk menghitung tingkat sensitivitas.

  • LABEL_ID: Opsional. ID label Google Drive yang akan dicocokkan. Jika Anda hanya menentukan LABEL_ID, detektor akan mencocokkan file apa pun yang menerapkan label Google Drive tersebut, terlepas dari nilai kolomnya. Untuk mencocokkan nilai kolom tertentu dalam label, sertakan objek labelFieldsToMatch.

  • FIELD_ID: Wajib jika Anda menentukan objek labelFieldsToMatch. ID kolom label Google Drive yang akan dicocokkan.

  • FIELD_VALUE: Wajib jika Anda menentukan objek labelFieldsToMatch. Nilai kolom label Google Drive yang akan dicocokkan.

  • GUID: Opsional. GUID label sensitivitas Microsoft yang akan dicocokkan.

Contoh detektor untuk label Google Drive

Contoh inspectConfig ini menentukan infoType kustom bernama CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL. infoType kustom ini mendeteksi label Google Drive yang memiliki:

  • ID label mydrive-label-id
  • Dalam label tersebut, kolom dengan ID sensitivity-field-id dan nilai confidential.

Jika Anda tidak menentukan ID kolom dan nilai di labelFieldsToMatch, infoType kustom ini akan mendeteksi file yang memiliki label mydrive-label-id, terlepas dari adanya kolom label.

{
  "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"
  }
}

Saat Anda menggunakan konfigurasi ini dalam tugas inspeksi, Sensitive Data Protection akan membuat temuan CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL jika menemukan kecocokan.

Contoh detektor untuk label sensitivitas Microsoft

Contoh inspectConfig ini menentukan infoType kustom bernama CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL. infoType kustom ini mendeteksi label sensitivitas Microsoft yang berisi GUID 12345678-9012-3456-7890-123456789012:

{
  "inspectConfig": {
    "customInfoTypes": [
      {
        "infoType": {
          "name": "CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL"
        },
        "likelihood": "VERY_LIKELY",
        "fileLabelInfoType": {
          "sensitivityLabel": {
            "guid": "12345678-9012-3456-7890-123456789012"
          }
        }
      }
    ],
    "minLikelihood": "POSSIBLE"
  }
}

Saat Anda menggunakan konfigurasi ini dalam tugas inspeksi, Sensitive Data Protection akan membuat CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL temuan jika menemukan kecocokan.

Membuat pendeteksi label metadata untuk memindai key-value pair kustom

Untuk menggunakan ekspresi reguler guna memindai key-value pair kustom dalam metadata yang disediakan klien, ikuti langkah-langkah berikut:

  1. Tentukan CustomInfoType yang memiliki MetadataKeyValueExpression:

    {
  "inspectConfig": {
    "customInfoTypes": [
      {
        "infoType": {
          "name": "CUSTOM_METADATA_LABEL_NAME"
        },
        "likelihood": "LIKELIHOOD",
        "sensitivityScore": {
          "score": "SENSITIVITY_SCORE"
        },
        "metadataKeyValueExpression": {
          "keyRegex": "KEY_REGULAR_EXPRESSION",
          "valueRegex": "VALUE_REGULAR_EXPRESSION"
        }
      }
    ]
  }
}

    Ganti kode berikut:

    • CUSTOM_METADATA_LABEL_NAME: Nama yang akan ditetapkan ke detektor infoType kustom.
    • LIKELIHOOD: Opsional. Nilai Likelihood yang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, tingkat kemungkinan defaultnya adalah VERY_LIKELY.

    • SENSITIVITY_SCORE: Opsional. SensitivityScore yang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, skor sensitivitas defaultnya adalah HIGH.

      Skor sensitivitas digunakan dalam profil data. Saat membuat profil data Anda, Sensitive Data Protection menggunakan skor sensitivitas infoType untuk menghitung tingkat sensitivitas.

    • KEY_REGULAR_EXPRESSION: Ekspresi reguler untuk dicari di kunci label metadata.

    • VALUE_REGULAR_EXPRESSION: Ekspresi reguler untuk menelusuri nilai label metadata.

  2. Dalam permintaan content.inspect, tentukan metadata yang disediakan klien di kolom ContentMetadata dari ContentItem.

Contoh permintaan untuk memindai metadata yang disediakan klien

Contoh berikut menunjukkan permintaan content.inspect yang menyertakan file PDF dan metadata yang disediakan klien. Permintaan menggunakan infoType kustom bernama CUSTOM_METADATA_CLASSIFICATION untuk memindai file yang ditandai sebagai "Rahasia" atau "Penggunaan Internal".

{
  "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"
        }
      ]
    }
  }
}

Ganti BASE64_ENCODED_PDF dengan file berenkode base64 yang akan dipindai.

Sensitive Data Protection akan menghasilkan temuan jika menemukan kecocokan dalam konten. MetadataType temuan untuk MetadataLocation diisi berdasarkan apakah kecocokan disematkan dalam file (CONTENT_METADATA) atau disediakan oleh klien (CLIENT_PROVIDED_METADATA).

Langkah berikutnya