Model Armor の監査とプラットフォームのロギング

このドキュメントでは、Model Armor の監査ロギングについて説明します。 Google Cloud サービスは、 Google Cloud リソース内の管理アクティビティとアクセス アクティビティを記録する監査ログを生成します。Cloud Audit Logs の詳細については、以下をご覧ください。

サービス名

Model Armor の監査ログでは、サービス名 modelarmor.googleapis.com が使用されます。このサービスでフィルタ:

    protoPayload.serviceName="modelarmor.googleapis.com"

メソッド（権限タイプ別）

各 IAM 権限には type プロパティがあります。このプロパティの値は列挙型で、ADMIN_READ、ADMIN_WRITE、DATA_READ、DATA_WRITE のいずれかになります。メソッドを呼び出すと、Model Armor は、カテゴリがメソッドの実行に必要な権限の type プロパティに依存する監査ログを生成します。type プロパティ値が DATA_READ、DATA_WRITE、または ADMIN_READ の IAM 権限を必要とするメソッドは、データアクセス監査ログを生成します。type プロパティ値が ADMIN_WRITE の IAM 権限を必要とするメソッドは、管理アクティビティ監査ログを生成します。

権限タイプ メソッド
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

API インターフェースの監査ログ

各メソッドで評価される権限と評価方法については、Identity and Access Management のドキュメントで Model Armor の情報をご覧ください。

google.cloud.modelarmor.v1.ModelArmor

次の監査ログは、google.cloud.modelarmor.v1.ModelArmor に属するメソッドに関連付けられています。

CreateTemplate

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.templates.create - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.CreateTemplate"

DeleteTemplate

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.templates.delete - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate"

GetFloorSetting

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.floorSettings.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting"

GetTemplate

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.GetTemplate
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetTemplate"

ListTemplates

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.ListTemplates
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.ListTemplates"

SanitizeModelResponse

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse"

SanitizeUserPrompt

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt"

UpdateFloorSetting

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.floorSettings.update - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting"

UpdateTemplate

  • メソッド: google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.templates.update - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate"

google.cloud.modelarmor.v1alpha.ModelArmor

次の監査ログは、google.cloud.modelarmor.v1alpha.ModelArmor に属するメソッドに関連付けられています。

CreateTemplate

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.templates.create - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate"

DeleteTemplate

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.templates.delete - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate"

GetFloorSetting

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.floorSettings.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting"

GetTemplate

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate"

ListTemplates

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates"

SanitizeModelResponse

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse"

SanitizeUserPrompt

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt
  • 監査ログのタイプ: データアクセス
  • 権限:
    • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt"

UpdateFloorSetting

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.floorSettings.update - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting"

UpdateTemplate

  • メソッド: google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • modelarmor.templates.update - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate"

監査ログを生成しないメソッド

メソッドが監査ログを生成しない理由は、次のいずれかの可能性があります。

  • 著しい量のログ生成とストレージの費用を要する大量メソッドである。
  • 監査値が低い。
  • 別の監査ログまたはプラットフォーム ログでメソッド カバレッジがすでに提供されている。

次のメソッドは監査ログを生成しません。

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

ロギング構成

Model Armor を構成して、次のオペレーションをログに記録できます。

  • テンプレートの作成、更新、読み取り、削除
  • ユーザー プロンプトとモデルのレスポンスをサニタイズする
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 : テンプレートの作成、更新、読み取り、削除のオペレーションをプラットフォーム ログに記録するかどうかを決定するブール値。

  • log_sanitize_operations : サニタイズ オペレーションをプラットフォーム ログに記録するかどうかを決定するブール値。ログには、プロンプトとレスポンス、Model Armor の評価結果、追加のメタデータ フィールドが含まれます。

    以下を置き換えます。

    • PROJECT_ID - テンプレートが属するプロジェクトの ID。
    • LOCATION - テンプレートの場所。
    • TEMPLATE_ID - テンプレートの ID。