Registro de auditoría y plataforma de Model Armor

En este documento, se describen los registros de auditoría de Model Armor.Los servicios de Google Cloud generan registros de auditoría que registran las actividades administrativas y de acceso dentro de tus Google Cloud recursos. Para obtener más información sobre los Registros de auditoría de Cloud, consulta los siguientes recursos:

• Tipos de registros de auditoría
• Estructura de entradas de registro de auditoría
• Almacena y enruta registros de auditoría
• Resumen de precios de Cloud Logging
• Habilita los registros de auditoría de acceso a los datos

Nombre del servicio

Los registros de auditoría de Model Armor usan el nombre de servicio modelarmor.googleapis.com. Filtra este servicio:

    protoPayload.serviceName="modelarmor.googleapis.com"
  

Métodos por tipo de permiso

Cada permiso de IAM tiene una propiedad type, cuyo valor es una enumeración que puede ser uno de cuatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Cuando llamas a un método, Model Armor genera un registro de auditoría cuya categoría depende de la propiedad type del permiso necesario para realizar el método. Los métodos que requieren un permiso de IAM con el valor de propiedad type de DATA_READ, DATA_WRITE o ADMIN_READ generan registros de auditoría de acceso a los datos. Los métodos que requieren un permiso de IAM con el valor de propiedad type de ADMIN_WRITE generan registros de auditoría de actividad del administrador.

Tipo de permiso	Métodos
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

Registros de auditoría de la interfaz de la API

Si quieres obtener información sobre cómo y qué permisos se evalúan para cada método, consulta la documentación de Identity and Access Management de Model Armor.

google.cloud.modelarmor.v1.ModelArmor

Los siguientes registros de auditoría están asociados con métodos que pertenecen a google.cloud.modelarmor.v1.ModelArmor.

CreateTemplate

• Método: google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.templates.create - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.CreateTemplate"
  

DeleteTemplate

• Método: google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.templates.delete - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate"
  

GetFloorSetting

• Método: google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.floorSettings.get - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting"
  

GetTemplate

• Método: google.cloud.modelarmor.v1.ModelArmor.GetTemplate
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.get - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetTemplate"
  

ListTemplates

• Método: google.cloud.modelarmor.v1.ModelArmor.ListTemplates
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.list - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.ListTemplates"
  

SanitizeModelResponse

• Método: google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse"
  

SanitizeUserPrompt

• Método: google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt"
  

UpdateFloorSetting

• Método: google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.floorSettings.update - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting"
  

UpdateTemplate

• Método: google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.templates.update - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate"
  

google.cloud.modelarmor.v1alpha.ModelArmor

Los siguientes registros de auditoría están asociados con métodos que pertenecen a google.cloud.modelarmor.v1alpha.ModelArmor.

CreateTemplate

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.templates.create - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate"
  

DeleteTemplate

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.templates.delete - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate"
  

GetFloorSetting

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.floorSettings.get - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting"
  

GetTemplate

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.get - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate"
  

ListTemplates

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.list - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates"
  

SanitizeModelResponse

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse"
  

SanitizeUserPrompt

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt"
  

UpdateFloorSetting

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.floorSettings.update - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting"
  

UpdateTemplate

• Método: google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • modelarmor.templates.update - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate"
  

Métodos que no producen registros de auditoría

Es posible que un método no produzca registros de auditoría por uno o más de los siguientes motivos:

• Es un método de gran volumen que implica costos significativos de generación y almacenamiento de registros.
• Tiene un valor de auditoría bajo.
• Otro registro de auditoría o de plataforma ya proporciona cobertura del método.

Los siguientes métodos no producen registros de auditoría:

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

Configuración de registros

Puedes configurar Model Armor para registrar las siguientes operaciones:

• Cómo crear, actualizar, leer y borrar plantillas
• Cómo limpiar la instrucción del usuario y la respuesta del modelo

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 : Es un valor booleano que determina si las operaciones para crear, actualizar, leer y borrar plantillas se deben registrar en los registros de la plataforma.

• log_sanitize_operations : Es un valor booleano que determina si las operaciones de limpieza se deben registrar en los registros de la plataforma. Los registros incluyen la instrucción y la respuesta, los resultados de la evaluación de Model Armor y campos de metadatos adicionales.

  Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto al que pertenece la plantilla.
  • LOCATION: Es la ubicación de la plantilla.
  • TEMPLATE_ID: El ID de la plantilla.