Model Armor 감사 및 플랫폼 로깅

이 문서에서는 Model Armor의 감사 로깅을 설명합니다. Google Cloud 서비스는 Google Cloud 리소스 내의 관리 및 액세스 활동을 기록하는 감사 로그를 생성합니다. Cloud 감사 로그에 대한 자세한 내용은 다음을 참조하세요.

• 감사 로그 유형
• 감사 로그 항목 구조
• 감사 로그 저장 및 라우팅
• Cloud Logging 가격 책정 요약
• 데이터 액세스 감사 로그 사용 설정

서비스 이름

Model Armor 감사 로그는 modelarmor.googleapis.com 서비스 이름을 사용합니다. 이 서비스에 대한 필터:

    protoPayload.serviceName="modelarmor.googleapis.com"
  

권한 유형별 메서드

각 IAM 권한에는 type 속성이 포함되며 그 값은 네 가지 값(ADMIN_READ, ADMIN_WRITE, DATA_READ, DATA_WRITE) 중 하나일 수 있는 열거형입니다. 메서드를 호출하면 Model Armor에서 메서드를 실행하는 데 필요한 권한의 type 속성에 따라 카테고리가 달라지는 감사 로그를 생성합니다. DATA_READ, DATA_WRITE, ADMIN_READ의 type 속성 값을 가진 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 인터페이스 감사 로그

메서드별 평가 방법과 평가 대상 권한에 대한 자세한 내용은 Model Armor의 Identity and Access Management 문서를 참고하세요.

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

로깅 구성

다음 작업을 로깅하도록 모델 아머를 구성할 수 있습니다.

• 템플릿 생성, 업데이트, 읽기, 삭제
• 사용자 프롬프트 및 모델 응답 정리

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입니다.