View a markdown version of this page

CloudTrail elemento UserIdentity - AWS CloudTrail

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CloudTrail elemento UserIdentity

AWS Identity and Access Management (IAM) fornisce diversi tipi di identità. L'elemento userIdentity include dettagli sul tipo di identità IAM che ha effettuato la richiesta e sulle credenziali utilizzate. Se sono state utilizzate credenziali temporanee, l'elemento mostra il modo in cui tali credenziali sono state ottenute.

Esempi

userIdentity con credenziali utente IAM

L'esempio seguente mostra l'elemento userIdentity di una semplice richiesta effettuata con le credenziali dell'utente IAM denominato Alice.

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

userIdentity con credenziali di sicurezza temporanee

L'esempio seguente mostra un elemento userIdentity per una richiesta effettuata con le credenziali di sicurezza temporanee ottenute mediante l'assunzione del ruolo IAM. L'elemento contiene ulteriori dettagli sul ruolo assunto per ottenere le credenziali.

"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 per una richiesta effettuata per conto di un utente del Centro identità IAM

L'esempio seguente mostra un elemento userIdentity per una richiesta effettuata per conto di un utente del Centro identità IAM.

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

Per saperne di più su come puoi usare userId, identityStoreArn, e credentialId, vedi Identificazione dell'utente e della sessione in IAM Identity Center avviata dall'utente CloudTrail eventi nel Guida per l'utente di IAM Identity Center.

userIdentity per una richiesta effettuata da un AWS utente Builder ID

L'esempio seguente mostra un userIdentity elemento per una richiesta effettuata da un AWS ID del costruttore utente. AWS Builder ID è un profilo personale che fornisce l'accesso a strumenti e servizi selezionati, tra cui AWS Builder Center, Amazon Q Developer e AWS Formazione e certificazione. La BuilderIdUser il tipo appare in CloudTrail eventi quando una richiesta API viene autorizzata utilizzando un IAM Identity Center OAuth-token di accesso emesso (autenticazione al portatore). Questo token è associato a un AWS ID del costruttore.

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

A differenza IdentityCenterUser eventi, BuilderIdUser gli eventi non includono un accountId campo perché AWS L'ID del costruttore è un AWS-identità gestita che non è associata a un cliente specifico Account AWS.

Per ulteriori informazioni su AWS Builder ID, vedi Accedi con AWS ID costruttore nel AWS Sign-In Guida per l'utente.

userIdentity con richiesta avviata dal fornitore del prodotto

Tutte le azioni eseguite dai fornitori di prodotti utilizzando l'accesso delegato temporaneo vengono registrate automaticamente CloudTrail. Ciò fornisce visibilità e verificabilità complete dell'attività dei fornitori di prodotti nel tuo AWS account. È possibile identificare quali azioni sono state intraprese dai fornitori di prodotti, quando sono state eseguite e quale account del fornitore di prodotto le ha eseguite.

Per aiutarti a distinguere tra le azioni intraprese dai tuoi responsabili IAM e quelle intraprese dai fornitori di prodotti con accesso delegato, CloudTrail gli eventi includono un nuovo campo chiamato invokedByDelegate sotto userIdentity elemento. Questo campo contiene AWS ID dell'account del fornitore del prodotto, che semplifica il filtraggio e il controllo di tutte le azioni delegate.

L'esempio seguente mostra un userIdentity elemento per un'azione eseguita da un fornitore di prodotti utilizzando un accesso delegato temporaneo.

"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" } }

Il invokedByDelegate il campo contiene AWS ID dell'account del fornitore del prodotto che ha eseguito l'azione utilizzando l'accesso delegato. In questo esempio, l'account 44449999 (il fornitore del prodotto) ha eseguito un'azione nell'account 123456789012 (l'account del cliente).

Campi

In un elemento userIdentity possono essere visualizzati i seguenti campi.

type

Tipo dell'identità. I valori possibili sono i seguenti:

  • Root — La richiesta è stata effettuata con il tuo Account AWS credenziali. Se il tipo di userIdentity è Root e imposti un alias per il tuo account, il campo userName conterrà l'alias del tuo account. Per ulteriori informazioni, consulta ID account Account AWS e relativo alias.

  • IAMUser – La richiesta è stata effettuata con le credenziali di un utente IAM.

  • AssumedRole – La richiesta è stata effettuata con le credenziali di sicurezza temporanee ottenute con un ruolo tramite una chiamata all'API Servizio di token di sicurezza AWS (AWS STS)AssumeRole. Questo può includere ruoli per Amazon EC2 e accesso alle API per più account.

  • Role – La richiesta è stata effettuata con un'identità IAM persistente che dispone delle autorizzazioni specifiche. L'emittente delle sessioni di ruolo è sempre il ruolo. Per ulteriori informazioni sui ruoli consulta Termini e concetti dei ruoli nella Guida per l'utente IAM.

  • FederatedUser — La richiesta è stata effettuata con credenziali di sicurezza temporanee ottenute da una chiamata al AWS STS GetFederationToken API. L'elemento sessionIssuer indica se l'API è stata chiamata con le credenziali dell'utente root o con quelle dell'utente IAM.

    Per ulteriori informazioni sulle credenziali di sicurezza temporanee, consulta la sezione relativa alle credenziali di sicurezza temporanee nella Guida per l'utente IAM.

  • Directory - La richiesta è stata effettuata a un servizio directory e il tipo è sconosciuto. I servizi di directory includono quanto segue: Amazon WorkDocs e AWS Quick.

  • AWSAccount — La richiesta è stata fatta da un altro Account AWS

  • AWSService — La richiesta è stata fatta da un Account AWS che appartiene a un Servizio AWS. Ad esempio AWS Elastic Beanstalk assume un ruolo IAM nel tuo account per chiamare altri Servizi AWS per tuo conto.

  • IdentityCenterUser: la richiesta è stata effettuata per conto di un utente del Centro identità IAM

  • BuilderIdUser — La richiesta è stata fatta da un AWS ID utente Builder. A differenza IdentityCenterUser, il BuilderIdUser il tipo non include un accountId campo perché AWS L'ID del costruttore è un AWS-identità gestita non associata a un account cliente specifico.

  • Unknown — La richiesta è stata effettuata con un tipo di identità che CloudTrail non posso determinare.

Optional: False

Vengono visualizzati i valori AWSAccount e AWSService nel campo type dei log in caso di accesso tra più account tramite un ruolo IAM di tua proprietà.

Esempio: Cross-account accesso avviato da un altro AWS account
  1. Tu sei il proprietario di un ruolo IAM nel tuo account.

  2. Un altro AWS l'account passa a quel ruolo per assumere il ruolo del tuo account.

  3. Poiché sei il proprietario del ruolo IAM, riceverai un log che mostra l'altro account che ha assunto il ruolo. Il valore del campo type è AWSAccount. Per un esempio di voce di registro, vedi AWS STS Evento API in CloudTrail file di registro.

Esempio: Cross-account accesso avviato da un AWS service
  1. Tu sei il proprietario di un ruolo IAM nel tuo account.

  2. Un AWS account di proprietà di un AWS il servizio assume tale ruolo.

  3. Poiché sei il proprietario del ruolo IAM, riceverai un log che mostra il servizio AWS che ha assunto il ruolo. Il valore del campo type è AWSService.

userName

Nome descrittivo dell'identità che ha effettuato la chiamata. Il valore visualizzato nel campo userName si basa sul valore di type. La tabella seguente mostra la relazione tra type e userName:

type userName Description
Root (nessun alias impostato) Non presente Se non hai impostato un alias per il tuo Account AWS, il userName il campo non viene visualizzato. Per ulteriori informazioni sugli alias degli account, consulta Il tuo Account AWS ID e relativo alias. Il campo userName non può contenere Root perché Root è un tipo di identità e non un nome utente.
Root (alias impostato) Alias dell'account Per ulteriori informazioni su Account AWS alias, vedere I tuoi Account AWS ID e relativo alias.
IAMUser Nome utente dell'utente IAM

AssumedRole

Non presente Per AssumedRole tipo, puoi trovare il userName campo in sessionContext come parte del SessionIssuer elemento. Per una voce di esempio, consulta Esempi.

Role

User-defined Le sezioni sessionContext e sessionIssuer contengono informazioni sull'identità che ha creato la sessione per il ruolo.
FederatedUser Non presente Le sezioni sessionContext e sessionIssuer contengono informazioni sull'identità che ha creato la sessione per l'utente federato.
Directory Può essere presente Ad esempio, il valore può essere l'alias dell'account o l'indirizzo e-mail dell'ID account Account AWS associato.
AWSService Non presente
AWSAccount Non presente
IdentityCenterUser Non presente*

La sezione onBehalfOf contiene informazioni sull'ID utente del Centro identità IAM e sull'ARN dell'archivio di identità per cui è stata effettuata la chiamata. Per saperne di più su come utilizzare questi due campi, vedi Identificazione dell'utente e della sessione in IAM Identity Center avviata dall'utente CloudTrail eventi
 nella Guida per l'utente di IAM Identity Center.

* IAM Identity Center emette il userName campo sotto il additionalEventData elemento in due accessi CloudTrail eventi. Per ulteriori informazioni, vedere Nome utente al momento dell'accesso CloudTrail eventi nella Guida per l'utente di IAM Identity Center.

BuilderIdUser Non presente La onBehalfOf la sezione contiene l'ID utente del Builder userId e il AWS-gestito identityStoreArn (arn:aws:identitystore::aws:identitystore/builderid). Utilizza questi campi per identificare l'utente Builder ID.
Unknown Può essere presente Ad esempio, il valore può essere l'alias dell'account o l'indirizzo e-mail dell'ID account Account AWS associato.
Nota

Il campo userName contiene la stringa HIDDEN_DUE_TO_SECURITY_REASONS quando l'evento registrato corrisponde a un errore di accesso alla console causato dall'immissione errata del nome utente. In questo caso CloudTrail non registra i contenuti perché il testo potrebbe contenere informazioni sensibili, come negli esempi seguenti:

  • Un utente ha immesso accidentalmente una password nel campo del nome utente.

  • Un utente fa clic sul collegamento relativo a uno AWS pagina di accesso dell'account, ma poi digita il numero di account per un altro account.

  • Un utente immette accidentalmente il nome account di un account e-mail personale, un identificatore di accesso alla banca o a un altro ID privato.

Optional: True

principalId

Identificatore univoco per l'entità che ha effettuato la chiamata. Per le richieste effettuate con le credenziali di sicurezza temporanee, questo valore include il nome di sessione passato alla chiamata API AssumeRole, AssumeRoleWithWebIdentityo GetFederationToken.

Optional: True

arn

ARN (Amazon Resource Name) dell'entità che ha effettuato la chiamata. L'ultima sezione dell'ARN contiene l'utente o il ruolo che ha effettuato la chiamata.

Optional: True

accountId

Account che possiede l'entità che ha concesso le autorizzazioni per la richiesta. Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee, corrisponde all'account proprietario dell'utente o del ruolo IAM utilizzato per ottenere le credenziali.

Se la richiesta è stata effettuata con un token di accesso autorizzato del Centro identità IAM, questo è l'account proprietario dell'istanza del Centro identità IAM.

Nota

Per BuilderIdUser eventi di tipo, il accountId il campo non è presente. AWS L'ID del costruttore è un AWS-identità gestita che non è associata a un cliente specifico Account AWS. Il onBehalfOf l'elemento identifica invece l'utente Builder ID.

Optional: True

accessKeyId

ID della chiave di accesso utilizzata per firmare la richiesta. Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee, corrisponde all'ID della chiave di accesso delle credenziali temporanee. Per motivi di sicurezza, accessKeyId potrebbe non essere presente o potrebbe essere visualizzato come una stringa vuota.

Optional: True

sessionContext

Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee, sessionContext fornisce informazioni sulla sessione creata per tali credenziali. Le sessioni vengono create quando viene chiamata una qualsiasi API che restituisce le credenziali temporanee. Gli utenti creano le sessioni anche quando utilizzano la console e effettuano una richiesta con le API che includono l'autenticazione a più fattori (MFA). I seguenti attributi possono apparire in sessionContext:

  • sessionIssuer — Se un utente effettua una richiesta con credenziali di sicurezza temporanee, sessionIssuer fornisce informazioni su come l'utente ha ottenuto le credenziali. Ad esempio, se le credenziali di sicurezza temporanee sono state ottenute mediante l'assunzione di un ruolo, questo elemento fornisce informazioni sul ruolo assunto. Se le credenziali sono state ottenute con credenziali root o dell'utente IAM per effettuare la chiamata a AWS STS GetFederationToken, l'elemento fornisce informazioni sull'account root o sull'utente IAM. Questo elemento ha i seguenti attributi:

    • type - L'origine delle credenziali di sicurezza temporanee, ad esempio Root,IAMUser o Role.

    • userName - Il nome descrittivo dell'utente o del ruolo che ha creato la sessione. Il valore visualizzato dipende dal valore dell'identità sessionIssuer type. La tabella seguente mostra la relazione tra sessionIssuer type e userName:

      sessionIssuer tipo userName Description
      Root (nessun alias impostato) Non presente Se non hai configurato un alias per il tuo account, il campo userName non viene visualizzato. Per ulteriori informazioni su Account AWS alias, vedere I tuoi Account AWS ID e relativo alias. Il campo userName non può contenere Root perché Root è un tipo di identità e non un nome utente.
      Root (alias impostato) Alias dell'account Per ulteriori informazioni su Account AWS alias, vedere I tuoi AWS ID dell'account e relativo alias.
      IAMUser Nome utente dell'utente IAM Valido anche quando un utente federato utilizza una sessione creata da IAMUser.
      Role Nome del ruolo Un ruolo assunto da un utente IAM, Servizio AWS, o utente federato con identità web in una sessione di ruolo.
    • principalId: l'ID interno dell'entità utilizzata per ottenere le credenziali.

    • arn - L'ARN dell'origine (account, utente IAM o ruolo) utilizzata per ottenere le credenziali di sicurezza temporanee.

    • accountId - L'account proprietario dell'entità utilizzata per ottenere le credenziali.

  • webIdFederationData — Se la richiesta è stata effettuata con credenziali di sicurezza temporanee ottenute da federazione delle identità web, webIdFederationData elenca le informazioni sul provider di identità.

    Questo elemento ha i seguenti attributi:

    • federatedProvider - Il nome entità del provider di identità (ad esempio, www.amazon.com per Login with Amazon o accounts.google.com per Google).

    • attributes - L'ID applicazione e l'ID utente forniti dal provider (ad esempio, www.amazon.com:app_id e www.amazon.com:user_id per Login with Amazon).

    Nota

    L'omissione di questo campo o la presenza di questo campo con un valore vuoto indica che non ci sono informazioni sul provider di identità.

  • assumedRoot — Il valore è true per una sessione temporanea quando un account di gestione o un amministratore delegato chiama AWS STS AssumedRoot. Per ulteriori informazioni, vedere Tieni traccia delle attività privilegiate in CloudTrail nel Guida per l'utente IAM. Questo campo è opzionale.

  • signInSessionArn — L'ARN della sessione di accesso che supporta la richiesta, nel modulo arn:aws:signin:<region>:<account-id>:session/<uuid>. Questo ARN è il valore di aws:SignInSessionArn chiave di condizione globale. La chiave identifica la sessione in modo più specifico rispetto all'ARN principale. Utilizzala per controllare l'attività dell'API in base alla sessione di accesso o per scrivere politiche che revocano una sessione specifica.

    La sessione che dà origine alla richiesta può essere una sessione di accesso. La sessione può anche provenire da un token di accesso ottenuto tramite un flusso automatico OAuth o Signature Version 4 (Sigv4). CloudTrail non modifica l'ARN del mandante. CloudTrail registra questo campo sugli eventi API che si verificano in tale sessione. Questo campo è opzionale.

  • attributes — Gli attributi della sessione.

    • creationDate - La data e l'ora in cui le credenziali di sicurezza temporanee sono state generate. Valore rappresentato nella notazione di base ISO 8601.

    • mfaAuthenticated: il valore è true se anche l'utente root o l'utente IAM le cui credenziali sono state utilizzate per la richiesta è stato autenticato con un dispositivo MFA. In caso contrario, il valore è false.

  • sourceIdentity - Consulta AWS STS identità di origine in questo argomento. - sourceIdentity il campo si verifica negli eventi in cui gli utenti assumono un ruolo IAM per eseguire un'azione. sourceIdentity identifica l'identità originale dell'utente che ha effettuato la richiesta, indipendentemente dal fatto che l'identità dell'utente sia un utente IAM, un ruolo IAM, un utente autenticato tramite SAML-based federazione o un utente autenticato tramite una federazione di identità web conforme a OpenID Connect (OIDC). Per ulteriori informazioni sulla configurazione AWS STS per raccogliere informazioni sull'identità della fonte, vedere Monitora e controlla le azioni intraprese con ruoli presunti nel Guida per l'utente IAM.

  • ec2RoleDelivery: il valore è 1.0 se le credenziali sono state fornite da Instance Metadata Service versione 1 (IMDSv1) di Amazon EC2. Il valore è 2.0 se le credenziali sono state fornite utilizzando il nuovo schema di IMDS.

    AWS le credenziali fornite da Amazon EC2 Instance Metadata Service (IMDS) includono un ec2:RoleDelivery chiave di contesto IAM. Questa chiave di contesto semplifica l'uso del nuovo schema servizio per servizio o risorsa per risorsa utilizzando la chiave di contesto come condizione nelle politiche IAM, nelle politiche delle risorse o AWS Organizations politiche di controllo del servizio. Per ulteriori informazioni, consulta Metadati e dati dell'utente delle istanze nella Guida per l'utente di Amazon EC2.

Optional: True

invokedBy

Il nome del Servizio AWS che ha effettuato la richiesta, quando una richiesta viene effettuata da un Servizio AWS come Amazon EC2 Auto Scaling o AWS Elastic Beanstalk. Questo campo è presente solo quando una richiesta viene effettuata da un Servizio AWS. Ciò include le richieste effettuate dai servizi che utilizzano le sessioni di accesso diretto (FAS), Servizio AWS principali, ruoli collegati ai servizi o ruoli di servizio utilizzati da un Servizio AWS.

Optional: True

invokedByDelegate

Tiene traccia delle richieste effettuate dai fornitori di prodotti utilizzando l'accesso delegato temporaneo nel tuo AWS account. Questo campo viene visualizzato solo quando un fornitore di prodotti avvia una richiesta API utilizzando autorizzazioni delegate. Se presente, invokedByDelegate fornisce informazioni sull'account del fornitore del prodotto che ha effettuato la richiesta. Questo elemento ha il seguente attributo:

  • accountId — Il AWS ID dell'account del fornitore del prodotto che ha avviato la richiesta.

Per ulteriori informazioni e un esempio JSON di accesso delegato in CloudTrail eventi, vedi CloudTrail voci per credenziali di sicurezza temporanee nel Guida per l'utente IAM.

Optional: True

onBehalfOf

Se la richiesta è stata effettuata da un chiamante dello IAM Identity Center o da un AWS Utente Builder ID, onBehalfOf fornisce informazioni sull'utente per conto del quale è stata effettuata la chiamata. Questo elemento ha i seguenti attributi:

  • userId — L'ID dell'utente dello IAM Identity Center o AWS Builder ID (utente per conto del quale è stata effettuata la chiamata).

  • identityStoreArn — L'ARN dell'archivio di identità. Per gli utenti di IAM Identity Center, si tratta dell'ARN dell'archivio di identità dell'organizzazione. Per AWS Utenti Builder ID, il valore è arn:aws:identitystore::aws:identitystore/builderid.

Optional: True

inScopeOf

Se la richiesta è stata presentata nell'ambito di un Servizio AWS, come Lambda o Amazon ECS, fornisce informazioni sulla risorsa o sulle credenziali relative alla richiesta. Questo elemento può contenere i seguenti attributi:

  • sourceArn — L'ARN della risorsa che ha richiamato la richiesta da servizio a servizio.

  • sourceAccount — L'ID dell'account del proprietario del sourceArn. Appare insieme a sourceArn.

  • issuerType — Il tipo di risorsa di credentialsIssuedTo. Ad esempio, AWS::Lambda::Function.

  • credentialsIssuedTo — La risorsa relativa all'ambiente in cui sono state rilasciate le credenziali.

Optional: True

credentialId

L'ID delle credenziali per la richiesta. Viene impostato solo quando il chiamante utilizza un token portante, ad esempio un token di accesso autorizzato dal Centro identità IAM.

Optional: True

Valori per AWS STS API con SAML e federazione delle identità web

AWS CloudTrail supporta la registrazione Servizio di token di sicurezza AWS (AWS STS) Chiamate API effettuate con Security Assertion Markup Language (SAML) e federazione delle identità web. Quando un utente effettua una chiamata a AssumeRoleWithSAML e AssumeRoleWithWebIdentity API, CloudTrail registra la chiamata e invia l'evento al tuo bucket Amazon S3.

L'elemento userIdentity per queste API contiene i seguenti valori.

type

Tipo di identità.

  • SAMLUser - La richiesta è stata effettuata con un'asserzione SAML.

  • WebIdentityUser - La richiesta è stata effettuata da un provider di federazioni di identità Web.

principalId

Identificatore univoco per l'entità che ha effettuato la chiamata.

  • Per SAMLUser, corrisponde a una combinazione delle chiavi saml:namequalifier e saml:sub.

  • Per WebIdentityUser, corrisponde a una combinazione di approvatore, ID applicazione e ID utente.

userName

Nome dell'identità che ha effettuato la chiamata.

  • Per SAMLUser, corrisponde alla chiave saml:sub.

  • Per WebIdentityUser, corrisponde all'ID utente.

identityProvider

Nome entità del provider di identità esterne. Questo campo viene visualizzato solo per i tipi SAMLUser o WebIdentityUser.

  • Per SAMLUser, corrisponde alla chiave saml:namequalifier per l'asserzione SAML.

  • Per WebIdentityUser, corrisponde al nome approvatore del provider di federazioni di identità Web. Può essere un provider che hai configurato, ad esempio:

    • cognito-identity.amazon.com per Amazon Cognito

    • www.amazon.com per Login with Amazon

    • accounts.google.com per Google

    • graph.facebook.com per Facebook

Di seguito è illustrato un elemento userIdentity di esempio per l'operazione AssumeRoleWithWebIdentity.

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

Ad esempio, i registri di come userIdentity l'elemento appare per SAMLUser e WebIdentityUser tipi, vedi Registrazione di IAM e AWS STS Chiamate API con AWS CloudTrail.

AWS STS identità di origine

Un amministratore IAM può configurare Servizio di token di sicurezza AWS richiedere agli utenti di specificare la propria identità quando utilizzano credenziali temporanee per assumere ruoli. Il campo sourceIdentity è presente negli eventi in cui gli utenti assumono un ruolo IAM o eseguono azioni con il ruolo assunto.

Il sourceIdentity il campo identifica l'identità originale dell'utente che ha effettuato la richiesta, indipendentemente dal fatto che l'identità dell'utente sia un utente IAM, un ruolo IAM, un utente autenticato utilizzando SAML-based federazione o un utente autenticato utilizzando una federazione di identità web conforme a OpenID Connect (OIDC). Dopo la configurazione dell'amministratore IAM AWS STS, CloudTrail registri sourceIdentity informazioni nei seguenti eventi e luoghi all'interno del record dell'evento:

  • Il AWS STS AssumeRole, AssumeRoleWithSAML, o AssumeRoleWithWebIdentity chiamate effettuate da un'identità utente quando assume un ruolo. sourceIdentity si trova in requestParameters blocco del AWS STS chiamate.

  • Le AWS STS AssumeRole, AssumeRoleWithSAML, o AssumeRoleWithWebIdentity chiamate effettuate da un'identità utente se utilizza un ruolo per assumere un altro ruolo, noto come concatenamento di ruoli. sourceIdentity si trova nel requestParameters blocco del AWS STS chiamate.

  • Le AWS chiamate API di servizio effettuate dall'identità dell'utente assumendo un ruolo e utilizzando le credenziali temporanee assegnate da AWS STS. Negli eventi API di servizio, sourceIdentity è presente nel blocco sessionContext. Ad esempio, se un'identità utente crea un nuovo bucket S3, sourceIdentity si verifica nel blocco sessionContext dell'evento CreateBucket.

Per ulteriori informazioni su come configurare AWS STS per raccogliere informazioni sull'identità della fonte, vedere Monitora e controlla le azioni intraprese con ruoli presunti nel Guida per l'utente IAM. Per ulteriori informazioni su AWS STS eventi a cui si è registrati CloudTrail, vedi Registrazione di IAM e AWS STS Chiamate API con AWS CloudTrail nel Guida per l'utente IAM.

Di seguito sono riportati frammenti di esempio di eventi che mostrano il campo sourceIdentity.

Sezione di esempio requestParameters

Nel seguente frammento di evento di esempio, un utente crea un AWS STS AssumeRole richiede e imposta un'identità di origine, rappresentata qui da source-identity-value-set. L'utente assume un ruolo rappresentato dal ruolo ARN arn:aws:iam::123456789012:role/Assumed_Role. Il campo sourceIdentity è presente nel blocco requestParameters dell'evento.

"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", },

Sezione di esempio responseElements

Nel seguente frammento di evento di esempio, un utente crea un AWS STS AssumeRole richiesta di assumere un ruolo denominato Developer_Rolee imposta un'identità di origine, Admin. L'utente assume un ruolo rappresentato dal ruolo ARN arn:aws:iam::111122223333:role/Developer_Role. Il campo sourceIdentity è presente nel blocco requestParameters e responseElements dell'evento. Le credenziali temporanee utilizzate per assumere il ruolo, la stringa del token di sessione e l'ID del ruolo assunto, il nome della sessione e l'ARN della sessione sono mostrati nel blocco responseElements, insieme all'identità di origine.

"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" } ...

Sezione di esempio sessionContext

Nel seguente frammento di evento di esempio, un utente assume un ruolo denominato DevRole chiamare un AWS API di servizio. L'utente imposta un'identità di origine, rappresentata qui da source-identity-value-set. Il campo sourceIdentity è presente nel blocco sessionContext dell'evento userIdentity.

{ "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" } } }