Journaux d'audit des contacts essentiels

Cloud Audit Logs pour Essential Contacts vous permet de suivre les opérations d'administration et d'accès aux données sur vos ressources afin de surveiller les accès et les modifications de configuration. Vous pouvez interroger ces journaux dans l'explorateur de journaux et vérifier quelles méthodes de l'API Essential Contacts génèrent des Cloud Audit Logs.

Pour en savoir plus sur Cloud Audit Logs, consultez les documents suivants :

Nom du service

Pour afficher les journaux d'audit de Contacts essentiels, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Copiez et collez la requête suivante dans le champ Requête de l'explorateur de journaux, puis cliquez sur Exécuter la requête.

        protoPayload.serviceName="essentialcontacts.googleapis.com"

Méthodes par type d'autorisation

Chaque autorisation IAM possède une propriété type, dont la valeur est une énumération. Il peut s'agir de l'une des quatre valeurs suivantes : ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Lorsque vous appelez une méthode, Contacts essentiels 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 des 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.

Les méthodes d'API de la liste suivante marquées (LRO) sont des opérations de longue durée (LRO, Long-running operations). Ces méthodes génèrent généralement deux entrées de journal d'audit : une au début de l'opération et une autre à la fin. Pour en savoir plus, consultez Journaux d'audit pour les opérations de longue durée.
Type d'autorisation Méthodes
DATA_READ google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
DATA_WRITE google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact

Journaux d'audit d'interface API

Pour connaître les autorisations évaluées et la procédure d'évaluation utilisée pour chaque méthode, consultez la documentation Identity and Access Management pour Essential Contacts.

google.cloud.essentialcontacts.v1.EssentialContactsService

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

ComputeContacts

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1.EssentialContactsService.ComputeContacts"

CreateContact

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.create - DATA_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.essentialcontacts.v1.EssentialContactsService.CreateContact"

DeleteContact

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.delete - DATA_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.essentialcontacts.v1.EssentialContactsService.DeleteContact"

GetContact

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.get - 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.essentialcontacts.v1.EssentialContactsService.GetContact"

ListContacts

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1.EssentialContactsService.ListContacts"

SendTestMessage

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.send - DATA_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.essentialcontacts.v1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Méthode : google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.update - DATA_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.essentialcontacts.v1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

Les journaux d'audit suivants sont associés aux méthodes appartenant à google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.

ComputeContacts

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"

CreateContact

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.create - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"

DeleteContact

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.delete - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"

GetContact

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.get - 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.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"

ListContacts

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"

SendTestMessage

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.send - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Méthode : google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.update - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

Les journaux d'audit suivants sont associés aux méthodes appartenant à google.cloud.essentialcontacts.v1beta1.EssentialContactsService.

ComputeContacts

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"

CreateContact

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.create - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"

DeleteContact

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.delete - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"

GetContact

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.get - 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.essentialcontacts.v1beta1.EssentialContactsService.GetContact"

ListContacts

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"

SendTestMessage

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.send - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Méthode : google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • essentialcontacts.contacts.update - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"

Méthodes ne produisant pas de journaux d'audit

Il est possible qu'une méthode ne produise pas 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 couvre déjà cette méthode.

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

  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ResendVerification
  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.VerifyContact

Journaux d'audit des activités d'administration pour les opérations d'écriture

En plus des journaux d'audit des accès aux données (DATA_WRITE), les méthodes d'écriture google.cloud.essentialcontacts.v1.EssentialContactsService suivantes génèrent des journaux d'audit des activités d'administration (ADMIN_WRITE) :

  • google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage

Les journaux d'audit des activités d'administration sont activés par défaut et n'entraînent pas de frais d'ingestion Cloud Logging.

Si vous activez également les journaux d'audit des accès aux données (DATA_WRITE) pour Essential Contacts, l'appel de ces quatre méthodes génère à la fois une entrée de journal d'audit des activités d'administration (cloudaudit.googleapis.com/activity) et une entrée de journal d'audit des accès aux données (cloudaudit.googleapis.com/data_access). Si vous acheminez les journaux d'audit vers des récepteurs d'exportation ou si vous configurez des alertes basées sur les journaux, filtrez par nom de journal ou tenez compte des deux entrées de journal pour éviter les alertes en double ou un volume d'exportation inattendu.

Exemples de requêtes

Vous pouvez exécuter l'exemple de requête suivant dans l'explorateur de journaux pour afficher les journaux d'audit des activités d'administration pour les opérations d'écriture de Contacts essentiels :

Description de la requête Expression
Journaux d'audit des activités d'administration pour les opérations d'écriture de Contacts essentiels 
log_id("cloudaudit.googleapis.com/activity")
protoPayload.serviceName="essentialcontacts.googleapis.com"