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, layanan ini akan menghasilkan temuan.
Untuk memindai label metadata, buat infoType label metadata kustom. Kemudian, konfigurasikan pemindaian pemeriksaan atau penemuan 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 dapat mengonfigurasi Sensitive Data Protection untuk mendeteksi label metadata ini selama operasi pemeriksaan atau penemuan.
Contoh kasus penggunaan mencakup:
- Memindai file untuk menemukan keberadaan label Google Drive atau label sensitivitas Microsoft yang berisi metadata tertentu.
- Gabungkan deteksi label metadata dengan deteksi infoType standar untuk pendekatan berlapis.
- Memindai metadata yang diteruskan aplikasi klien Anda bersama konten, meskipun metadata tidak disematkan dalam file. Dalam dokumen ini, jenis metadata ini disebut metadata yang disediakan klien.
- Membersihkan 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 merujuk ke pendeteksi 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
- PPTX
- XLSX
Metadata yang disediakan klien
Konfigurasi yang tidak didukung
Detektor label metadata kustom tidak didukung dalam hal berikut:
Membuat pendeteksi 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:
- Untuk memindai label Google Drive dan label sensitivitas Microsoft, tentukan
FileLabelInfoType. Untuk mengetahui informasi selengkapnya, lihat Membuat pendeteksi label metadata untuk memindai label file dalam dokumen ini. - Untuk menggunakan ekspresi reguler guna memindai key-value pair kustom, tentukan
MetadataKeyValueExpression. Jenis ini sesuai untuk metadata yang disediakan klien. Untuk mengetahui informasi selengkapnya, lihat Membuat pendeteksi label metadata untuk memindai pasangan nilai kunci dalam dokumen ini.
Membuat pendeteksi label metadata untuk memindai label file
Untuk memindai label Google Drive atau label sensitivitas Microsoft, tentukan
CustomInfoType yang memiliki
FileLabelInfoType. Dalam
fileLabelInfoType, tentukan googleDriveLabel atau sensitivityLabel
(kolom ini bersifat eksklusif).
Untuk memindai label Google Drive:
{
"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"
}
]
}
}
}
]
}
}
Untuk memindai label sensitivitas Microsoft:
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
Ganti kode berikut:
CUSTOM_METADATA_LABEL_NAME: Nama yang akan ditetapkan ke detektor infoType kustom.LIKELIHOOD: Opsional. NilaiLikelihoodyang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, tingkat kemungkinan defaultnya adalahVERY_LIKELY.SENSITIVITY_SCORE: Opsional.SensitivityScoreyang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, skor sensitivitas defaultnya adalahHIGH.Skor sensitivitas digunakan dalam profil data. Saat membuat profil data Anda, Sensitive Data Protection menggunakan skor sensitivitas infoType untuk menghitung tingkat sensitivitas.
LABEL_ID: Diperlukan saat Anda menentukangoogleDriveLabel. ID label Google Drive yang akan dicocokkan. Jika Anda hanya menentukanLABEL_ID, pendeteksi akan mencocokkan file apa pun yang menerapkan label Google Drive tersebut, terlepas dari nilai kolomnya. Untuk mencocokkan nilai kolom tertentu dalam label, sertakan objeklabelFieldsToMatch.FIELD_ID: Wajib ada jika Anda menentukan objeklabelFieldsToMatch. ID kolom label Google Drive yang akan dicocokkan.FIELD_VALUE: Wajib ada jika Anda menentukan objeklabelFieldsToMatch. Nilai kolom label Google Drive yang akan dicocokkan.GUID: Diperlukan saat Anda menentukansensitivityLabel. GUID label sensitivitas Microsoft yang akan dicocokkan.
Contoh pendeteksi 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 hal berikut:
- ID label
mydrive-label-id - Dalam label tersebut, kolom dengan ID
sensitivity-field-iddan nilaiconfidential.
Jika Anda tidak menentukan ID dan nilai kolom di labelFieldsToMatch, infoType kustom ini akan mendeteksi file yang memiliki label mydrive-label-id, terlepas dari keberadaan kolom label apa pun.
{
"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 menghasilkan
temuan CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL jika menemukan kecocokan.
Contoh pendeteksi 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 menghasilkan temuan CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL
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:
Tentukan
CustomInfoTypeyang memilikiMetadataKeyValueExpression:{ "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. NilaiLikelihoodyang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, tingkat kemungkinan defaultnya adalahVERY_LIKELY.SENSITIVITY_SCORE: Opsional.SensitivityScoreyang akan ditetapkan ke semua temuan yang cocok dengan infoType kustom ini. Jika Anda menghapus kolom ini, skor sensitivitas defaultnya adalahHIGH.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 yang akan ditelusuri dalam kunci label metadata.VALUE_REGULAR_EXPRESSION: Ekspresi reguler yang akan ditelusuri dalam nilai label metadata.
Dalam permintaan
content.inspectAnda, tentukan metadata yang disediakan klien di kolomContentMetadatadariContentItem.
Contoh permintaan untuk memindai metadata yang disediakan klien
Contoh berikut menunjukkan permintaan content.inspect yang menyertakan file PDF dan metadata yang disediakan klien. Permintaan ini menggunakan infoType kustom bernama
CUSTOM_METADATA_CLASSIFICATION untuk memindai file yang ditandai sebagai
"Confidential" atau "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"
}
]
}
}
}
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).