Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
CloudTrail enregistrer le contenu
Le corps de l’enregistrement contient les champs qui permettent de déterminer l’action demandée, ainsi que le moment et l’endroit où la demande a été effectuée. Lorsque la valeur de Facultatif est True, le champ n'est présent que lorsqu'il s'applique au service ou au type d'événement. API La valeur facultative False signifie que le champ est toujours présent ou que sa présence ne dépend pas du service ou du type d'événement. API Voici un exemple : responseElements
, qui est présent dans les événements pour les actions qui apportent des modifications (actions de création, de mise à jour ou de suppression).
CloudTrail tronque un champ si son contenu dépasse la taille maximale du champ. Si un champ est tronqué, omitted
est présent avec une valeur de true
.
eventTime
-
Date et heure auxquelles la demande a été traitée, en temps universel coordonné (UTC). L'horodatage d'un événement provient de l'hôte local qui fournit le point de API terminaison de service sur lequel l'APIappel a été effectué. Par exemple, un CreateBucket API événement organisé dans la région de l'ouest des États-Unis (Oregon) sera horodaté à partir de l'heure sur un AWS hôte exécutant le point de terminaison Amazon S3,
s3.us-west-2.amazonaws.com
. En général, les AWS services utilisent le protocole Network Time Protocol (NTP) pour synchroniser les horloges de leur système.Depuis : 1.0
Facultatif : False
eventVersion
-
Version du format de l’événement du journal. La version actuelle est la 1.10.
La
eventVersion
valeur est une version majeure et une version mineure du formulairemajor_version
.minor_version
. Par exemple, vous pouvez avoir uneeventVersion
valeur de1.09
, où se1
trouve la version majeure et09
est la version mineure.CloudTrail incrémente la version principale si une modification non rétrocompatible est apportée à la structure de l'événement. Cela inclut la suppression d'un JSON champ qui existe déjà ou la modification de la façon dont le contenu d'un champ est représenté (par exemple, un format de date). CloudTrail augmente la version mineure si une modification ajoute de nouveaux champs à la structure de l'événement. Cela peut se produire si de nouvelles informations sont disponibles pour tout ou partie des événements existants, ou si de nouvelles informations sont disponibles seulement pour des types d’événements nouvellement introduits. Les applications peuvent ignorer les nouveaux champs pour être compatibles avec de nouvelles versions mineures de la structure de l'événement.
Si de CloudTrail nouveaux types d'événements sont introduits, mais que la structure de l'événement reste inchangée, la version de l'événement ne change pas.
Pour vous assurer que vos applications puissent analyser la structure de l’événement, nous vous recommandons d’effectuer une comparaison égal à sur le numéro de version majeure. Pour être sûr que les champs attendus par votre application existent, nous vous recommandons également d'effectuer une comparaison greater-than-or-equal -to sur la version mineure. La version mineure ne comporte pas de zéros au début. Vous pouvez interpréter les deux
major_version
andminor_version
sous forme de nombres, et effectuez des opérations de comparaison.Depuis : 1.0
Facultatif : False
userIdentity
-
Informations sur l'IAMidentité de l'auteur de la demande. Pour de plus amples informations, veuillez consulter CloudTrail userIdentity élément.
Depuis : 1.0
Facultatif : False
eventSource
-
Service auprès duquel la demande a été faite. Ce nom est généralement une forme abrégée du nom du service sans espaces, plus
.amazonaws.com
. Par exemple :-
AWS CloudFormation est
cloudformation.amazonaws.com
. -
Amazon EC2 l'est
ec2.amazonaws.com
. -
Amazon Simple Workflow Service est
swf.amazonaws.com
.
Cette convention présente quelques exceptions. Par exemple,
eventSource
pour Amazon, CloudWatch c'estmonitoring.amazonaws.com
.Depuis : 1.0
Facultatif : False
-
eventName
-
L'action demandée, qui est l'une des actions API du service correspondant.
Depuis : 1.0
Facultatif : False
awsRegion
-
Le Région AWS destinataire de la demande, tel que
us-east-2
. Consultez CloudTrail Régions prises en charge.Depuis : 1.0
Facultatif : False
sourceIPAddress
-
Adresse IP à partir de laquelle la demande a été faite. Pour les actions qui sont créées à partir de la console de service, l’adresse présentée est celle de la ressource du client sous-jacent, non le serveur Web de la console. Pour les services en AWS, seul le DNS nom est affiché.
Note
Pour les événements émis par AWS, ce champ est généralement
AWS Internal/
, où#
est un nombre utilisé à des fins internes.#
Depuis : 1.0
Facultatif : False
userAgent
-
L'agent par l'intermédiaire duquel la demande a été faite, tel que le AWS Management Console, un AWS service, le AWS SDKs ou le AWS CLI. Ce champ a une taille maximale de 1 Ko ; tout contenu dépassant cette limite est tronqué. Voici quelques exemples de valeurs :
-
lambda.amazonaws.com
– La demande a été effectuée avec AWS Lambda. -
aws-sdk-java
– La demande a été effectuée avec le AWS SDK for Java. -
aws-sdk-ruby
– La demande a été effectuée avec le AWS SDK for Ruby. -
aws-cli/1.3.23 Python/2.7.6 Linux/2.6.18-164.el5
— La demande a été faite avec le système AWS CLI installé sur Linux.
Note
Pour les événements créés par AWS, si CloudTrail vous savez qui Service AWS a effectué l'appel, ce champ est la source de l'événement du service d'appel (par exemple,
ec2.amazonaws.com
). Dans le cas contraire, ce champ estAWS Internal/
, où#
est un numéro utilisé à des fins internes.#
Depuis : 1.0
Facultatif : True
-
errorCode
-
Erreur de AWS service si la demande renvoie une erreur. Pour obtenir un exemple qui montre ce champ, consultez Exemple de code d'erreur et de journal de messages. Ce champ a une taille maximale de 1 Ko ; tout contenu dépassant cette limite est tronqué.
Pour les événements liés à l'activité réseau, en cas de violation de la politique des VPC terminaux, le code d'erreur est
VpceAccessDenied
.Depuis : 1.0
Facultatif : True
errorMessage
-
Si la demande renvoie une erreur, description de l’erreur. Ce message inclut des messages relatifs à des échecs d'autorisation. CloudTrail capture le message enregistré par le service dans sa gestion des exceptions. Pour voir un exemple, consultez Exemple de code d'erreur et de journal de messages. Ce champ a une taille maximale de 1 Ko ; tout contenu dépassant cette limite est tronqué.
Pour les événements d'activité réseau, en cas de violation de la politique du point de VPC terminaison, le message suivant
errorMessage
sera toujours le suivant :The request was denied due to a VPC endpoint policy
. Pour plus d'informations sur les événements de refus d'accès liés à des violations de la politique des VPC terminaux, consultez les exemples de messages d'erreur de refus d'accès dans le guide de IAM l'utilisateur. Pour un exemple d'événement d'activité réseau illustrant une violation de la politique des VPC terminaux, consultez la section Événements d'activité réseau de ce guide.Note
Certains AWS services fournissent les champs
errorCode
eterrorMessage
en tant que champs de haut niveau lors de l'événement. D’autres services AWS fournissent des informations d’erreur dans le cadre deresponseElements
.Depuis : 1.0
Facultatif : True
requestParameters
-
Les paramètres, le cas échéant, qui ont été envoyées avec la demande. Ces paramètres sont documentés dans la documentation de API référence du AWS service approprié. Ce champ a une taille maximale de 100 Ko ; tout contenu dépassant cette limite est tronqué.
Depuis : 1.0
Facultatif : False
responseElements
-
Les éléments de réponse, le cas échéant, pour les actions apportant des modifications (actions de création, de mise à jour ou de suppression). Si l'action ne renvoie pas d'éléments de réponse, ce champ l'est
null
. Si une action ne change pas d'état (par exemple, une demande pour obtenir ou répertorier des objets), cet élément est omis. Les éléments de réponse aux actions sont documentés dans la API référence documentation pour le produit approprié Service AWS. Ce champ a une taille maximale de 100 Ko ; le contenu dépassant cette limite est tronqué.La
responseElements
valeur est utile pour vous aider à suivre une demande avec AWS Support. Les deuxx-amz-request-id
etx-amz-id-2
contiennent des informations qui vous aident à suivre une demande auprès de AWS Support. Ces valeurs sont les mêmes que ceux que le service renvoie en réponse à la demande initie les événements, afin que vous puissiez les utiliser pour faire correspondre l'événement à demande.Depuis : 1.0
Facultatif : False
-
additionalEventData
-
Des données supplémentaires sur l’événement qui ne faisaient pas partie de la demande ou de la réponse. Ce champ a une taille maximale de 28 Ko ; tout contenu dépassant cette limite est tronqué.
Depuis : 1.0
Facultatif : True
requestID
-
Valeur qui identifie la demande. Le service appelé génère cette valeur. Ce champ a une taille maximale de 1 Ko ; tout contenu dépassant cette limite est tronqué.
Depuis : 1.01
Facultatif : True
eventID
-
GUIDgénéré par CloudTrail pour identifier de manière unique chaque événement. Vous pouvez utiliser cette valeur pour identifier un événement unique. Par exemple, vous pouvez utiliser l’ID comme clé primaire pour récupérer les données des journaux à partir d’une base de données dans laquelle vous pouvez effectuer des recherches.
Depuis : 1.01
Facultatif : False
eventType
-
Identifie le type d’événement qui a généré l’enregistrement de l’événement. Il peut s’agir de l’une des valeurs suivantes :
-
AwsApiCall
— On m'APIa appelé. -
AwsServiceEvent
– Le service a généré un événement lié à votre journal d'activité. Par exemple, cela peut se produire lorsqu’un autre compte a effectué un appel avec une ressource dont vous êtes propriétaire. -
AwsConsoleAction
— Une action qui n'était pas un API appel a été effectuée dans la console. -
AwsConsoleSignIn
— Un utilisateur de votre compte (rootIAM, fédéré ou SwitchRole) s'est connecté au AWS Management Console. SAML -
AwsCloudTrailInsight
— Si les événements Insights sont activés, CloudTrail génère des événements Insights lorsqu'une activité opérationnelle inhabituelle est CloudTrail détectée, telle que des pics d'approvisionnement en ressources ou des rafales d'actions AWS Identity and Access Management ()IAM.Les événements
AwsCloudTrailInsight
n'utilisent pas les champs suivants :-
eventName
-
eventSource
-
sourceIPAddress
-
userAgent
-
userIdentity
-
-
AwsVpceEvents
— les événements d'activité CloudTrail réseau (en version préliminaire) permettent aux propriétaires de VPC terminaux d'enregistrer les AWS API appels passés à l'aide de leurs VPC terminaux depuis un terminal privé VPC vers le Service AWS. Pour enregistrer les événements d'activité réseau, le propriétaire du VPC terminal doit activer les événements d'activité réseau pour la source de l'événement.
Depuis : 1.02
Facultatif : False
-
apiVersion
-
Identifie la API version associée à la
AwsApiCall
eventType
valeur.Depuis : 1.01
Facultatif : True
managementEvent
-
Valeur booléenne qui identifie si l’événement est un événement de gestion.
managementEvent
s’affiche dans un enregistrement d’événement sieventVersion
est la version 1.06 ou supérieure et que le type d’événement est l’un des types suivants :-
AwsApiCall
-
AwsConsoleAction
-
AwsConsoleSignIn
-
AwsServiceEvent
Depuis : 1.06
Facultatif : True
-
-
readOnly
-
Identifie si cette opération est en lecture seule. Il peut s’agir de l’une des valeurs suivantes :
-
true
– L’opération est en lecture seule (par exemple,DescribeTrails
). -
false
– L’opération est en écriture seule (par exemple,DeleteTrail
).
Depuis : 1.01
Facultatif : True
-
-
resources
-
Une liste des ressources consultées dans l'événement. Le champ peut contenir les informations suivantes :
-
Ressource ARNs
-
ID de compte du propriétaire de la ressource
-
Identifiant du type de ressource au format :
AWS::
aws-service-name
::data-type-name
Par exemple, quand un événement
AssumeRole
est consigné, le champresources
peut apparaître comme ce qui suit :-
ARN:
arn:aws:iam::123456789012:role/
myRole
-
ID de compte :
123456789012
-
Identifiant du type de ressource :
AWS::
IAM
::Role
Par exemple, enregistre avec le
resources
champ, voir AWS STS APIÉvénement dans le fichier CloudTrail journal dans le guide de IAM l'utilisateur ou journalisation AWS KMS API des appels dans le guide du AWS Key Management Service développeur.Depuis : 1.01
Facultatif : True
-
recipientAccountId
-
Représente l’ID du compte qui a reçu cet événement. L’élément
recipientAccountID
peut être différent de CloudTrail userIdentity élémentaccountId
. Cela peut se produire dans l’accès aux ressources entre comptes. Par exemple, si une KMS clé, également connue sous le nom de AWS KMS key, a été utilisée par un compte distinct pour appeler le chiffrement API,recipientAccountID
les valeursaccountId
et seront les mêmes pour l'événement transmis au compte qui a effectué l'appel, mais les valeurs seront différentes pour l'événement transmis au compte propriétaire de la KMS clé.Depuis : 1.02
Facultatif : True
serviceEventDetails
-
Identifie l’événement de service, y compris ce qui le déclenche et le résultat. Pour plus d'informations, consultez Service AWS événements. Ce champ a une taille maximale de 100 Ko ; tout contenu dépassant cette limite est tronqué.
Depuis : 1.05
Facultatif : True
sharedEventID
-
GUIDgénéré par CloudTrail pour identifier de manière unique les CloudTrail événements AWS d'une même action envoyée à différents AWS comptes.
Par exemple, lorsqu'un compte utilise un AWS KMS keycompte appartenant à un autre compte, le compte qui a utilisé la KMS clé et le compte propriétaire de la KMS clé reçoivent des CloudTrail événements distincts pour la même action. Chaque CloudTrail événement organisé pour cette AWS action partage la même chose
sharedEventID
, mais possède également uneventID
et uniquerecipientAccountID
.Pour de plus amples informations, veuillez consulter Exemple sharedEvent d'ID.
Note
Le
sharedEventID
champ n'est présent que lorsque les CloudTrail événements sont transmis à plusieurs comptes. Si l'appelant et le propriétaire sont le même AWS compte, CloudTrail envoie un seul événement et lesharedEventID
champ n'est pas présent.Depuis : 1.03
Facultatif : True
-
vpcEndpointId
-
Identifie le VPC point de terminaison sur lequel les demandes ont été adressées VPC à un autre AWS service, tel qu'AmazonEC2.
Depuis : 1.04
Facultatif : True
-
vpcEndpointAccountId
-
Identifie l' Compte AWS ID du propriétaire du VPC point de terminaison correspondant pour lequel une demande a été transmise.
Depuis : 1.09
Facultatif : True
eventCategory
-
Affiche la catégorie de l'événement. La catégorie d'événement est utilisée dans les
LookupEvents
appels pour filtrer les événements de gestion ou Insights.-
Pour les événements de gestion, la valeur est
Management
. -
Pour les événements de données, la valeur est
Data
. -
Pour les événements Insights, la valeur est
Insight
. -
Pour les événements liés à l'activité du réseau, la valeur est
NetworkActivity
.
Depuis : 1.07
Facultatif : False
-
addendum
-
Si la livraison d'un événement a été retardée ou si des informations supplémentaires sur un événement existant sont disponibles après l'enregistrement de l'événement, un champ addenda affiche des informations sur les raisons pour lesquelles l'événement a été retardé. Si des informations manquaient dans un événement existant, le champ addenda inclut les informations manquantes et une raison pour laquelle elles étaient manquantes. Le contenu comprend les éléments suivants :
-
reason
- La raison pour laquelle l'événement ou une partie de son contenu était manquant. Il peut s'agir de l'une des valeurs suivantes :-
DELIVERY_DELAY
– Il y a eu un retard de livraison des événements. Cela peut être dû à un trafic réseau élevé, à des problèmes de connectivité ou à un problème CloudTrail de service. -
UPDATED_DATA
– Un champ de l'enregistrement d'événement manquait ou comportait une valeur incorrecte. -
SERVICE_OUTAGE
— Un service qui enregistre les événements en CloudTrail cas de panne et qui n'a pas pu les enregistrer CloudTrail. Ceci est extrêmement rare.
-
-
updatedFields
- Les champs d'enregistrement d'événement mis à jour par l'addenda. Ceci n'est fourni que si la raison estUPDATED_DATA
. -
originalRequestID
- ID unique d'origine de la demande. Ceci n'est fourni que si la raison estUPDATED_DATA
. -
originalEventID
- ID d'événement d'origine. Ceci n'est fourni que si la raison estUPDATED_DATA
.
Depuis : 1.08
Facultatif : True
-
sessionCredentialFromConsole
-
Indique si un événement est issu d'une AWS Management Console session. Ce champ n'est pas affiché sauf si la valeur est
true
, ce qui signifie que le client utilisé pour effectuer l'APIappel était un proxy ou un client externe. Si un client proxy a été utilisé, le champ d'événementtlsDetails
n'est pas affiché.Depuis : 1.08
Facultatif : True
edgeDeviceDetails
-
Affiche des informations sur les périphériques cibles d'une demande. Actuellement, les événements du périphérique
S3 Outposts
incluent ce champ. Ce champ a une taille maximale de 28 Ko ; tout contenu dépassant cette limite est tronqué. Depuis : 1.08
Facultatif : True
tlsDetails
-
Affiche des informations sur la version de Transport Layer Security (TLS), les suites de chiffrement et le nom de domaine complet (FQDN) du nom d'hôte fourni par le client et utilisé dans l'APIappel de service, qui est généralement celui du point de terminaison FQDN du service. CloudTrailenregistre toujours des TLS détails partiels si les informations attendues sont manquantes ou vides. Par exemple, si la TLS version et la suite de chiffrement sont présentes, mais que l'
HOST
en-tête est vide, les TLS détails disponibles sont toujours enregistrés dans l' CloudTrail événement.-
tlsVersion
- La TLS version d'une demande. -
cipherSuite
: La suite de chiffrement (combinaison d’algorithmes de sécurité utilisés) d’une requête. -
clientProvidedHostHeader
- Le nom d'hôte fourni par le client et utilisé dans l'APIappel de service, qui est généralement celui du point FQDN de terminaison du service.
Note
Dans certains cas, le champ
tlsDetails
n'est pas présent dans un enregistrement d'événement.-
Le
tlsDetails
champ n'est pas présent si l'APIappel a été effectué par un Service AWS ou en votre nom. LeinvokedBy
champ de l'userIdentity
élément identifie la personne Service AWS qui a effectué l'APIappel. -
S'il
sessionCredentialFromConsole
est présent avec la valeur true, n'tlsDetails
est présent dans un enregistrement d'événement que si un client externe a été utilisé pour effectuer l'APIappel.
Depuis : 1.08
Facultatif : True
-
Champs d'enregistrement pour les événements Insights
Les attributs présentés dans la JSON structure d'un événement Insights sont les suivants. Ils sont différents de ceux d'un événement de gestion ou de données.
sharedEventId
-
Les événements A
sharedEventID
pour CloudTrail Insights sont différents des CloudTrail événementssharedEventID
relatifs à la gestion et aux types de données. Dans les événements Insights, asharedEventID
est un GUID événement généré par CloudTrail Insights pour identifier de manière unique un événement Insights.sharedEventID
est courant entre les événements Insights de début et de fin, et permet de relier les deux événements afin d'identifier de manière unique les activités inhabituelles. Vous pouvez considérersharedEventID
comme l’ID d’événement Insights global.Depuis : 1.07
Facultatif : False
insightDetails
-
Événements Insights uniquement. Affiche des informations sur les déclencheurs sous-jacents d'un événement Insights, telles que la source de l'événement, l'agent utilisateur, les statistiques, le API nom, et indique si l'événement marque le début ou la fin de l'événement Insights. Pour plus d'informations sur le contenu du bloc
insightDetails
, consultez CloudTrail insightDetailsÉlément Insights.Depuis : 1.07
Facultatif : False
Exemple sharedEvent d'ID
L'exemple suivant décrit comment CloudTrail délivre deux événements pour la même action :
-
Alice possède un AWS compte (111111111111) et crée un. AWS KMS key Elle est propriétaire de cette KMS clé.
-
Bob a un AWS compte (222222222222). Alice autorise Bob à utiliser la KMS clé.
-
Chaque compte a un journal de suivi et un compartiment distinct.
-
Bob utilise la KMS touche pour appeler le
Encrypt
API. -
CloudTrail envoie deux événements distincts.
-
Un événement est envoyé à Bob. L'événement montre qu'il a utilisé la KMS clé.
-
Un deuxième événement est envoyé à Alice. L'événement montre que Bob a utilisé la KMS clé.
-
Les événements ont les mêmes
sharedEventID
, mais leseventID
etrecipientAccountID
sont uniques.
-
Événement partagé IDs dans CloudTrail Insights
Les événements A sharedEventID
pour CloudTrail Insights sont différents des CloudTrail événements sharedEventID
relatifs à la gestion et aux types de données. Dans les événements Insights, a sharedEventID
est un GUID événement généré par CloudTrail Insights pour identifier de manière unique une paire d'événements Insights de début et de fin. sharedEventID
est courant entre le début et la fin de l'événement Insights et permet de créer une corrélation entre les deux événements afin d'identifier de manière unique les activités inhabituelles.
Vous pouvez considérer sharedEventID
comme l’ID d’événement Insights global.