Audit Model Armor et journalisation de la plate-forme

Ce document décrit la journalisation d'audit pour Model Armor.Les services Google Cloud génèrent des journaux d'audit qui enregistrent les activités d'administration et d'accès dans vos ressources Google Cloud . Pour en savoir plus sur Cloud Audit Logs, consultez les ressources suivantes :

Nom du service

Les journaux d'audit Model Armor utilisent le nom de service modelarmor.googleapis.com. Filtrez les résultats pour ce service : 

    protoPayload.serviceName="modelarmor.googleapis.com"

Méthodes par type d'autorisation

Chaque autorisation IAM possède une propriété type, dont la valeur est une énumération pouvant être l'une des quatre valeurs suivantes: ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Lorsque vous appelez une méthode, Model Armor génère un journal d'audit dont la catégorie dépend de la propriété type de l'autorisation requise pour exécuter la méthode. Les méthodes nécessitant une autorisation IAM avec la valeur de la propriété type de DATA_READ, DATA_WRITE ou ADMIN_READ génèrent des journaux d'audit pour l'accès aux données. Les méthodes nécessitant une autorisation IAM avec la valeur de propriété type de ADMIN_WRITE génèrent des journaux d'audit pour les activités d'administration.

Type d'autorisation Méthodes
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

Journaux d'audit d'interface API

Pour en savoir plus sur la manière dont les autorisations sont évaluées, pour chaque méthode, consultez la documentation sur la gestion de l'authentification et des accès pour Model Armor.

google.cloud.modelarmor.v1.ModelArmor

Les journaux d'audit suivants sont associés aux méthodes appartenant à google.cloud.modelarmor.v1.ModelArmor.

CreateTemplate

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.templates.create - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.CreateTemplate"

DeleteTemplate

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.templates.delete - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate"

GetFloorSetting

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.floorSettings.get - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting"

GetTemplate

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.GetTemplate
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.get - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetTemplate"

ListTemplates

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.ListTemplates
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.list - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.ListTemplates"

SanitizeModelResponse

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse"

SanitizeUserPrompt

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt"

UpdateFloorSetting

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.floorSettings.update - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting"

UpdateTemplate

  • Méthode : google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.templates.update - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate"

google.cloud.modelarmor.v1alpha.ModelArmor

Les journaux d'audit suivants sont associés aux méthodes appartenant à google.cloud.modelarmor.v1alpha.ModelArmor.

CreateTemplate

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.templates.create - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate"

DeleteTemplate

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.templates.delete - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate"

GetFloorSetting

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.floorSettings.get - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting"

GetTemplate

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.get - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate"

ListTemplates

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.list - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates"

SanitizeModelResponse

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse"

SanitizeUserPrompt

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt
  • Type de journal d'audit : Accès aux données
  • Autorisations :
    • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt"

UpdateFloorSetting

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.floorSettings.update - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting"

UpdateTemplate

  • Méthode : google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
  • Type de journal d'audit: Activité d'administration
  • Autorisations :
    • modelarmor.templates.update - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu: Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate"

Méthodes ne produisant pas de journaux d'audit

Une méthode peut ne pas produire de journaux d'audit pour une ou plusieurs des raisons suivantes :

  • Il s'agit d'une méthode à volume élevé impliquant des coûts significatifs de génération de journaux et de stockage.
  • Sa valeur d'audit est faible.
  • Un autre journal d'audit ou de plate-forme fournit déjà une couverture des méthodes.

Les méthodes suivantes ne génèrent pas de journaux d'audit :

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

Configuration de la journalisation

Vous pouvez configurer Model Armor pour consigner les opérations suivantes:

  • Créer, mettre à jour, lire et supprimer un modèle
  • Nettoyer la requête de l'utilisateur et la réponse du modèle
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 : valeur booléenne qui détermine si les opérations de création, de mise à jour, de lecture et de suppression de modèles doivent être enregistrées dans les journaux de la plate-forme.

  • log_sanitize_operations : valeur booléenne qui détermine si les opérations de nettoyage doivent être consignées dans les journaux de la plate-forme. Les journaux incluent la requête et la réponse, les résultats d'évaluation de Model Armor et des champs de métadonnées supplémentaires.

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet auquel appartient le modèle.
    • LOCATION : emplacement du modèle.
    • TEMPLATE_ID : ID du modèle.