Cloud Audit Logs con Cloud Storage

En esta página, se proporciona información adicional para el uso de Registros de auditoría de Cloud con Cloud Storage. Usa Registros de auditoría de Cloud si quieres generar registros para las operaciones de API que se realizan en Cloud Storage.

Descripción general

Google Cloud escriben registros de auditoría para ayudarte a responder las preguntas “¿Quién hizo qué, dónde y cuándo?” dentro de tus recursos de Google Cloud . También puedes adjuntar información personalizada a los registros de auditoría para obtener información más detallada sobre cómo se accede a tus recursos.

Tus proyectos de Google Cloud contienen solo los registros de auditoría de los recursos que están directamente dentro del proyecto de Google Cloud . Otros recursos de Google Cloud , como las carpetas, organizaciones y cuentas de facturación, contienen los registros de auditoría correspondientes a la entidad.

Consulta la descripción general de los Registros de auditoría de Cloud para conocer más al respecto. Para comprender mejor el formato del registro de auditoría, consulta Información de los registros de auditoría.

Registros de auditoría disponibles

Los siguientes tipos de registros de auditoría están disponibles para Cloud Storage:

• Registros de auditoría de actividad del administrador: Entradas para operaciones que realizan las siguientes acciones:

  • modificar el acceso a los recursos de Cloud Storage
  • restaurar o reubicar buckets
  • Crear, borrar o modificar buckets, carpetas administradas o configuraciones de informes de inventario
  • Crear, pausar, reanudar, inhabilitar, actualizar, enumerar u obtener cachés de Anywhere Cache

• Registros de auditoría de acceso a los datos: entradas para operaciones a las que no se les realiza un seguimiento en los registros de auditoría de actividad del administrador. Hay distintos subtipos de registros de auditoría de acceso a los datos:

  • ADMIN_READ: entradas para operaciones que leen configuraciones de acceso, leen metadatos de buckets o enumeran buckets dentro de un proyecto.

  • DATA_READ: entradas para operaciones que leen o enumeran recursos de Cloud Storage que no sean buckets.

  • DATA_WRITE: Entradas para operaciones que crean, modifican, borran o restablecen objetos o que crean, modifican o borran cargas multiparte de la API de XML o que crean, borran o cambian el nombre de carpetas.

  Para recibir registros de auditoría de acceso a los datos, debes habilitarlos de forma explícita.

• Registros de auditoría de eventos del sistema: Entradas para operaciones de Google Cloud que modifican la configuración de los recursos de Cloud Storage. Los generan los sistemas de Google Cloud y no se basan en la acción del usuario.

Además de los registros de auditoría de Cloud Storage, los registros de auditoría de Cloud pueden crear registros de auditoría para Storage Insights. Los registros de auditoría de Storage Insights se generan cada vez que se crean, se actualizan y se recuperan las configuraciones de informes de inventario y cuando se recuperan los informes de inventario.

Para obtener descripciones más completas de los tipos de registros de auditoría, consulta Tipos de registros de auditoría.

Operaciones auditadas

En la siguiente tabla, se resumen las operaciones de Cloud Storage que corresponden a cada tipo de registro de auditoría:

¹ Los registros de auditoría de actividad del administrador no se generan si las LCA se configuran de forma inicial en la creación del objeto. Además, si una LCA de objeto se configura como pública, los registros de auditoría no se generan para lecturas o escrituras en ese objeto ni su LCA.

² Estas operaciones implican lectura y escritura de datos. Como resultado, cada una de estas operaciones genera dos entradas de registro.

³ Es posible que la reubicación del bucket no comience inmediatamente después de la solicitud inicial. El registro de eventos del sistema se escribe cuando el proceso comienza.

Restricciones

Las siguientes restricciones se aplican a Registros de auditoría de Cloud con Cloud Storage:

• Registros de auditoría de Cloud no realiza un seguimiento del acceso a objetos públicos.
• Registros de auditoría de Cloud no realiza un seguimiento de los cambios que realizan las funciones Administración del ciclo de vida de los objetos o Autoclass.
• Los registros de acceso a los datos generados a partir de descargas autenticadas del navegador tienen sus campos principalEmail y callerIp ocultos cuando la descarga se produce fuera de la consola de Google Cloud .

Si necesitas capacidades de registro en uno de estos casos, considera usar registros de uso de Cloud Storage.

Formato del registro de auditoría

Las entradas del registro de auditoría incluyen los siguientes componentes:

• La entrada de registro en sí, que es un objeto LogEntry. Los campos útiles incluyen los siguientes:

  • El campo logName contiene el ID del recurso y el tipo de registro de auditoría.
  • El campo resource contiene el objetivo de la operación auditada.
  • El campo timestamp contiene la hora de la operación auditada.
  • El campo protoPayload contiene la información auditada.

• Los datos de registro de auditoría, que son un objeto AuditLog alojado en el campo protoPayload de la entrada de registro.

  • Dentro del campo protoPayload, el campo metadata incluye información específica de Cloud Storage. Por ejemplo, una solicitud de objeto de lectura incluye un campo requested_bytes en el campo metadata de su registro de auditoría. Cuando se llama a la solicitud con un encabezado range, el valor del rango se propaga en el campo metadata; de lo contrario, el campo requested_bytes en los metadatos se propaga con el tamaño total del objeto.

  • Dentro de protoPayload, se incluye información adicional de auditoría específica de Cloud Storage en los campos de solicitud y respuesta cuando se aplica el modo de registro de auditoría detallado. Sin embargo, no es necesario que actives el registro de auditoría detallado para agregar tu propia información personalizada a los registros de auditoría.

Para obtener información de otros campos en estos objetos, además de cómo interpretarlos, consulta Información de los registros de auditoría.

Nombre del registro

Los nombres de registro de los Registros de auditoría de Cloud incluyen identificadores de recursos que indican el proyectoGoogle Cloud o cualquier otra Google Cloud entidad que posee los registros de auditoría, y si el registro contiene datos de registro de auditoría de acceso a los datos o de actividad del administrador.

A continuación, se muestran los nombres de los registros de auditoría, incluidas las variables para los identificadores de recursos:

   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access

   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Factivity
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fdata_access

   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Factivity
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fdata_access

   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Factivity
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fdata_access

Nombre del servicio

Los registros de auditoría de Cloud Storage usan el nombre de servicio storage.googleapis.com.

Los registros de auditoría Storage Insights usan el nombre de servicio storageinsights.googleapis.com.

Para obtener una lista de los nombres de los servicios de la API de Cloud Logging y su tipo de recurso supervisado correspondiente, consulta Asigna servicios a recursos.

Tipos de recursos

Los registros de auditoría de Cloud Storage usan el tipo de recurso gcs_bucket.

Para obtener una lista de todos los tipos de recursos supervisados de Cloud Logging y la información descriptiva, consulta Tipos de recursos supervisados.

Habilita el registro de auditoría

Los registros de auditoría de actividad del administrador siempre están habilitados; no puedes inhabilitarlos.

Los registros de auditoría de acceso a los datos están inhabilitados de forma predeterminada y no se escriben, a menos que se habiliten de manera explícita.

Si deseas obtener más información para habilitar algunos o todos tus registros de auditoría de acceso a los datos, consulta Configura registros de auditoría de acceso a los datos.

Permisos y funciones

Los permisos y los roles de IAM determinan tu capacidad para acceder a los datos de registros de auditoría en los recursos de Google Cloud .

Cuando decidas qué roles y permisos específicos de Logging se aplican a tu caso de uso, considera lo siguiente:

• El rol visor de registros (roles/logging.viewer) te otorga acceso de solo lectura a los registros de auditoría de la actividad del administrador, la política denegada y los eventos del sistema. Si solo tienes esta función, no podrás ver los registros de auditoría de acceso a los datos que se encuentran en los buckets _Required y _Default.

• La función Visor de registros privados ((roles/logging.privateLogViewer) incluye los permisos que contiene roles/logging.viewer, además de la capacidad de leer registros de auditoría de acceso a los datos de los buckets _Required y _Default.

  Ten en cuenta que si estos registros privados se almacenan en buckets definidos por el usuario, cualquier usuario que tenga permisos para leer registros en esos buckets puede leer los registros privados. Para obtener más información de los buckets de registros, consulta Descripción general del enrutamiento y el almacenamiento.

Para obtener más información de los permisos y los roles de IAM que se aplican a los datos de registros de auditoría, consulta Control de acceso con IAM.

Visualiza los registros

Puedes consultar todos los registros de auditoría o puedes consultar los registros por su nombre de registro de auditoría. El nombre del registro de auditoría incluye el identificador de recursos del proyecto, la carpeta, la cuenta de facturación o la organización de Google Cloud cuya información de registro de auditoría deseas ver. Tus consultas pueden especificar campos LogEntry indexados. Para obtener más información sobre cómo consultar tus registros, consulta Compila consultas en el Explorador de registros.

El Explorador de registros te permite ver y filtrar entradas de registro individuales. Si quieres usar SQL para analizar grupos de entradas de registro, usa la página Análisis de registros. Para obtener más información, consulte:

• Consulta y visualiza registros en Análisis de registros.
• Consultas de muestra para estadísticas de seguridad.
• Resultados de la consulta de gráficos

La mayoría de los registros de auditoría se pueden ver en Cloud Logging a través de laGoogle Cloud consola, Google Cloud CLI o la API de Logging. Sin embargo, para los registros de auditoría relacionados con la facturación, solo puedes usar Google Cloud CLI o la API de Logging.

gcloud logging read "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com" \
    --project=PROJECT_ID

gcloud logging read "logName : folders/FOLDER_ID/logs/cloudaudit.googleapis.com" \
    --folder=FOLDER_ID

gcloud logging read "logName : organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com" \
    --organization=ORGANIZATION_ID

gcloud logging read "logName : billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com" \
    --billing-account=BILLING_ACCOUNT_ID

Agrega información personalizada a los registros de auditoría

Puedes adjuntar información personalizada a las solicitudes para que se incluya en los registros de auditoría si incluyes el encabezado x-goog-custom-audit-KEY: VALUE en tu solicitud. Además, las solicitudes a la API de XML admiten el uso de un parámetro de consulta x-goog-custom-audit-KEY=VALUE. Se agrega información personalizada al campo metadata de protoPayload en la entrada de registro de auditoría.

Cuando agregues información de auditoría personalizada, ten en cuenta las siguientes consideraciones:

• Cada KEY, con la inclusión del prefijo x-goog-custom-audit-, puede contener hasta 64 caracteres, mientras que cada VALUE puede contener hasta 1,200 caracteres.

• Cada solicitud puede contener hasta 4 entradas de encabezado o parámetros combinadas.

Ejemplos de entradas de encabezado

En la siguiente lista, se muestran ejemplos de pares clave-valor que puedes incluir en las entradas de encabezado:

• x-goog-custom-audit-job: test-job-id-here
• x-goog-custom-audit-user: user ID test 1
• x-goog-custom-audit-internal-user-id: MATR2022-11
• x-goog-custom-audit-tracking-ticket: TT/1516512851
• x-goog-custom-audit-justification: Removed customer identity record at customer request
• x-goog-custom-audit-customer-id: USCU12315154

Solicitudes de ejemplo

gcloud storage hash gs://example_bucket/example_object.jpeg --additional-headers=x-goog-custom-audit-job="job name",x-goog-custom-audit-user="test user"

curl -X GET "https://storage.googleapis.com/storage/v1/b/example_bucket/o/example_object" \
-H "Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg" \
-H "x-goog-custom-audit-job: job name" \
-H "x-goog-custom-audit-user: test user"

curl -X GET "https://storage.googleapis.com/example_bucket/example_object" \
-H "Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg" \
-H "x-goog-custom-audit-job: job name" \
-H "x-goog-custom-audit-user: test user"

curl -X GET 'storage.googleapis.com/example_bucket?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central1%2Fstorage%2Fgoog4_request&X-Goog-Date=20181026T181309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host,x-goog-custom-audit-job,x-goog-custom-audit-user&X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7' \
-H "x-goog-custom-audit-job: job name" \
-H "x-goog-custom-audit-user: test user"

gcloud storage sign-url gs://example_bucket/example_object.jpeg --private-key-file=example-key.json --duration=10m --headers=x-goog-custom-audit-job:"job name",x-goog-custom-audit-user="test user"

curl -X GET 'storage.googleapis.com/example_bucket?X-Goog-Custom-Audit-Key=Value&X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central1%2Fstorage%2Fgoog4_request&X-Goog-Date=20181026T181309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host&X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7'

gcloud storage sign-url gs://example_bucket/example_object.jpeg --private-key-file=example-key.json --duration=10m --query-params=x-goog-custom-audit-job=job_name,x-goog-custom-audit-user=test_user

Ejemplo de una entrada de registro

protoPayload: {
  @type: "type.googleapis.com/google.cloud.audit.Auditlog",
  ...
  metadata: {
    audit_context: {
      app_context: "EXTERNAL",
      audit_info: {
        x-goog-custom-audit-job: "job name",
        x-goog-custom-audit-user: "test user"
      }
    }
  }
}

Para obtener más información de los campos incluidos en el objeto protoPayload con el tipo type.googleapis.com/google.cloud.audit.Auditlog, consulta la documentación de referencia de AuditLog.

Enruta registros de auditoría

Puedes enrutar registros de auditoría a destinos compatibles de la misma manera en la que enrutas otros tipos de registros. Estos son algunos de los motivos por los que es posible que quieras enrutar tus registros de auditoría:

• Para mantener los registros de auditoría por un período más extenso o usar capacidades de búsqueda más potentes, puedes enrutar copias de tus registros de auditoría a Cloud Storage, BigQuery o Pub/Sub. Puedes enrutar a otras aplicaciones, otros repositorios y a terceros a través de Pub/Sub.
• Para administrar los registros de auditoría en toda la organización, puedes crear receptores agregados que puedan enrutar registros desde cualquier proyecto Google Cloud de la organización o desde todos los proyectos.
• Si tus registros de auditoría de acceso a los datos habilitados hacen que tusGoogle Cloud proyectos superen la asignación gratuita, puedes crear receptores que excluyan los registros de auditoría de acceso a los datos de Logging.

Si deseas obtener instrucciones para enrutar los registros, consulta Configura y administra receptores.

Precios

Para obtener información sobre los precios de Cloud Logging, consulta Precios de observabilidad de Google Cloud: Cloud Logging.