View a markdown version of this page

CloudTrail Élément UserIdentity - AWS CloudTrail

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 Élément UserIdentity

Gestion des identités et des accès AWS (IAM) fournit différents types d'identités. L'élément userIdentity contient des détails sur le type d'identité IAM ayant effectué la demande, ainsi que les informations d'identification qui ont été utilisées. Si des informations d'identification temporaires ont été utilisées, l'élément montre comment ces informations d'identification ont été obtenues.

Exemples

userIdentity avec les informations d'identification d'utilisateur IAM

L'exemple suivant montre l'élément userIdentity d'une demande simple faite avec les informations d'identification de l'utilisateur IAM nommé Alice.

"userIdentity": { "type": "IAMUser", "principalId": "AIDAJ45Q7YFFAREXAMPLE", "arn": "arn:aws:iam::123456789012:user/Alice", "accountId": "123456789012", "accessKeyId": "", "userName": "Alice" }

userIdentity avec des informations d'identification de sécurité temporaires

L'exemple suivant présente un élément userIdentity pour une demande faite avec des informations d'identification de sécurité temporaires obtenues en assumant un rôle IAM. L'élément contient des détails supplémentaires concernant le rôle qui a été assumé pour obtenir des informations d'identification.

"userIdentity": { "type": "AssumedRole", "principalId": "AROAIDPPEZS35WEXAMPLE:AssumedRoleSessionName", "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed/MySessionName", "accountId": "123456789012", "accessKeyId": "", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROAIDPPEZS35WEXAMPLE", "arn": "arn:aws:iam::123456789012:role/RoleToBeAssumed", "accountId": "123456789012", "userName": "RoleToBeAssumed" }, "signInSessionArn": "arn:aws:signin:us-east-1:123456789012:session/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "attributes": { "mfaAuthenticated": "false", "creationDate": "20131102T010628Z" } } }

userIdentity pour une demande effectuée au nom d'un utilisateur IAM Identity Center

L'exemple suivant présente un élément userIdentity pour une demande faite au nom d'un utilisateur IAM Identity Center.

"userIdentity": { "type": "IdentityCenterUser", "accountId": "123456789012", "onBehalfOf": { "userId": "544894e8-80c1-707f-60e3-3ba6510dfac1", "identityStoreArn": "arn:aws:identitystore::123456789012:identitystore/d-9067642ac7" }, "credentialId": "EXAMPLEVHULjJdTUdPJfofVa1sufHDoj7aYcOYcxFVllWR_Whr1fEXAMPLE" }

Pour en savoir plus sur la façon dont vous pouvez utiliser userId, identityStoreArn, et credentialId, voir Identification de l'utilisateur et de la session dans IAM Identity Center initiée par l'utilisateur CloudTrail événements dans le Guide de l'utilisateur d'IAM Identity Center.

userIdentity pour une demande faite par un AWS Utilisateur Builder ID

L'exemple suivant montre un userIdentity élément pour une demande faite par un AWS ID du constructeur utilisateur. AWS Builder ID est un profil personnel qui donne accès à certains outils et services, notamment AWS Builder Center, développeur Amazon Q et AWS Formation et certification. Le BuilderIdUser le type apparaît dans CloudTrail événements lorsqu'une demande d'API est autorisée à l'aide d'un IAM Identity Center OAuth-jeton d'accès émis (authentification du porteur). Ce jeton est associé à un AWS ID du constructeur.

"userIdentity": { "type": "BuilderIdUser", "onBehalfOf": { "userId": "544894e8-80c1-707f-60e3-3ba6510dfac1", "identityStoreArn": "arn:aws:identitystore::aws:identitystore/builderid" }, "credentialId": "ABCDefGhiJKLMn11Lmn_1AbCDEFgHijk-AaBCdEFGHIjKLmnOPqrs11abEXAMPLE" }

Contrairement à IdentityCenterUser événements, BuilderIdUser les événements n'incluent pas accountId terrain parce que AWS Builder ID est un AWS-identité gérée qui n'est pas associée à un client spécifique Compte AWS.

Pour plus d'informations sur AWS Builder ID, voir Connectez-vous avec AWS ID du constructeur dans le AWS Sign-In Guide de l'utilisateur.

userIdentity avec demande initiée par le fournisseur du produit

Toutes les actions effectuées par les fournisseurs de produits à l'aide d'un accès délégué temporaire sont automatiquement enregistrées CloudTrail. Cela fournit une visibilité et une auditabilité complètes de l'activité des fournisseurs de produits dans votre AWS compte. Vous pouvez identifier quelles actions ont été entreprises par les fournisseurs de produits, à quel moment elles se sont produites et quel compte de fournisseur de produits les a effectuées.

Pour vous aider à faire la distinction entre les actions entreprises par vos propres responsables IAM et celles prises par les fournisseurs de produits dotés d'un accès délégué, CloudTrail les événements incluent un nouveau champ appelé invokedByDelegate dans le cadre de userIdentity élément. Ce champ contient AWS ID de compte du fournisseur du produit, ce qui facilite le filtrage et l'audit de toutes les actions déléguées.

L'exemple suivant montre un userIdentity élément correspondant à une action effectuée par un fournisseur de produits à l'aide d'un accès délégué temporaire.

"userIdentity": { "type": "AssumedRole", "principalId": "AROAI...", "arn": "arn:aws:sts::123456789012:assumed-role/Alice/Session", "accountId": "123456789012", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROAI...", "arn": "arn:aws:iam::123456789012:role/Alice", "accountId": "123456789012", "userName": "Alice" }, "attributes": { "mfaAuthenticated": "false", "creationDate": "20131102T010628Z" } }, "invokedByDelegate": { "accountId": "999999999999" } }

Le invokedByDelegate le champ contient le AWS ID de compte du fournisseur du produit qui a effectué l'action à l'aide de l'accès délégué. Dans cet exemple, le compte 999999999999 (le fournisseur du produit) a effectué une action sur le compte 123456789012 (le compte client).

Champs

Les champs suivants peuvent apparaître dans un élément userIdentity.

type

Type d’identité. Les valeurs suivantes sont possibles :

  • Root — La demande a été faite auprès de votre Compte AWS informations d'identification. Si le type de userIdentity est Root et que vous définissez un alias pour votre compte, le champ userName contient l'alias de votre compte. Pour plus d'informations, veuillez consulter Votre ID de compte Compte AWS et son alias.

  • IAMUser - La demande a été effectuée avec les informations d'identification d'un utilisateur IAM.

  • AssumedRole – La demande a été effectuée avec des informations d'identification de sécurité temporaires qui ont été obtenues avec un rôle en passant un appel à l'API AWS Security Token Service (AWS STS) AssumeRole. Cela peut inclure rôles pour Amazon EC2 et accès à l'API entre comptes.

  • Role – La demande a été effectuée avec une identité IAM persistante qui dispose d'autorisations spécifiques. L'émetteur des sessions de rôle est toujours le rôle. Pour plus d'informations sur les rôles, consultez Termes et concepts relatifs aux rôles dans le Guide de l'utilisateur IAM.

  • FederatedUser — La demande a été faite à l'aide d'informations de sécurité temporaires obtenues lors d'un appel au AWS STS GetFederationToken API. L'élément sessionIssuer indique si l'API a été appelée avec les informations d'identification utilisateur racine ou IAM.

    Pour en savoir plus sur les informations d'identification de sécurité temporaires, consultez Informations d'identification de sécurité temporaires dans le Guide de l'utilisateur IAM.

  • Directory – La demande a été faite à un directory service et le type est inconnu. Les services d'annuaire incluent les suivants : Amazon WorkDocs et AWS Quick.

  • AWSAccount — La demande a été faite par un autre Compte AWS

  • AWSService — La demande a été faite par un Compte AWS qui appartient à Service AWS. Par exemple, AWS Elastic Beanstalk assume un rôle IAM dans votre compte pour appeler d'autres Services AWS en votre nom.

  • IdentityCenterUser : la demande a été effectuée au nom d'un utilisateur IAM Identity Center.

  • BuilderIdUser — La demande a été faite par un AWS Utilisateur Builder ID. Contrairement à IdentityCenterUser, le BuilderIdUser le type n'inclut pas de accountId terrain parce que AWS Builder ID est un AWS-identité gérée non liée à un compte client spécifique.

  • Unknown — La demande a été faite avec un type d'identité qui CloudTrail Impossible de déterminer.

Facultatif : False

AWSAccount et AWSService apparaissent pour type dans vos journaux lorsqu'il y a un accès entre comptes à l'aide d'un rôle IAM que vous possédez.

Exemple : Cross-account accès initié par un autre AWS compte
  1. Vous possédez un rôle IAM dans votre compte.

  2. Un autre AWS le compte passe à ce rôle pour assumer le rôle associé à votre compte.

  3. Etant donné que vous possédez le rôle IAM, vous recevez un journal qui indique que l'autre compte a endossé le rôle. Le type est AWSAccount. Pour un exemple d'entrée de journal, voir AWS STS Événement API dans CloudTrail fichier journal.

Exemple : Cross-account accès initié par un AWS web
  1. Vous possédez un rôle IAM dans votre compte.

  2. Un AWS compte détenu par un AWS le service assume ce rôle.

  3. Etant donné que vous possédez le rôle IAM, vous recevez un journal qui indique que le service AWS a endossé le rôle. Le type est AWSService.

userName

Nom descriptif de l'identité qui a réalisé l'appel. La valeur qui s'affiche dans userName s'appuie sur la valeur de type. Le tableau suivant illustre la relation entre type et userName :

type userName Description
Root (aucun alias défini) Absent Si vous n'avez pas défini d'alias pour votre Compte AWS, le userName le champ n'apparaît pas. Pour plus d'informations sur les alias de compte, consultez Votre Compte AWS ID et son alias. Notez que le champ userName ne peut pas contenir Root, car Root est un type d'identité, et pas un nom d'utilisateur.
Root (alias défini) Alias du compte Pour plus d'informations sur Compte AWS alias, voir Votre Compte AWS ID et son alias.
IAMUser Nom d'utilisateur de l'utilisateur IAM

AssumedRole

Absent Pour AssumedRole tapez, vous pouvez trouver le userName champ dans sessionContext dans le cadre du Émetteur de session élément. Pour obtenir un exemple de saisie, consultez Exemples.

Role

User-defined Les sections sessionContext et sessionIssuer contiennent des informations concernant l'identité qui a publié la séance pour le rôle.
FederatedUser Absent Les sections sessionContext et sessionIssuer contiennent des informations concernant l'identité qui a publié la session pour l'utilisateur fédéré.
Directory Peut être présent Par exemple, la valeur peut être l'alias du compte ou l'adresse e-mail de l'ID de compte Compte AWS.
AWSService Absent
AWSAccount Absent
IdentityCenterUser Non présent*

La section onBehalfOf contient des informations sur l'ID de l'utilisateur IAM Identity Center et l'ARN du magasin d'identités pour lesquels l'appel a été effectué. Pour en savoir plus sur la façon dont vous pouvez utiliser ces deux champs, voir Identification de l'utilisateur et de la session dans IAM Identity Center initiée par l'utilisateur CloudTrail événements
 dans le guide de l'utilisateur d'IAM Identity Center.

* IAM Identity Center émet le userName champ situé sous le additionalEventData élément de connexion en deux CloudTrail événements. Pour plus d'informations, voir Nom d'utilisateur lors de la connexion CloudTrail événements dans le guide de l'utilisateur d'IAM Identity Center.

BuilderIdUser Absent Le onBehalfOf la section contient l'identifiant de l'utilisateur du Builder ID userId et le AWS-géré identityStoreArn (arn:aws:identitystore::aws:identitystore/builderid). Utilisez ces champs pour identifier l'utilisateur du Builder ID.
Unknown Peut être présent Par exemple, la valeur peut être l'alias du compte ou l'adresse e-mail de l'ID de compte Compte AWS.
Note

Le champ userName contient la chaîne HIDDEN_DUE_TO_SECURITY_REASONS lorsque l'événement enregistré est un échec de connexion à la console provoqué par la saisie d'un nom d'utilisateur incorrect. Dans ce cas, CloudTrail n'enregistre pas le contenu car le texte risque de contenir des informations sensibles, comme dans les exemples suivants :

  • Un utilisateur tape par erreur un mot de passe dans le champ de nom d'utilisateur.

  • Un utilisateur clique sur le lien correspondant AWS page de connexion du compte, mais saisissez ensuite le numéro de compte d'un autre compte.

  • Un utilisateur tape accidentellement le nom d'un compte de messagerie personnelle, un identifiant de connexion bancaire ou un autre ID privé.

Facultatif : True

principalId

Identifiant unique de l'entité qui a effectué l'appel. Pour les demandes effectuées avec des informations d'identification de sécurité temporaires, cette valeur comprend le nom de session transmis à l'appel d'API AssumeRole, AssumeRoleWithWebIdentity ou GetFederationToken.

Facultatif : True

arn

L'Amazon Resource Name (ARN) du principal qui a effectué l'appel. La dernière partie de l'ARN contient l'utilisateur ou le rôle qui a réalisé l'appel.

Facultatif : True

accountId

Compte propriétaire de l'entité qui a accordé les autorisations pour la demande. Si la demande a été effectuée avec des informations d'identification de sécurité temporaires, il s'agit du compte qui possède l'utilisateur ou le rôle IAM utilisé pour obtenir les informations d'identification.

Si la demande a été faite avec un jeton d'accès autorisé IAM Identity Center, il s'agit du compte propriétaire de l'instance IAM Identity Center.

Note

Pour BuilderIdUser types d'événements, le accountId le champ n'est pas présent. AWS Builder ID est un AWS-identité gérée qui n'est pas associée à un client spécifique Compte AWS. Le onBehalfOf L'élément identifie plutôt l'utilisateur du Builder ID.

Facultatif : True

accessKeyId

ID de clé d’accès utilisé pour signer la demande. Si la demande a été faite avec des informations d’identification de sécurité temporaires, il s’agit de l’ID de clé d’accès des informations d’identification temporaires. Pour des raisons de sécurité,accessKeyId peut ne pas être présent ou être affiché sous la forme d'une chaîne vide.

Facultatif : True

sessionContext

Si la demande a été effectuée avec les informations d'identification de sécurité temporaires, sessionContext fournit des informations sur la session créée pour ces informations d'identification. Une session est créée lorsque vous appelez une API qui renvoie des informations d'identification temporaires. Les utilisateurs créent également des sessions lorsqu'ils travaillent dans la console et font des demandes avec des API qui incluent l'authentification multifactorielle. Les attributs suivants peuvent apparaître dans sessionContext:

  • sessionIssuer — Si un utilisateur fait une demande avec des informations d'identification de sécurité temporaires, sessionIssuer fournit des informations sur la manière dont l'utilisateur a obtenu ses informations d'identification. Par exemple, s'il a obtenu des informations d'identification temporaires en endossant un rôle, cet élément fournit des informations sur le rôle endossé. S'ils ont obtenu des informations d'identification avec les informations d'identification de l'utilisateur root ou IAM pour appeler AWS STS GetFederationToken, l'élément fournit des informations sur le compte root ou l'utilisateur IAM. Cet élément prend en charge les attributs suivants :

    • type - La source des informations d'identification de sécurité temporaires, par exemple Root, IAMUser ou Role.

    • userName - Le nom descriptif de l'utilisateur ou du rôle qui a établi la session. La valeur qui s'affiche dépend du sessionIssuer d'identité type. Le tableau suivant illustre la relation entre sessionIssuer type et userName :

      sessionIssuer type userName Description
      Root (aucun alias défini) Absent Si vous n'avez pas défini d'alias pour votre compte, le champ userName n'apparaît pas. Pour plus d'informations sur Compte AWS alias, voir Votre Compte AWS ID et son alias. Notez que le champ userName ne peut pas contenir Root, car Root est un type d'identité, pas un nom d'utilisateur.
      Root (alias défini) Alias du compte Pour plus d'informations sur Compte AWS alias, voir Votre AWS ID de compte et son alias.
      IAMUser Le nom d'utilisateur de l'utilisateur IAM Cela s'applique également lorsqu'un utilisateur fédéré utilise une session établie par IAMUser.
      Role Nom du rôle Un rôle assumé par un utilisateur IAM, Service AWS, ou utilisateur fédéré d'identité Web dans une session de rôle.
    • principalId : l'ID interne de l'entité qui a été utilisée pour obtenir des informations d'identification.

    • arn - L'ARN de la source (compte, utilisateur IAM ou rôle) qui a été utilisé pour obtenir des informations d'identification de sécurité temporaires.

    • accountId - Le compte propriétaire de l'entité qui a été utilisée pour obtenir des informations d'identification.

  • webIdFederationData — Si la demande a été faite avec des informations de sécurité temporaires obtenues par fédération de l'identité Web, webIdFederationData répertorie les informations relatives au fournisseur d'identité.

    Cet élément prend en charge les attributs suivants :

    • federatedProvider - Le nom principal du fournisseur d'identités (par exemple, www.amazon.com pour Login with Amazon ou accounts.google.com pour Google).

    • attributes - ID d'application et ID d'utilisateur tels qu'indiqués par le fournisseur (par exemple, www.amazon.com:app_id et www.amazon.com:user_id pour Login with Amazon).

    Note

    L'omission de ce champ ou la présence de ce champ avec une valeur vide signifie qu'il n'y a aucune information sur le fournisseur d'identité.

  • assumedRoot — La valeur est true pour une session temporaire lorsqu'un compte de gestion ou un administrateur délégué appelle AWS STS AssumedRoot. Pour plus d'informations, voir Suivez les tâches privilégiées dans CloudTrail dans le Guide de l'utilisateur IAM. Il s'agit d'un champ facultatif.

  • signInSessionArn — L'ARN de la session de connexion qui prend en charge la demande, sous la forme arn:aws:signin:<region>:<account-id>:session/<uuid>. Cet ARN est la valeur de aws:SignInSessionArn clé de condition globale. La clé identifie la session de manière plus spécifique que l'ARN principal. Utilisez-le pour auditer l'activité de l'API par session de connexion ou pour rédiger des politiques qui révoquent une session spécifique.

    La session à l'origine de la demande peut être une session de connexion. La session peut également provenir d'un jeton d'accès que vous obtenez via un flux machine OAuth ou Signature Version 4 (SigV4). CloudTrail ne modifie pas l'ARN du principal. CloudTrail enregistre ce champ sur les événements d'API qui se produisent au cours d'une telle session. Il s'agit d'un champ facultatif.

  • attributes — Les attributs de la session.

    • creationDate - La date et l'heure auxquelles les informations d'identification de sécurité temporaires ont été émises. Représentées en notation base ISO 8601.

    • mfaAuthenticated : la valeur est true si l'utilisateur root ou l'utilisateur IAM dont les informations d'identification ont été utilisées pour la demande a également été authentifié avec un périphérique MFA. Dans le cas contraire, false.

  • sourceIdentity— Consultez AWS STS identité de la source dans cette rubrique. Le sourceIdentity Ce champ apparaît dans les événements lorsque les utilisateurs assument un rôle IAM pour effectuer une action. sourceIdentity identifie l'identité de l'utilisateur d'origine à l'origine de la demande, qu'il s'agisse d'un utilisateur IAM, d'un rôle IAM, d'un utilisateur authentifié via SAML-based fédération, ou un utilisateur authentifié via une fédération d'identité Web conforme à OpenID Connect (OIDC). Pour plus d'informations sur la configuration AWS STS pour collecter des informations sur l'identité de la source, voir Surveiller et contrôler les actions entreprises avec les rôles assumés dans le Guide de l'utilisateur IAM.

  • ec2RoleDelivery : la valeur est 1.0 si les informations d'identification ont été fournies par le service Instance Metadata Service Version 1 (IMDSv1) d'Amazon EC2. La valeur est 2.0 si les informations d'identification ont été fournies à l'aide du nouveau schéma IMDS.

    AWS les informations d'identification fournies par le service de métadonnées d'instance Amazon EC2 (IMDS) incluent un ec2 :RoleDelivery Clé de contexte IAM. Cette clé de contexte permet d'imposer facilement l'utilisation du nouveau schéma, service par service ou ressource par ressource, en utilisant la clé de contexte comme condition dans les politiques IAM, les politiques de ressources ou AWS Organizations politiques de contrôle des services. Pour plus d'informations, consultez Métadonnées d'instance et données utilisateur dans le Guide de l'utilisateur Amazon EC2.

Facultatif : True

invokedBy

Le nom du Service AWS qui a fait la demande, lorsqu'une demande est faite par un Service AWS tels qu'Amazon EC2 Auto Scaling ou AWS Elastic Beanstalk. Ce champ n'est présent que lorsqu'une demande est faite par un Service AWS. Cela inclut les demandes faites par des services utilisant des sessions d'accès direct (FAS), Service AWS principaux, rôles liés à un service ou rôles de service utilisés par un Service AWS.

Facultatif : True

invokedByDelegate

Suit les demandes faites par les fournisseurs de produits à l'aide de l'accès délégué temporaire dans votre AWS compte. Ce champ apparaît uniquement lorsqu'un fournisseur de produits lance une demande d'API à l'aide d'autorisations déléguées. S'il est présent, invokedByDelegate fournit des informations sur le compte du fournisseur du produit à l'origine de la demande. Cet élément possède l'attribut suivant :

  • accountId — Les AWS ID de compte du fournisseur du produit à l'origine de la demande.

Pour plus d'informations et un exemple JSON d'accès délégué dans CloudTrail événements, voir CloudTrail entrées pour les informations d'identification de sécurité temporaires dans le Guide de l'utilisateur IAM.

Facultatif : True

onBehalfOf

Si la demande a été faite par un appelant de l'IAM Identity Center ou AWS Utilisateur Builder ID, onBehalfOf fournit des informations sur l'utilisateur pour le compte duquel l'appel a été passé. Cet élément prend en charge les attributs suivants :

  • userId — L'ID de l'utilisateur de l'IAM Identity Center ou AWS Utilisateur Builder ID pour le compte duquel l'appel a été passé.

  • identityStoreArn — L'ARN de la boutique d'identités. Pour les utilisateurs d'IAM Identity Center, il s'agit de l'ARN de la banque d'identités de l'organisation. Pour AWS Utilisateurs de Builder ID, la valeur est arn:aws:identitystore::aws:identitystore/builderid.

Facultatif : True

inScopeOf

Si la demande a été faite dans le cadre d'un Service AWS, comme Lambda ou Amazon ECS, il fournit des informations sur la ressource ou les informations d'identification liées à la demande. Cet élément peut contenir les attributs suivants :

  • sourceArn — L'ARN de la ressource qui a appelé la demande de service à service.

  • sourceAccount — L'identifiant du compte du propriétaire du sourceArn. Il apparaît avec sourceArn.

  • issuerType — Le type de ressource de credentialsIssuedTo. Par exemple : AWS::Lambda::Function.

  • credentialsIssuedTo — La ressource liée à l'environnement dans lequel les accréditations ont été émises.

Facultatif : True

credentialId

L'ID des informations d'identification de la demande. Ceci n'est défini que lorsque l'appelant utilise un jeton porteur, tel qu'un jeton d'accès autorisé IAM Identity Center.

Facultatif : True

Valeurs pour AWS STS API avec SAML et fédération d'identités Web

AWS CloudTrail supporte la journalisation AWS Security Token Service (AWS STS) Appels d'API effectués à l'aide du langage SAML (Security Assertion Markup Language) et de la fédération d'identités Web. Lorsqu'un utilisateur passe un appel au AssumeRoleWithSAML et AssumeRoleWithWebIdentity API, CloudTrail enregistre l'appel et transmet l'événement à votre compartiment Amazon S3.

L'élément userIdentity de ces API contient les valeurs suivantes.

type

Type d'identité.

  • SAMLUser - La demande a été effectuée avec l'assertion SAML.

  • WebIdentityUser - La demande a été effectuée par un fournisseur de fédération d'identité Web.

principalId

Identifiant unique de l'entité qui a effectué l'appel.

  • Pour SAMLUser, il s'agit d'une combinaison de clés saml:namequalifier et saml:sub.

  • Pour WebIdentityUser, il s'agit d'une combinaison de l'émetteur, l'ID de l'application et l'ID de l'utilisateur.

userName

Nom de l'identité qui a réalisé l'appel.

  • Pour SAMLUser, il s'agit de la clé saml:sub.

  • Pour WebIdentityUser, il s'agit de l'ID d'utilisateur.

identityProvider

Nom principal du fournisseur d'identité externes. Ce champ s'affiche uniquement pour les types SAMLUser ou WebIdentityUser.

  • Pour SAMLUser, il s'agit de la clé saml:namequalifier pour l'assertion SAML.

  • Pour WebIdentityUser, il s'agit du nom d'auteur du fournisseur de fédération d'identité Web. Il peut s'agir d'un fournisseur que vous avez configuré, tel que :

    • cognito-identity.amazon.com pour Amazon Cognito

    • www.amazon.com pour Login with Amazon

    • accounts.google.com pour Google

    • graph.facebook.com pour Facebook

Voici un exemple d'élément userIdentity pour l'action AssumeRoleWithWebIdentity.

"userIdentity": { "type": "WebIdentityUser", "principalId": "accounts.google.com:application-id.apps.googleusercontent.com:user-id", "userName": "user-id", "identityProvider": "accounts.google.com" }

Par exemple, des journaux expliquant comment userIdentity élément apparaît pour SAMLUser et WebIdentityUser types, voir Journalisation IAM et AWS STS Appels d'API avec AWS CloudTrail.

AWS STS identité de la source

Un administrateur IAM peut configurer AWS Security Token Service pour obliger les utilisateurs à spécifier leur identité lorsqu'ils utilisent des informations d'identification temporaires pour assumer des rôles. Le champ sourceIdentity apparait dans les événements lorsque les utilisateurs assument un rôle IAM ou exécutent des actions avec le rôle assumé.

Le sourceIdentity le champ identifie l'identité de l'utilisateur d'origine à l'origine de la demande, qu'il s'agisse d'un utilisateur IAM, d'un rôle IAM, d'un utilisateur authentifié en utilisant SAML-based fédération, ou un utilisateur authentifié à l'aide d'une fédération d'identité Web conforme à OpenID Connect (OIDC). Une fois que l'administrateur IAM a configuré AWS STS, CloudTrail journaux sourceIdentity informations relatives aux événements et aux lieux suivants figurant dans le dossier de l'événement :

  • Le AWS STS AssumeRole, AssumeRoleWithSAML, ou AssumeRoleWithWebIdentity appels effectués par une identité d'utilisateur lorsqu'elle assume un rôle. sourceIdentity se trouve dans requestParameters bloc du AWS STS appels.

  • Le AWS STS AssumeRole, AssumeRoleWithSAML, ou AssumeRoleWithWebIdentity appels effectués par une identité d'utilisateur si elle utilise un rôle pour assumer un autre rôle, appelé enchaînement des rôles. sourceIdentity se trouve dans requestParameters bloc du AWS STS appels.

  • Le AWS appels d'API de service effectués par l'identité de l'utilisateur en assumant un rôle et en utilisant les informations d'identification temporaires attribuées par AWS STS. Dans les événements d'API de service, sourceIdentity se trouve dans le bloc sessionContext. Par exemple, si une identité utilisateur crée un nouveau compartiment S3, sourceIdentity se produit dans le bloc sessionContextde l'événement CreateBucket.

Pour plus d'informations sur la configuration AWS STS pour collecter des informations sur l'identité de la source, voir Surveiller et contrôler les actions entreprises avec les rôles assumés dans le Guide de l'utilisateur IAM. Pour plus d'informations sur AWS STS événements qui sont enregistrés CloudTrail, voir Journalisation IAM et AWS STS Appels d'API avec AWS CloudTrail dans le Guide de l'utilisateur IAM.

Les exemples suivants sont des extraits d'événements qui montrent la sourceIdentity.

Exemple de la section requestParameters

Dans l'exemple d'extrait d'événement suivant, un utilisateur crée un AWS STS AssumeRole demande, et définit une identité de source, représentée ici par source-identity-value-set. L'utilisateur assume un rôle représenté par le rôle ARN arn:aws:iam::123456789012:role/Assumed_Role. Le champ sourceIdentity se trouve dans le bloc requestParameters de l'événement.

"eventVersion": "1.05", "userIdentity": { "type": "AWSAccount", "principalId": "AIDAJ45Q7YFFAREXAMPLE", "accountId": "123456789012" }, "eventTime": "2020-04-02T18:20:53Z", "eventSource": "sts.amazonaws.com", "eventName": "AssumeRole", "awsRegion": "us-east-1", "sourceIPAddress": "203.0.113.64", "userAgent": "aws-cli/1.16.96 Python/3.6.0 Windows/10 botocore/1.12.86", "requestParameters": { "roleArn": "arn:aws:iam::123456789012:role/Assumed_Role", "roleSessionName": "Test1", "sourceIdentity": "source-identity-value-set", },

Exemple de la section responseElements

Dans l'exemple d'extrait d'événement suivant, un utilisateur crée un AWS STS AssumeRole demande pour assumer un rôle nommé Developer_Role, et définit une identité de source, Admin. L'utilisateur assume un rôle représenté par le rôle ARN arn:aws:iam::111122223333:role/Developer_Role. Le champ sourceIdentity est affiché à la fois dans les blocs requestParameters et responseElements de l'événement. Les informations d'identification temporaires utilisées pour assumer le rôle, la chaîne de jeton de session, ainsi que l'ID de rôle assumé, le nom de session et l'ARN de session sont affichés dansle bloc responseElements, ainsi que l'identité source.

"requestParameters": { "roleArn": "arn:aws:iam::111122223333:role/Developer_Role", "roleSessionName": "Session_Name", "sourceIdentity": "Admin" }, "responseElements": { "credentials": { "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "expiration": "Jan 22, 2021 12:46:28 AM", "sessionToken": "XXYYaz... EXAMPLE_SESSION_TOKEN XXyYaZAz" }, "assumedRoleUser": { "assumedRoleId": "AROACKCEVSQ6C2EXAMPLE:Session_Name", "arn": "arn:aws:sts::111122223333:assumed-role/Developer_Role/Session_Name" }, "sourceIdentity": "Admin" } ...

Exemple de la section sessionContext

Dans l'exemple d'extrait d'événement suivant, un utilisateur assume un rôle nommé DevRole pour appeler un AWS API de service. L'utilisateur définit une identité de source, représentée ici par source-identity-value-set. Le champ sourceIdentity se trouve dans le bloc sessionContext, à l'intérieur du bloc userIdentity de l'événement.

{ "eventVersion": "1.08", "userIdentity": { "type": "AssumedRole", "principalId": "AROAJ45Q7YFFAREXAMPLE: Dev1", "arn": "arn: aws: sts: : 123456789012: assumed-role/DevRole/Dev1", "accountId": "123456789012", "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROAJ45Q7YFFAREXAMPLE", "arn": "arn: aws: iam: : 123456789012: role/DevRole", "accountId": "123456789012", "userName": "DevRole" }, "webIdFederationData": {}, "attributes": { "mfaAuthenticated": "false", "creationDate": "2021-02-21T23: 46: 28Z" }, "sourceIdentity": "source-identity-value-set" } } }