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:
- 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
Para ver los registros de auditoría de Contactos esenciales, haz lo siguiente:
En la consola de Google Cloud , accede a la página Explorador de registros:
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.
| Tipo de permiso | Métodos |
|---|---|
DATA_READ |
google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContactsgoogle.cloud.essentialcontacts.v1.EssentialContactsService.GetContactgoogle.cloud.essentialcontacts.v1.EssentialContactsService.ListContactsgoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContactsgoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContactgoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContactsgoogle.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContactsgoogle.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContactgoogle.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts |
DATA_WRITE |
google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContactgoogle.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContactgoogle.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessagegoogle.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContactgoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContactgoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContactgoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessagegoogle.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContactgoogle.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContactgoogle.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContactgoogle.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessagegoogle.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_READessentialcontacts.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_READessentialcontacts.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.ResendVerificationgoogle.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.CreateContactgoogle.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContactgoogle.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContactgoogle.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" |