Registros de auditoría de Contactos esenciales

Los Registros de auditoría de Cloud para Contactos esenciales te permiten realizar un seguimiento de las operaciones administrativas y de acceso a los datos en tus recursos para ayudarte a supervisar los cambios de acceso y configuración. Puedes consultar estos registros en el Explorador de registros y verificar qué métodos de la API de Contactos esenciales generan registros de auditoría de Cloud.

Para obtener más información sobre los Registros de auditoría de Cloud, consulta los siguientes documentos:

Nombre del servicio

Para ver los registros de auditoría de Contactos esenciales, haz lo siguiente:

  1. En la consola de Google Cloud , accede a la página Explorador de registros:

    Ve al Explorador de registros

  2. Copia y pega la siguiente consulta en el campo Consulta del Explorador de registros y, luego, haz clic en Ejecutar consulta.

        protoPayload.serviceName="essentialcontacts.googleapis.com"
      

Métodos por tipo de permiso

Cada permiso de IAM tiene una propiedad type, cuyo valor es un enum que puede ser uno de cuatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Cuando llamas a un método, Contactos esenciales 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.

Los métodos de API de la siguiente lista marcados con (LRO) son operaciones de larga duración (LRO). Por lo general, estos métodos generan dos entradas de registro de auditoría: una cuando empieza la operación y otra cuando finaliza. Para obtener más información, consulta Registros de auditoría para operaciones de larga duración.
Tipo de permiso Métodos
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

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 Contactos esenciales.

google.cloud.essentialcontacts.v1.EssentialContactsService

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

ComputeContacts

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1.EssentialContactsService.ComputeContacts"

CreateContact

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.create - DATA_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.essentialcontacts.v1.EssentialContactsService.CreateContact"

DeleteContact

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.delete - DATA_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.essentialcontacts.v1.EssentialContactsService.DeleteContact"

GetContact

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.get - 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.essentialcontacts.v1.EssentialContactsService.GetContact"

ListContacts

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1.EssentialContactsService.ListContacts"

SendTestMessage

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.send - DATA_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.essentialcontacts.v1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Método: google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.update - DATA_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.essentialcontacts.v1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

Los siguientes registros de auditoría están asociados con métodos que pertenecen a google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.

ComputeContacts

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"

CreateContact

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.create - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"

DeleteContact

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.delete - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"

GetContact

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.get - 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.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"

ListContacts

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"

SendTestMessage

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.send - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Método: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.update - DATA_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.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

Los siguientes registros de auditoría están asociados con métodos que pertenecen a google.cloud.essentialcontacts.v1beta1.EssentialContactsService.

ComputeContacts

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"

CreateContact

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.create - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"

DeleteContact

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.delete - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"

GetContact

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.get - 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.essentialcontacts.v1beta1.EssentialContactsService.GetContact"

ListContacts

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.list - 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.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"

SendTestMessage

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.send - DATA_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.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Método: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  • Tipo de registro de auditoría: acceso a los datos
  • Permisos:
    • essentialcontacts.contacts.update - DATA_WRITE
  • El método es una operación de larga duración o de transmisión: no.
  • Filtro para este método: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"

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:

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

Registros de auditoría de actividad del administrador para operaciones de escritura

Además de los registros de auditoría de acceso a los datos (DATA_WRITE), los siguientes métodos de escritura de google.cloud.essentialcontacts.v1.EssentialContactsService generan registros de auditoría de actividad del administrador (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

Los registros de auditoría de actividad del administrador están habilitados de forma predeterminada y no generan cargos por transferencia de Cloud Logging.

Si también habilitas los registros de auditoría de acceso a los datos (DATA_WRITE) para Contactos esenciales, llamar a estos cuatro métodos genera una entrada de registro de auditoría de actividad del administrador (cloudaudit.googleapis.com/activity) y una entrada de registro de auditoría de acceso a los datos (cloudaudit.googleapis.com/data_access). Si enrutas los registros de auditoría a los receptores de exportación o configuras alertas basadas en registros, filtra por nombre de registro o cuenta para ambas entradas de registro para evitar alertas duplicadas o un volumen de exportación inesperado.

Consultas de muestra

Puedes ejecutar la siguiente consulta de ejemplo en el Explorador de registros para ver los registros de auditoría de la actividad del administrador de las operaciones de escritura de Contactos esenciales:

Descripción de la consulta Expresión
Registros de auditoría de la actividad del administrador para las operaciones de escritura de Contactos esenciales
log_id("cloudaudit.googleapis.com/activity")
protoPayload.serviceName="essentialcontacts.googleapis.com"