Audit Armor model dan logging platform

Dokumen ini menjelaskan logging audit untuk Model Armor.Layanan Google Cloud membuat log audit yang mencatat aktivitas administratif dan akses dalam resource Google Cloud Anda. Untuk informasi selengkapnya tentang Cloud Audit Logs, lihat referensi berikut:

Nama layanan

Log audit Model Armor menggunakan nama layanan modelarmor.googleapis.com. Filter untuk layanan ini: 

    protoPayload.serviceName="modelarmor.googleapis.com"

Metode menurut jenis izin

Setiap izin IAM memiliki properti type, yang nilainya adalah enum yang dapat berupa salah satu dari empat nilai: ADMIN_READ, ADMIN_WRITE, DATA_READ, atau DATA_WRITE. Saat Anda memanggil metode, Model Armor akan membuat log audit yang kategorinya bergantung pada properti type izin yang diperlukan untuk menjalankan metode. Metode yang memerlukan izin IAM dengan nilai properti type DATA_READ, DATA_WRITE, atau ADMIN_READ akan menghasilkan log audit Akses Data. Metode yang memerlukan izin IAM dengan nilai properti type dari ADMIN_WRITE akan membuat log audit Aktivitas Admin.

Jenis izin Metode
ADMIN_READ google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
google.cloud.modelarmor.v1.ModelArmor.GetTemplate
google.cloud.modelarmor.v1.ModelArmor.ListTemplates
google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
ADMIN_WRITE google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
DATA_READ google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt

Log audit antarmuka API

Untuk mengetahui informasi tentang cara dan izin mana yang dievaluasi untuk setiap metode, lihat dokumentasi Identity and Access Management untuk Model Armor.

google.cloud.modelarmor.v1.ModelArmor

Log audit berikut dikaitkan dengan metode yang termasuk dalam google.cloud.modelarmor.v1.ModelArmor.

CreateTemplate

  • Metode: google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.templates.create - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.CreateTemplate"

DeleteTemplate

  • Metode: google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.templates.delete - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate"

GetFloorSetting

  • Metode: google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.floorSettings.get - ADMIN_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting"

GetTemplate

  • Metode: google.cloud.modelarmor.v1.ModelArmor.GetTemplate
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.get - ADMIN_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetTemplate"

ListTemplates

  • Metode: google.cloud.modelarmor.v1.ModelArmor.ListTemplates
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.list - ADMIN_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.ListTemplates"

SanitizeModelResponse

  • Metode: google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse"

SanitizeUserPrompt

  • Metode: google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt"

UpdateFloorSetting

  • Metode: google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.floorSettings.update - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting"

UpdateTemplate

  • Metode: google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.templates.update - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate"

google.cloud.modelarmor.v1alpha.ModelArmor

Log audit berikut dikaitkan dengan metode yang termasuk dalam google.cloud.modelarmor.v1alpha.ModelArmor.

CreateTemplate

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.templates.create - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate"

DeleteTemplate

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.templates.delete - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate"

GetFloorSetting

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.floorSettings.get - ADMIN_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting"

GetTemplate

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.get - ADMIN_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate"

ListTemplates

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.list - ADMIN_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates"

SanitizeModelResponse

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse"

SanitizeUserPrompt

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt
  • Jenis log audit: Akses data
  • Izin:
    • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt"

UpdateFloorSetting

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.floorSettings.update - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting"

UpdateTemplate

  • Metode: google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
  • Jenis log audit: Aktivitas admin
  • Izin:
    • modelarmor.templates.update - ADMIN_WRITE
  • Metode adalah operasi streaming atau yang berjalan lama: Tidak.
  • Filter untuk metode ini: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate"

Metode yang tidak menghasilkan log audit

Metode mungkin tidak menghasilkan log audit karena satu atau beberapa alasan berikut:

  • Ini adalah metode bervolume tinggi yang melibatkan biaya penyimpanan dan pembuatan log yang signifikan.
  • Nilai auditnya rendah.
  • Audit atau log platform lain sudah menyediakan cakupan metode.

Metode berikut tidak menghasilkan log audit:

  • envoy.service.ext_proc.v3.ExternalProcessor.Process
  • google.cloud.location.Locations.GetLocation
  • google.cloud.location.Locations.ListLocations

Konfigurasi logging

Anda dapat mengonfigurasi Model Armor untuk mencatat operasi berikut ke dalam log:

  • Membuat, memperbarui, membaca, dan menghapus template
  • Membersihkan perintah pengguna dan respons model
curl -X POST \
  -d "{filter_config: {}, 'template_metadata': { 'log_template_operations': 'true', 'log_sanitize_operations': 'true'} }" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"
  • log_template_operations : Nilai Boolean yang menentukan apakah operasi untuk membuat, memperbarui, membaca, dan menghapus template harus dicatat dalam log platform.

  • log_sanitize_operations : Nilai Boolean yang menentukan apakah operasi pembersihan harus dicatat dalam log platform. Log menyertakan perintah dan respons, hasil evaluasi Model Armor, dan kolom metadata tambahan.

    Ganti kode berikut:

    • PROJECT_ID - ID project tempat template berada.
    • LOCATION - lokasi template.
    • TEMPLATE_ID - ID template.