CloudTrail contenido del registro - AWS CloudTrail
Campos de registro de eventos de InsightsEjemplo de sharedEventID

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CloudTrail contenido del registro

El cuerpo del registro contiene campos que le ayudan a determinar la acción solicitada, así como cuándo y dónde se realizó la solicitud. Cuando el valor de Opcional es Verdadero, el campo solo está presente cuando se aplica al servicio, la API o el tipo de evento. Un valor Opcional de False (Falso) significa que el campo siempre está presente o que su presencia no depende del servicio, la API o el tipo de evento. Un ejemplo es .responseElements, que está presente en los eventos de acciones que realizan cambios (acciones de creación, actualización o eliminación).

eventTime

La fecha y la hora en que se completó la solicitud, en hora universal coordinada (UTC). La marca temporal de un evento proviene del host local que proporciona el punto de enlace de API de servicio en el que se realizó la llamada a la API. Por ejemplo, un evento de CreateBucket API que se ejecute en la región EE.UU. Oeste (Oregón) obtendría su marca horaria a partir de la hora de un AWS host que ejecute el punto de conexión Amazon S3,s3.us-west-2.amazonaws.com. En general, AWS los servicios utilizan el Network Time Protocol (NTP) para sincronizar los relojes del sistema.

Desde: 1.0

Opcional: Falso

eventVersion

La versión del formato del evento de registro. La versión actual es la 1.11.

El eventVersion valor es una versión principal y una secundaria del formulariomajor_version. minor_version. Por ejemplo, puede tener un valor eventVersion de 1.10, donde 1 es la versión principal y 10 es la versión secundaria.

CloudTrail incrementa la versión principal si se realiza un cambio en la estructura del evento que no sea compatible con versiones anteriores. Esto incluye eliminar un campo JSON que ya existe o cambiar la forma en que se representa el contenido de un campo (por ejemplo, un formato de fecha). CloudTrail incrementa la versión secundaria si un cambio añade nuevos campos a la estructura del evento. Esto puede ocurrir si se proporciona información nueva para algunos o todos los eventos existentes o si la información nueva solo se proporciona para los tipos de eventos nuevos. Las aplicaciones deben ignorar los campos nuevos para mantener la compatibilidad con versiones secundarias de la estructura de eventos.

Si CloudTrail introduce nuevos tipos de eventos, pero la estructura del evento no cambia por lo demás, la versión del evento no cambia.

Para asegurarse de que las aplicaciones pueden analizar la estructura de eventos, le recomendamos que haga una comparación de igualdad con el número de la versión principal. Para asegurarte de que existen los campos esperados por la aplicación, también te recomendamos que realices una greater-than-or-equal comparación entre valores en la versión secundaria. No hay ceros a la izquierda en la versión secundaria. Puede interpretar ambos números major_version y minor_version como números y realizar operaciones de comparación.

Desde: 1.0

Opcional: Falso

userIdentity

Información sobre la identidad de IAM que hizo una solicitud. Para obtener más información, consulte CloudTrail userIdentity elemento.

Desde: 1.0

Opcional: Falso

eventSource

El servicio de para el que se realizó la solicitud. Este nombre suele ser una forma abreviada del nombre del servicio sin espacios más .amazonaws.com. Por ejemplo:

  • AWS CloudFormation escloudformation.amazonaws.com.

  • Amazon EC2 lo esec2.amazonaws.com.

  • Amazon Simple Workflow Service es swf.amazonaws.com.

Esta convención tiene algunas excepciones. Por ejemplo, eventSource para Amazon CloudWatch esmonitoring.amazonaws.com.

Desde: 1.0

Opcional: Falso

eventName

La acción solicitada, que es una de las acciones de la API para ese servicio.

Desde: 1.0

Opcional: Falso

awsRegion

Al Región de AWS que se hizo la solicitud, comous-east-2. Consulte CloudTrail regiones compatibles.

Desde: 1.0

Opcional: Falso

sourceIPAddress

La dirección IP desde la que se realizó la solicitud. Para las acciones que se originan desde la consola del servicio, la dirección registrada es para el recurso del cliente subyacente, no para el servidor web de la consola. En el caso de los servicios en AWS, solo se muestra el nombre DNS.

nota

En el caso de eventos originados por AWS, este campo es normalmente AWS Internal/#, donde # es un número usado para fines internos.

Desde: 1.0

Opcional: Falso

userAgent

El agente a través del cual se realizó la solicitud, como el AWS Management Console, un AWS servicio, el AWS SDKs o el AWS CLI. Este campo tiene un tamaño máximo de 1 KB; el contenido que supere ese límite se trunca. A continuación se incluyen valores de ejemplo:

  • lambda.amazonaws.com: la solicitud se realizó con AWS Lambda.

  • aws-sdk-java: la solicitud se realizó con AWS SDK for Java.

  • aws-sdk-ruby: la solicitud se realizó con AWS SDK for Ruby.

  • aws-cli/1.3.23 Python/2.7.6 Linux/2.6.18-164.el5— La solicitud se realizó con el AWS CLI instalado en Linux.

nota

En el caso de los eventos originados por AWS(si CloudTrail sabe quién Servicio de AWS realizó la llamada), este campo es la fuente de eventos del servicio que realiza la llamada (por ejemplo,ec2.amazonaws.com). De lo contrario, este campo es #, donde AWS Internal/# es un número que se usa para fines internos.

Desde: 1.0

Opcional: Verdadero

errorCode

El error del AWS servicio si la solicitud devuelve un error. Para ver un ejemplo que muestra este campo, consulte Ejemplo de código de error y registro de mensajes. Este campo tiene un tamaño máximo de 1 KB; el contenido que supere ese límite se trunca.

En el caso de los eventos de actividad de la red, cuando se infringe la política de puntos de conexión de VPC, el código de error es VpceAccessDenied.

Desde: 1.0

Opcional: Verdadero

errorMessage

Si la solicitud devuelve un error, la descripción del error. Este mensaje incluye mensajes sobre errores de autorización. CloudTrail captura el mensaje registrado por el servicio en su gestión de excepciones. Para ver un ejemplo, consulta Ejemplo de código de error y registro de mensajes. Este campo tiene un tamaño máximo de 1 KB; el contenido que supere ese límite se trunca.

En el caso de los eventos de actividad de la red, cuando se infringe la política de puntos de conexión de VPC, el errorMessage será siempre el siguiente mensaje: The request was denied due to a VPC endpoint policy. Para obtener más información sobre los eventos de acceso denegado por infracciones de la política de puntos de conexión de VPC, consulte Ejemplos de mensajes de error de acceso denegado en la Guía del usuario de IAM. Para ver un ejemplo de evento de actividad de la red que muestre una infracción de la política de puntos de conexión de VPC, consulte Eventos de actividad de la red en esta guía.

nota

Algunos AWS servicios proporcionan los campos errorCode y errorMessage como campos de nivel superior en caso de que se trate. Otros servicios de AWS proporcionan información del error como parte de responseElements.

Desde: 1.0

Opcional: Verdadero

requestParameters

Los parámetros, si hay alguno, que se enviaron con la solicitud. Estos parámetros se documentan en la documentación de referencia de la API del AWS servicio correspondiente. Este campo tiene un tamaño máximo de 100 KB. Cuando el tamaño del campo supera los 100 KB, se omite el requestParameters contenido.

Desde: 1.0

Opcional: Falso

responseElements

Los elementos de respuesta, si los hay, de las acciones que realizaron cambios (acciones de creación, actualización o eliminación). Para readOnly APIs, este campo esnull. Si la acción no devuelve elementos de respuesta, este campo es null. Los elementos de respuesta de las acciones se explican en la documentación de referencia de la API del Servicio de AWS correspondiente. Este campo tiene un tamaño máximo de 100 KB. Cuando el tamaño del campo supera los 100 KB, se omite el reponseElements contenido.

El responseElements valor es útil para ayudarle a rastrear una solicitud con AWS Support. Tanto x-amz-request-id como x-amz-id-2 contienen información que ayuda a rastrear una solicitud con Support. Estos valores son los mismos que los que devuelve el servicio en respuesta a la solicitud que inicia los eventos, por lo que se pueden utilizar para emparejar el evento con la solicitud.

Desde: 1.0

Opcional: Falso

additionalEventData

Datos adicionales sobre el evento que no forman parte de la solicitud o la respuesta. Este campo tiene un tamaño máximo de 28 KB. Cuando el tamaño del campo supera los 28 KB, se omite el additionalEventData contenido.

El contenido de additionalEventData es variable. Por ejemplo, para los eventos de AWS Management Console inicio de sesión, additionalEventData podría incluir el MFAUsed campo con el valor de Yes si la solicitud la realizó un usuario raíz o de IAM mediante la autenticación multifactor (MFA).

Desde: 1.0

Opcional: Verdadero

requestID

El valor que identifica la solicitud. El servicio al que se llama genera este valor. Este campo tiene un tamaño máximo de 1 KB; el contenido que supere ese límite se trunca.

Desde: 1.01

Opcional: Verdadero

eventID

GUID generado por para identificar de forma única cada CloudTrail evento. Puede utilizar este valor para identificar un evento individual. Por ejemplo, puede utilizar el ID como clave principal para recuperar datos de archivos de registro de una base de datos que permita realizar búsquedas.

Desde: 1.01

Opcional: Falso

eventType

Identifica el tipo de evento que generó el registro del evento. Puede ser uno de los siguientes valores:

  • AwsApiCall: se llamó a una API.

  • AwsServiceEvent: el servicio generó un evento relacionado con su registro de seguimiento. Por ejemplo, esto puede ocurrir cuando otra cuenta realiza una llamada con un recurso de su propiedad.

  • AwsConsoleAction: Se realizó una acción en la consola que no era una llamada a la API.

  • AwsConsoleSignIn— Un usuario de tu cuenta (root, IAM, federado, SAML o SwitchRole) ha iniciado sesión en. AWS Management Console

  • AwsCloudTrailInsight— Si los eventos de Insights están habilitados, CloudTrail genera eventos de Insights cuando CloudTrail detecta una actividad operativa inusual, como picos en el aprovisionamiento de recursos o ráfagas de acciones (IAM). AWS Identity and Access Management

    Los eventos de AwsCloudTrailInsight no utilizan los siguientes campos:

    • eventName

    • eventSource

    • sourceIPAddress

    • userAgent

    • userIdentity

  • AwsVpceEvents— los eventos de actividad de CloudTrail red (en versión preliminar) permiten a los propietarios de puntos finales de VPC grabar las llamadas a la AWS API realizadas con sus puntos de enlace de VPC desde una VPC privada a. Servicio de AWS Para registrar los eventos de actividad de la red, el propietario del punto de conexión de VPC debe habilitar los eventos de actividad de la red para el origen de los eventos.

Desde: 1.02

Opcional: Falso

apiVersion

Identifica la versión de la API asociada con el valor de AwsApiCall eventType.

Desde: 1.01

Opcional: Verdadero

managementEvent

Un valor booleano que identifica si el evento es un evento de administración. managementEvent se muestra en un registro de eventos si eventVersion es 1.06 o superior y el tipo de evento es uno de los siguientes:

  • AwsApiCall

  • AwsConsoleAction

  • AwsConsoleSignIn

  • AwsServiceEvent

Desde: 1.06

Opcional: Verdadero

readOnly

Identifica si esta operación es una operación de solo lectura. Puede ser uno de los valores siguientes:

  • true: la operación es de solo lectura (por ejemplo, DescribeTrails).

  • false: la operación es de solo escritura (por ejemplo, DeleteTrail).

Desde: 1.01

Opcional: Verdadero

resources

Una lista de los recursos a los que ha obtenido acceso el evento. El campo puede contener la siguiente información:

  • Recurso ARNs

  • El ID de cuenta del propietario del recurso

  • El identificador de tipo de recurso en el formato: AWS::aws-service-name::data-type-name

Por ejemplo, cuando se registra un evento AssumeRole, el campo resources puede tener un aspecto similar al siguiente:

  • ARN: arn:aws:iam::123456789012:role/myRole

  • ID de cuenta: 123456789012

  • Identificador de tipo de recurso: AWS::IAM::Role

Para ver, por ejemplo, los registros con el resources campo, consulte Evento de AWS STS API en el archivo de CloudTrail registro en la Guía del usuario de IAM o Registro de llamadas a la AWS KMS API en la Guía para AWS Key Management Service desarrolladores.

Desde: 1.01

Opcional: Verdadero

recipientAccountId

Representa el ID de cuenta que recibió este evento. El recipientAccountID puede ser diferente de CloudTrail userIdentity elemento accountId. Esto puede ocurrir en el acceso de recursos entre cuentas. Por ejemplo, si una clave de KMS, también conocida como AWS KMS key, fue utilizada por una cuenta aparte para llamar a la API Encrypt, los valores de accountId y recipientAccountID serán los mismos para el evento enviado a la cuenta que realizó la llamada, pero serán diferentes para el evento que se envía a la cuenta propietaria de la clave de KMS.

Desde: 1.02

Opcional: Verdadero

serviceEventDetails

Identifica el evento del servicio, incluido lo que activó el evento y el resultado. Para obtener más información, consulte Eventos de Servicio de AWS. Este campo tiene un tamaño máximo de 100 KB. Cuando el tamaño del campo supera los 100 KB, se omite el serviceEventDetails contenido.

Desde: 1.05

Opcional: Verdadero

sharedEventID

El GUID se genera CloudTrail para identificar de forma exclusiva CloudTrail los eventos de la misma AWS acción que se envían a cuentas diferentes AWS .

Por ejemplo, cuando una cuenta usa una AWS KMS keyque pertenece a otra cuenta, la cuenta que usó la clave KMS y la cuenta propietaria de la clave KMS reciben CloudTrail eventos separados para la misma acción. Cada CloudTrail evento entregado para esta AWS acción comparte lo mismosharedEventID, pero también tiene un eventID y únicorecipientAccountID.

Para obtener más información, consulte Ejemplo de sharedEventID.

nota

El sharedEventID campo solo está presente cuando CloudTrail los eventos se envían a varias cuentas. Si el intermediario y el propietario son la misma cuenta de AWS , CloudTrail envía solo un evento y no se muestra el campo sharedEventID.

Desde: 1.03

Opcional: Verdadero

vpcEndpointId

Identifica el punto de enlace de la VPC en el que se realizaron las solicitudes desde una VPC a otro AWS servicio, como Amazon. EC2

Desde: 1.04

Opcional: Verdadero

vpcEndpointAccountId

Identifica el Cuenta de AWS ID del propietario del punto final de la VPC del punto final correspondiente por el que se ha atravesado una solicitud.

Desde: 1.09

Opcional: Verdadero

eventCategory

Muestra la categoría del evento. La categoría del evento se usa en las llamadas de LookupEvents para filtrar los eventos de administración o de Insights.

  • Para los eventos de administración, el valor es Management.

  • Para los eventos de datos de, el valor es Data.

  • Para los eventos de Insights, el valor es Insight.

  • En el caso de los eventos de actividad de la red, el valor es NetworkActivity.

Desde: 1.07

Opcional: Falso

addendum

Si se ha retrasado la entrega de un evento o queda disponible información adicional sobre un evento existente después de registrar el evento, un campo anexado muestra información sobre el motivo del retraso del evento. Si falta información de un evento existente, el campo anexado incluye la información que falta y un motivo. El contenido incluye lo siguiente:

  • reason: el motivo por el que faltaba el evento o algunos de sus contenidos. Los valores pueden ser cualquiera de los siguientes.

    • DELIVERY_DELAY: se produjo un retraso en la entrega de eventos. Esto puede deberse a un tráfico de red elevado, a problemas de conectividad o a un CloudTrail problema de servicio.

    • UPDATED_DATA: faltó un campo en el registro de eventos o había un valor incorrecto.

    • SERVICE_OUTAGE— Un servicio que registra eventos CloudTrail relacionados con una interrupción y no puede registrarlos CloudTrail. Esto es excepcionalmente raro.

  • updatedFields: los campos del registro de eventos que se actualizan con la información agregada. Esto solo se proporciona si el motivo es UPDATED_DATA.

  • originalRequestID: el ID único original de la solicitud. Esto solo se proporciona si el motivo es UPDATED_DATA.

  • originalEventID: el ID del evento original. Esto solo se proporciona si el motivo es UPDATED_DATA.

Desde: 1.08

Opcional: Verdadero

sessionCredentialFromConsole

Muestra si un evento se originó o no en una AWS Management Console sesión. Este campo no se muestra a menos que el valor sea true, lo que significa que el cliente que se utilizó para realizar la llamada a la API era un proxy o un cliente externo. Si se ha utilizado un cliente proxy, el campo del evento tlsDetails no se muestra.

Desde: 1.08

Opcional: Verdadero

edgeDeviceDetails

Muestra información sobre los dispositivos de borde que son destinos de una solicitud. En la actualidad, los dispositivos S3 Outposts incluyen este campo. Este campo tiene un tamaño máximo de 28 KB; el contenido que supere ese límite se trunca.

Desde: 1.08

Opcional: Verdadero

tlsDetails

Muestra información sobre la versión de Transport Layer Security (TLS), los conjuntos de cifrado y el nombre de dominio completo (FQDN) del nombre de host proporcionado por el cliente y utilizado en la llamada a la API de servicio, que suele ser el FQDN del punto final del servicio. CloudTrailsigue registrando detalles de TLS parciales si falta la información esperada o está vacía. Por ejemplo, si la versión de TLS y el conjunto de cifrado están presentes, pero el HOST encabezado está vacío, los detalles de TLS disponibles se seguirán registrando en ese caso. CloudTrail

  • tlsVersion: la versión TLS de una solicitud.

  • cipherSuite: el conjunto de cifrado (combinación de algoritmos de seguridad utilizados) de una solicitud.

  • clientProvidedHostHeader: nombre de host proporcionado por el cliente que se utiliza en la llamada a la API del servicio, que suele ser el FQDN del punto de conexión del servicio.

nota

Hay algunos casos en los que el campo tlsDetails no está presente en un registro de eventos.

  • El tlsDetails campo no está presente si la llamada a la API la realizó una persona Servicio de AWS en tu nombre. El campo invokedBy del elemento userIdentity identifica al Servicio de AWS que hizo la llamada a la API.

  • Si sessionCredentialFromConsole está presente con un valor de true, tlsDetails estará presente en un registro de evento solo si se utilizó un cliente externo para hacer la llamada a la API.

Desde: 1.08

Opcional: Verdadero

Campos de registro de eventos de Insights

Los siguientes son atributos que se muestran en la estructura JSON de un evento de Insights que difieren de los de un evento de administración o de datos.

sharedEventId

La A sharedEventID para los eventos de CloudTrail Insights difiere de la sharedEventID correspondiente a los tipos de CloudTrail eventos de administración y datos. En los eventos de Insights, a sharedEventID es un GUID generado por CloudTrail Insights para identificar de forma exclusiva un evento de Insights. sharedEventIDes común entre el inicio y el final de los eventos de Insights y ayuda a conectar ambos eventos para identificar de forma única actividades inusuales. sharedEventID puede considerarse como el ID general de evento de Insights.

Desde: 1.07

Opcional: Falso

insightDetails

Solo eventos de Insights. Muestra información sobre los desencadenantes subyacentes de un evento de Insights, tal como la fuente del evento, el agente del usuario, las estadísticas, el nombre de la API y si se trata de un evento de Insights inicial o final. Para obtener más información sobre el contenido del bloque insightDetails, consulte Elemento insightDetails CloudTrail Insights

Desde: 1.07

Opcional: Falso

Ejemplo de sharedEventID

El siguiente es un ejemplo que describe cómo se CloudTrail generan dos eventos para la misma acción:

  1. Alice tiene una AWS cuenta (1111) y crea una AWS KMS key. Es la propietaria de esta clave de KMS.

  2. Bob tiene una AWS cuenta (222222222222). Alice concede a Bob permiso para utilizar la clave de KMS.

  3. Cada cuenta tiene un registro de seguimiento y un bucket independiente.

  4. Bob utiliza la clave de KMS para llamar a la API Encrypt.

  5. CloudTrail envía dos eventos separados.

    • Un evento se envía a Bob. El evento muestra que Bob utilizó la clave de KMS.

    • Un evento se envía a Alice. El evento muestra que Bob utilizó la clave de KMS.

    • Los eventos tienen el mismo sharedEventID, pero el eventID y recipientAccountID son únicos.

¿Cómo aparece el campo sharedEventID en los registros?

Evento compartido IDs en CloudTrail Insights

La A sharedEventID para los eventos de CloudTrail Insights difiere de la sharedEventID para los tipos de CloudTrail eventos de administración y datos. En los eventos de Insights, a sharedEventID es un GUID generado por CloudTrail Insights para identificar de forma exclusiva un par de eventos de Insights de inicio y fin. sharedEventIDes común entre el inicio y el final de un evento de Insights y ayuda a crear una correlación entre ambos eventos para identificar de forma única una actividad inusual.

sharedEventID puede considerarse como el ID general de evento de Insights.