Dokumen ini menjelaskan cara melihat dan memperbarui setelan floor Model Armor serta memberikan contoh pelanggaran setelan floor.
Setelan tingkat memiliki dua tujuan utama:
Kesesuaian template: Pastikan template baru setidaknya sama ketatnya dengan yang ditentukan dalam setelan minimum. Kesesuaian template ditentukan di level organisasi dan folder.
Penegakan inline: Terapkan perlindungan Model Armor ke model Gemini dan server MCP Google Cloud. Penegakan inline dikonfigurasi di level project. Jika Anda menggunakan setelan minimum untuk penegakan inline, template apa pun yang Anda buat dalam project harus sesuai dengan setelan minimum tersebut.
Kapan harus menggunakan setelan harga minimum
Berikut adalah beberapa kasus penggunaan umum:
- Menerapkan kepatuhan template dan mencegah regresi kebijakan: Tentukan nilai minimum filter di tingkat organisasi, folder, atau project untuk memastikan bahwa template yang baru dibuat dan diperbarui memenuhi standar keamanan Anda dan tidak dapat menurunkan perlindungan di bawah dasar pengukuran yang ditetapkan.
- Mengaktifkan penegakan inline untuk model dan alat: Membantu melindungi model Gemini yang didukung dan Google Cloud server MCP jarak jauh di level project tanpa mengubah kode aplikasi.
- Mengatur konfigurasi tim yang terdesentralisasi: Memungkinkan tim project otonom membuat template kustom sekaligus menjamin bahwa setelan mereka sesuai dengan kebijakan tata kelola organisasi.
Sebelum memulai
Sebelum memulai, selesaikan tugas berikut.
Mendapatkan izin yang diperlukan
Untuk mendapatkan izin yang
diperlukan untuk mengelola setelan floor,
minta administrator untuk memberi Anda
peran IAM Model Armor Floor Setting Admin (roles/modelarmor.floorSettingsAdmin) di setelan floor Model Armor.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Mengaktifkan API
Anda harus mengaktifkan Model Armor API sebelum dapat menggunakan Model Armor.
Konsol
Aktifkan Model Armor API, jika belum diaktifkan.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan izin
serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.Pilih project tempat Anda ingin mengaktifkan Model Armor.
gcloud
Sebelum memulai, ikuti langkah-langkah berikut menggunakan Google Cloud CLI dengan Model Armor API:
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud initAktifkan Model Armor API, jika belum diaktifkan:
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan izin
serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.gcloud services enable modelarmor.googleapis.com
Menetapkan penggantian endpoint API menggunakan gcloud CLI
Langkah ini hanya diperlukan jika Anda menggunakan gcloud CLI. Tetapkan penggantian endpoint API untuk memastikan gcloud CLI merutekan permintaan dengan benar ke layanan Model Armor.
Jalankan perintah berikut untuk menggunakan endpoint API global:
gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.googleapis.com/"
Penerapan setelan harga minimum
Setelan lokal selalu diterapkan. Misalnya, jika setelan harga minimum bertentangan, setelan yang lebih rendah dalam hierarki resource akan lebih diprioritaskan. Demikian pula, setelan tingkat project akan menggantikan setelan tingkat folder yang bertentangan.
Tabel berikut mencantumkan cara setelan nilai minimum diterapkan di berbagai tingkat:
| Tingkat setelan harga minimum | Aplikasi |
|---|---|
| Level organisasi | Berlaku untuk semua hal dalam organisasi. |
| Level folder | Berlaku untuk semua project di dalam folder tertentu tersebut. |
| Level project | Hanya berlaku untuk satu project tertentu. |
Untuk mengilustrasikan cara setelan nilai minimum diterapkan saat ditetapkan di berbagai tingkat, pertimbangkan contoh skenario berikut. Misalnya, Anda menetapkan setelan harga minimum sebagai berikut:
- Setelan minimum tingkat folder (kurang spesifik): Semua konten dalam folder ini harus mengaktifkan filter URI berbahaya.
- Setelan batas bawah tingkat project (lebih spesifik): Project Anda dalam folder harus menggunakan deteksi prompt injection dan jailbreak dengan keyakinan sedang.
Dalam skenario ini, setelan akan menghasilkan hal berikut:
Setiap template yang Anda buat di project harus menyertakan filter deteksi injeksi perintah dan jailbreak karena setelan level project selalu lebih diprioritaskan daripada setelan level folder.
Template yang dibuat di project atau folder lain tidak terpengaruh oleh aturan filter URI berbahaya dari folder pertama.
Setelan harga minimum hanya berlaku dalam tingkat spesifiknya dalam hierarki, kecuali jika ditetapkan di tingkat organisasi, yang dalam hal ini, setelan tersebut berlaku di seluruh organisasi.
Kesesuaian template dan setelan tingkat
Saat template Model Armor dibuat atau diperbarui, Model Armor akan memeriksa apakah konfigurasi template sesuai dengan setelan minimum. Anda tidak dapat membuat atau memperbarui template yang lebih longgar dibandingkan setelan tingkat.
Setelan harga minimum menerapkan aturan kesesuaian berikut pada template:
- Penerapan filter: Jika setelan batas memerlukan filter untuk diaktifkan (seperti
URL berbahaya, injeksi perintah dan jailbreak, atau penerapan filter materi pelecehan seksual
terhadap anak-anak (CSAM) yang ditetapkan ke
ENABLED), template dalam cakupan tersebut tidak dapat menetapkan filter keDISABLED. - Prioritas tingkat keyakinan: Template harus mengonfigurasi tingkat keyakinan
yang setidaknya sama ketatnya dengan setelan minimum. Misalnya, jika setelan minimum
menentukan
MEDIUM_AND_ABOVEuntuk responsible AI atau deteksi CSAM, template tidak dapat menetapkan tingkat keyakinan keHIGH.
Anda dapat menetapkan setelan tingkat di level organisasi, folder, dan project. Antarmuka pengguna hanya tersedia di level project dan memungkinkan Anda mewarisi setelan level organisasi atau level folder. Untuk menetapkan setelan harga minimum di tingkat organisasi atau folder, Anda harus menggunakan API.
Kesesuaian template memvalidasi konfigurasi template. Pemeriksaan data menggunakan konfigurasi yang ditentukan dalam template yang sesuai untuk menganalisis perintah atau respons selama runtime. Tabel berikut menjelaskan cara kesesuaian template dan pemeriksaan data diterapkan ke template dan setelan nilai minimum.
| Cek | Setelan tingkat | Template |
|---|---|---|
| Kesesuaian template | Dikonfigurasi di level organisasi, folder, atau project. Catatan: Sensitive Data Protection dapat ditetapkan untuk menerapkan kebijakan keamanan data pada template. Namun, alat ini tidak memvalidasi kesesuaian template. |
Hanya dikonfigurasi di level project. |
| Pemeriksaan data | Hanya diterapkan di level project menggunakan mode periksa dan blokir. | Diterapkan menggunakan REST API, Service Extensions, Gemini Enterprise, dan Agent Runtime. |
Integrasi dengan Gemini Enterprise Agent Platform dan server MCP Google Cloud
Model Armor terintegrasi dengan Agent Platform dan server MCP Google Cloud untuk menyaring permintaan dan respons dari model Gemini dan server MCP jarak jauhGoogle Cloud berdasarkan setelan dasar yang Anda tentukan. Anda harus mengaktifkan Cloud Logging untuk melihat perintah dan respons. Untuk mengetahui informasi selengkapnya, lihat Integrasi Model Armor dengan Gemini Enterprise Agent Platform dan Integrasi Model Armor dengan server MCP Google Cloud.
Versi filter setelan tingkat
Setelan harga minimum menggunakan versi filter Stable secara default.
Daftar berikut menjelaskan cara kerja versi filter dengan setiap integrasi:
- Integrasi dengan Gemini Enterprise Agent Platform:
Jika Anda ingin mengganti setelan ini, tentukan template dalam
panggilan
generateContentke model Gemini. - Integrasi dengan server Google dan Google Cloud MCP: Anda tidak dapat mengganti versi filter karena integrasi ini hanya mendukung setelan harga minimum.
Mengonfigurasi setelan harga minimum
Konfigurasi setelan minimum untuk menentukan nilai minimum deteksi minimum untuk template Model Armor. Setelan ini memastikan bahwa semua template baru dan yang diubah memenuhi persyaratan tertentu.
Untuk mengonfigurasi setelan lantai, pilih salah satu opsi berikut:
Konsol
- Di konsol Google Cloud , buka halaman Model Armor.
- Pilih project.
- Di halaman Model Armor, buka tab Floor settings, lalu klik Configure floor settings.
- Di halaman Konfigurasi setelan lantai, pilih opsi konfigurasi.
- Di bagian Detections, konfigurasi setelan deteksi.
- Opsional: Jika Anda memilih deteksi Sensitive Data Protection, konfigurasikan setelan Sensitive Data Protection.
Di bagian Responsible AI, tetapkan tingkat keyakinan untuk setiap filter konten.
- Di bagian Layanan, pilih layanan tempat setelan lantai ini berlaku.
- Di bagian Logs, pilih Enable Cloud Logging untuk mencatat semua perintah pengguna, respons model, dan hasil detektor setelan minimum.
- Pilih Enable multi-language support untuk menggunakan setelan deteksi multibahasa.
- Klik Simpan setelan lantai.
gcloud
Jalankan perintah
gcloud model-armor floorsettings update
untuk mengonfigurasi setelan lantai:
gcloud model-armor floorsettings update \
--full-uri='RESOURCE_PARENT/locations/global/floorSetting' \
--rai-settings-filters='[{"filterType": "HATE_SPEECH", "confidenceLevel": "MEDIUM_AND_ABOVE"}, {"filterType": "HARASSMENT", "confidenceLevel": "HIGH"}, {"filterType": "DANGEROUS", "confidenceLevel": "MEDIUM_AND_ABOVE"}, {"filterType": "SEXUALLY_EXPLICIT", "confidenceLevel": "MEDIUM_AND_ABOVE"}]' \
--basic-config-filter-enforcement=ENABLED \
--pi-and-jailbreak-filter-settings-enforcement=ENABLED \
--pi-and-jailbreak-filter-settings-confidence-level=HIGH \
--malicious-uri-filter-settings-enforcement=ENABLED \
--enable-floor-setting-enforcement=true \
--add-integrated-services=AI_PLATFORM,GOOGLE_MCP_SERVER \
--vertex-ai-enforcement-type=INSPECT_AND_BLOCK \
--enable-vertex-ai-cloud-logging \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--enable-multi-language-detection
Ganti RESOURCE_PARENT dengan cakupan hierarki tempat
setelan lantai berlaku:
Tingkat organisasi:
organizations/ORGANIZATION_ID, yang mengatur semua folder dan project dalam organisasi.Level folder:
folders/FOLDER_ID, yang mengatur semua project dalam folder.Level project:
projects/PROJECT_ID, yang mengatur satu project.
REST
Untuk mengonfigurasi setelan lantai menggunakan REST API, kirim permintaan PATCH ke resource
floorSetting:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"filterConfig": {
"raiSettings": {
"raiFilters": [
{
"filterType": "HATE_SPEECH",
"confidenceLevel": "MEDIUM_AND_ABOVE"
},
{
"filterType": "HARASSMENT",
"confidenceLevel": "HIGH"
},
{
"filterType": "DANGEROUS",
"confidenceLevel": "MEDIUM_AND_ABOVE"
},
{
"filterType": "SEXUALLY_EXPLICIT",
"confidenceLevel": "MEDIUM_AND_ABOVE"
}
]
},
"sdpSettings": {
"basicConfig": {
"filterEnforcement": "ENABLED"
}
},
"piAndJailbreakFilterSettings": {
"filterEnforcement": "ENABLED",
"confidenceLevel": "HIGH"
},
"maliciousUriFilterSettings": {
"filterEnforcement": "ENABLED"
}
},
"enableFloorSettingEnforcement": true,
"integratedServices": [
"AI_PLATFORM",
"GOOGLE_MCP_SERVER"
],
"aiPlatformFloorSetting": {
"inspectAndBlock": true,
"enableCloudLogging": true
},
"googleMcpServerFloorSetting": {
"inspectAndBlock": true,
"enableCloudLogging": true
},
"floorSettingMetadata": {
"multiLanguageDetection": {
"enableMultiLanguageDetection": true
}
}
}' \
"https://modelarmor.googleapis.com/v1/RESOURCE_PARENT/locations/global/floorSetting"
Ganti RESOURCE_PARENT dengan cakupan hierarki tempat
setelan lantai berlaku:
Tingkat organisasi:
organizations/ORGANIZATION_ID, yang mengatur semua folder dan project dalam organisasi.Level folder:
folders/FOLDER_ID, yang mengatur semua project dalam folder.Level project:
projects/PROJECT_ID, yang mengatur satu project.
Terraform
Untuk menerapkan nilai minimum keamanan di seluruh hierarki organisasi, folder, atau
project secara deklaratif, konfigurasikan
resource google_model_armor_floorsetting
menggunakan penyedia google (>= 6.13.0):
resource "google_model_armor_floorsetting" "floor_setting" {
parent = RESOURCE_PARENT
location = "global"
filter_config {
rai_settings {
rai_filters {
filter_type = "HATE_SPEECH"
confidence_level = "MEDIUM_AND_ABOVE"
}
rai_filters {
filter_type = "HARASSMENT"
confidence_level = "HIGH"
}
rai_filters {
filter_type = "DANGEROUS"
confidence_level = "MEDIUM_AND_ABOVE"
}
rai_filters {
filter_type = "SEXUALLY_EXPLICIT"
confidence_level = "MEDIUM_AND_ABOVE"
}
}
sdp_settings {
basic_config {
filter_enforcement = "ENABLED"
}
}
pi_and_jailbreak_filter_settings {
filter_enforcement = "ENABLED"
confidence_level = "HIGH"
}
malicious_uri_filter_settings {
filter_enforcement = "ENABLED"
}
}
enable_floor_setting_enforcement = true
integrated_services = [
"AI_PLATFORM",
"GOOGLE_MCP_SERVER",
]
ai_platform_floor_setting {
inspect_and_block = true
enable_cloud_logging = true
}
google_mcp_server_floor_setting {
inspect_and_block = true
enable_cloud_logging = true
}
floor_setting_metadata {
multi_language_detection {
enable_multi_language_detection = true
}
}
}
Ganti RESOURCE_PARENT dengan cakupan hierarki tempat
setelan lantai berlaku:
Tingkat organisasi:
organizations/ORGANIZATION_ID, yang mengatur semua folder dan project dalam organisasi.Level folder:
folders/FOLDER_ID, yang mengatur semua project dalam folder.Level project:
projects/PROJECT_ID, yang mengatur satu project.
Tunggu beberapa menit hingga perubahan pada setelan lantai diterapkan.
Menentukan cara setelan tingkat diwariskan
Saat mengonfigurasi setelan lantai, pilih opsi konfigurasi.
Mewarisi setelan minimum induk: Mewarisi setelan minimum yang ditetapkan sebelumnya dalam hierarki resource. Klik Simpan setelan nilai minimum dan lewati langkah-langkah yang tersisa. Untuk melihat setelan yang diwarisi, buka tab Setelan nilai minimum.
Kustom: Tentukan setelan lantai untuk project ini. Setelan kustom yang Anda tentukan untuk project akan menggantikan setelan minimum yang diwarisi.
Nonaktifkan: Menonaktifkan setelan nilai minimum yang diwariskan. Artinya, tidak ada aturan deteksi yang berlaku untuk template Model Armor dan Agent Platform untuk workload Gemini Anda. Klik Simpan setelan nilai minimum dan lewati langkah-langkah yang tersisa. Lihat status dinonaktifkan di tab Setelan harga minimum.
Menentukan tempat setelan harga minimum diterapkan
Pilih salah satu layanan berikut tempat setelan lantai yang dikonfigurasi berlaku.
Model Armor - Pembuatan & pembaruan template: Model Armor memeriksa setiap template Model Armor baru dan yang diubah dalam project untuk memastikan bahwa setelan minimum sesuai dengan setelan minimum.
Server MCP Google: Permintaan pemeriksaan setelan minimum yang dikirim ke atau dari server MCP jarak jauh Google atau Google Cloud untuk memastikan permintaan tersebut memenuhi nilai minimum setelan minimum. Untuk mengetahui informasi selengkapnya, lihat Integrasi Model Armor dengan server MCP Google Cloud (Pratinjau).
Agent Platform: Memeriksa permintaan yang dikirim ke model Gemini, lalu mencatat ke dalam log atau memblokir permintaan yang memenuhi nilai minimum setelan batas.
Jika Anda memilih Agent Platform, bagian Agent Platform akan muncul, tempat Anda memilih cara penerapan setelan harga minimum.
- Hanya periksa: Mendeteksi permintaan yang tidak memenuhi setelan harga minimum, tetapi tidak memblokirnya.
- Memeriksa dan memblokir pelanggaran: Mendeteksi dan memblokir permintaan yang tidak memenuhi setelan minimum.
Melihat setelan tingkat Model Armor
Lihat setelan tingkat Model Armor untuk memverifikasi setelan yang ada, mengidentifikasi persyaratan minimum untuk aplikasi AI Anda, atau memecahkan masalah saat template tidak berperilaku seperti yang diharapkan.
Jalankan perintah berikut untuk melihat setelan floor Model Armor.
Konsol
Di konsol Google Cloud , buka halaman Model Armor.
Pastikan Anda melihat project tempat Anda mengaktifkan Model Armor.
Di halaman Model Armor, buka tab Floor settings. Jika setelan tingkat ditetapkan di level organisasi, Anda dapat melihatnya. Jika tidak ada setelan lantai yang ditentukan, Anda harus mengonfigurasinya. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan lantai.
gcloud
Melihat setelan tingkat Model Armor untuk project.
gcloud model-armor floorsettings describe \ --full-uri='projects/PROJECT_ID/locations/global/floorSetting'
Melihat setelan tingkat Model Armor untuk organisasi.
gcloud model-armor floorsettings describe \ --full-uri='organizations/ORGANIZATION_ID/locations/global/floorSetting'
Melihat setelan tingkat Model Armor untuk folder.
gcloud model-armor floorsettings describe \ --full-uri='folders/FOLDER_ID/locations/global/floorSetting'
Ganti kode berikut:
- ID project untuk setelan lantai.
- ID folder untuk setelan lantai.
- ID organisasi untuk setelan lantai.
REST
Melihat setelan tingkat Model Armor untuk project.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://modelarmor.googleapis.com/v1/projects/PROJECT_ID/locations/global/floorSetting"
Melihat setelan tingkat Model Armor untuk folder.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://modelarmor.googleapis.com/v1/folders/FOLDER_ID/locations/global/floorSetting"
Melihat setelan tingkat Model Armor untuk organisasi.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://modelarmor.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/floorSetting"
Ganti kode berikut:
- ID project untuk setelan lantai.
- ID folder untuk setelan lantai.
- ID organisasi untuk setelan lantai.
C#
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan C# dan instal SDK C# Model Armor.
Melihat setelan tingkat Model Armor untuk project tertentu.
Melihat setelan tingkat Model Armor untuk folder tertentu.
Melihat setelan tingkat Model Armor untuk organisasi tertentu.
Go
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Go dan instal Model Armor Go SDK.
Melihat setelan tingkat Model Armor untuk project tertentu.
Melihat setelan tingkat Model Armor untuk folder tertentu.
Melihat setelan tingkat Model Armor untuk organisasi tertentu.
Java
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Java dan instal Model Armor Java SDK.
Melihat setelan tingkat Model Armor untuk project tertentu.
Melihat setelan tingkat Model Armor untuk folder tertentu.
Melihat setelan tingkat Model Armor untuk organisasi tertentu.
Node.js
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Node.js dan instal Model Armor Node.js SDK.
Melihat setelan tingkat Model Armor untuk project tertentu.
Melihat setelan tingkat Model Armor untuk folder tertentu.
Melihat setelan tingkat Model Armor untuk organisasi tertentu.
PHP
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan PHP dan instal Model Armor PHP SDK.
Melihat setelan tingkat Model Armor untuk project tertentu.
Melihat setelan tingkat Model Armor untuk folder tertentu.
Melihat setelan tingkat Model Armor untuk organisasi tertentu.
Python
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Python dan instal Model Armor Python SDK.
Melihat setelan tingkat Model Armor untuk project tertentu.
Melihat setelan tingkat Model Armor untuk folder tertentu.
Melihat setelan tingkat Model Armor untuk organisasi tertentu.
Memperbarui setelan tingkat Model Armor
Perbarui setelan minimum Model Armor untuk mengubah persyaratan minimum template, mencerminkan perubahan dalam kebijakan keamanan, memperbaiki kesalahan konfigurasi, atau menyelesaikan konflik antara setelan minimum.
Jalankan perintah berikut untuk memperbarui setelan batas Model Armor.
Konsol
Di konsol Google Cloud , buka halaman Model Armor.
Pastikan Anda melihat project tempat Anda mengaktifkan Model Armor.
Di halaman Model Armor, buka tab Floor settings, lalu klik Configure floor settings.
Perbarui kolom yang wajib diisi, lalu klik Simpan setelan nilai minimum.
gcloud
gcloud model-armor floorsettings update --full-uri=FULL_URI
Contoh perintah:
gcloud model-armor floorsettings update \
--malicious-uri-filter-settings-enforcement=ENABLED \
--pi-and-jailbreak-filter-settings-enforcement=DISABLED \
--pi-and-jailbreak-filter-settings-confidence-level=LOW_AND_ABOVE \
--basic-config-filter-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "low_and_above", "filterType": "HARASSMENT"}, {"confidenceLevel": "high", "filterType": "SEXUALLY_EXPLICIT"}]' \
--full-uri='folders/FOLDER_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=true
Untuk mengonfigurasi setelan lantai dengan deteksi multibahasa diaktifkan, jalankan perintah berikut:
gcloud model-armor floorsettings update \
--full-uri=projects/PROJECT_ID/locations/global/floorSetting \
--enable-multi-language-detection
Ganti kode berikut:
FULL_URI: URI resource lengkap setelan lantai.PROJECT_ID: ID project untuk setelan lantai.FOLDER_ID: ID folder untuk setelan lantai.
REST
Memperbarui setelan tingkat Model Armor untuk project tertentu.
curl -X PATCH \ \ -d '{"filterConfig": {"piAndJailbreakFilterSettings": {"filterEnforcement": "ENABLED"}, "maliciousUriFilterSettings": {"filterEnforcement": "ENABLED"}, "csamFilterSettings": { "filterEnforcement": "ENABLED", "confidenceLevel": "LOW_AND_ABOVE" }, "raiSettings": {"raiFilters": [{"filterType": "DANGEROUS", "confidenceLevel": "LOW_AND_ABOVE"}, {"filterType": "HATE_SPEECH", "confidenceLevel": "LOW_AND_ABOVE"}, {"filterType": "HARASSMENT", "confidenceLevel": "LOW_AND_ABOVE"}, {"filterType": "SEXUALLY_EXPLICIT", "confidenceLevel": "LOW_AND_ABOVE"}]}}, "enableFloorSettingEnforcement": true}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://modelarmor.googleapis.com/v1/projects/PROJECT_ID/locations/global/floorSetting"
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
curl -X PATCH \ -d '{"filterConfig" :{"piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED"}, "maliciousUriFilterSettings": {"filterEnforcement": "ENABLED" }, "csamFilterSettings": {"filterEnforcement": "ENABLED", "confidenceLevel": "LOW_AND_ABOVE" }},"enableFloorSettingEnforcement":"true"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://modelarmor.googleapis.com/v1/folders/FOLDER_ID/locations/global/floorSetting"
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
curl -X PATCH \ -d '{"filterConfig" :{"piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED"}, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" }, "csamFilterSettings": { "filterEnforcement": "ENABLED", "confidenceLevel": "LOW_AND_ABOVE" }},"enableFloorSettingEnforcement":"true"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://modelarmor.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/floorSetting"
Ganti kode berikut:
PROJECT_ID: ID project untuk setelan lantai.FOLDER_ID: ID folder untuk setelan lantai.ORGANIZATION_ID: ID organisasi untuk setelan lantai.
Perintah update menampilkan respons berikut:
{ "name": "projects/PROJECT_ID/locations/global/floorSetting", "updateTime": "2024-12-19T15:36:21.318191Z", "filterConfig": { "piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED" }, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" } } }
C#
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan C# dan instal SDK C# Model Armor.
Memperbarui setelan tingkat Model Armor untuk project tertentu.
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
Go
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Go dan instal Model Armor Go SDK.
Memperbarui setelan tingkat Model Armor untuk project tertentu.
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
Java
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Java dan instal Model Armor Java SDK.
Memperbarui setelan tingkat Model Armor untuk project tertentu.
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
Node.js
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Node.js dan instal Model Armor Node.js SDK.
Memperbarui setelan tingkat Model Armor untuk project tertentu.
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
PHP
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan PHP dan instal Model Armor PHP SDK.
Memperbarui setelan tingkat Model Armor untuk project tertentu.
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
Python
Untuk menjalankan kode ini, pertama-tama siapkan lingkungan pengembangan Python dan instal Model Armor Python SDK.
Memperbarui setelan tingkat Model Armor untuk project tertentu.
Memperbarui setelan tingkat Model Armor untuk folder tertentu.
Memperbarui setelan tingkat Model Armor untuk organisasi tertentu.
Meninjau temuan tentang pelanggaran setelan nilai minimum
Setiap temuan Model Armor mengidentifikasi pelanggaran setelan tingkat. Pelanggaran terjadi jika template Model Armor gagal memenuhi standar keamanan minimum yang ditentukan oleh setelan minimum hierarki resource. Setelan minimum menentukan persyaratan minimum untuk template.
Temuan dihasilkan saat salah satu pelanggaran setelan lantai berikut terjadi:
- Template dengan setelan yang tidak terlalu ketat dibuat sebelum Anda mengonfigurasi setelan tingkat.
- Template tidak memiliki filter yang diperlukan.
- Template tidak memenuhi tingkat keyakinan minimum untuk filter.
Saat mendeteksi pelanggaran, sistem akan menghasilkan temuan dengan tingkat keparahan tinggi di Security Command Center (jika Anda menggunakan paket layanan Premium atau Enterprise Security Command Center). Temuan ini menentukan setelan harga minimum yang dilanggar, template yang tidak mematuhi kebijakan, dan detail tentang pelanggaran tersebut.
Contoh berikut menunjukkan kolom sourceProperties temuan. Pelanggaran
ini, yang terkait dengan filter URI berbahaya, terjadi
karena setelan template untuk maliciousUriFilterSettings adalah
DISABLED, tetapi setelan minimum mengharuskannya menjadi ENABLED.
{ "filterConfig": { "raiSettings": { "raiFilters": [ { "filterType": "HATE_SPEECH", "confidenceLevel": { "floorSettings": "LOW_AND_ABOVE", "template": "MEDIUM_AND_ABOVE" } }, { "filterType": "HARASSMENT", "confidenceLevel": { "floorSettings": "MEDIUM_AND_ABOVE", "template": "HIGH" } } ] }, "piAndJailbreakFilterSettings": { "confidenceLevel": { "floorSettings": "LOW_AND_ABOVE", "template": "HIGH" } }, "maliciousUriFilterSettings": { "floorSettings": "ENABLED", "template": "DISABLED" }, "csamFilterSettings": { "confidenceLevel": { "floorSettings": "MEDIUM_AND_ABOVE", "template": "HIGH" } } } }
Langkah berikutnya
- Pelajari lebih lanjut Model Armor.
- Pelajari template Model Armor.
- Membersihkan perintah dan respons.
- Memecahkan masalah Model Armor.