AWS singlesignon: Document CloudTrail sign-in events for external IdP identities
Summary
Extends the IAM Identity Center sign-in event documentation to cover external identity provider (IdP) sourced identities: CredentialChallenge/CredentialVerification now apply to external IdPs, a new IdentityProviderId field is documented, and a note explains that external IdP sign-in logs CredentialChallenge on outbound redirect and CredentialVerification on SAML response verification with CredentialType EXTERNAL_IDP.
Security assessment
The change documents which CloudTrail audit events and fields (including IdentityProviderId and EXTERNAL_IDP credential type) are emitted for federated sign-in, improving audit visibility into authentication attempts via external IdPs. It is documentation of logging behavior, not a fix for a specific vulnerability.
Evidence
+`IdentityProviderId` | Identifies the external IdP configuration associated with the credential event. Included when the configuration identifier is available. | `CredentialChallenge`, `CredentialVerification` | "IdentityProviderId": "12345678-90ab-4cde-8f01-234567890abc"
Diff
diff --git a/singlesignon/latest/userguide/understanding-sign-in-events.md b/singlesignon/latest/userguide/understanding-sign-in-events.md index 4e2fcb1..0e4a71b 100644 --- a//singlesignon/latest/userguide/understanding-sign-in-events.md +++ b//singlesignon/latest/userguide/understanding-sign-in-events.md @@ -9 +9 @@ -AWS CloudTrail records successful and unsuccessful sign-in events for all IAM Identity Center identity sources. IAM Identity Center and Active Directory (AD Connector and AWS Managed Microsoft AD) sourced identities include additional sign-in events that are captured each time a user is prompted to solve a specific credential challenge or factor, in addition to the status of that particular credential verification request. Only after a user has completed all required credential challenges will the user be signed in, which will result in a `UserAuthentication` event being logged. +AWS CloudTrail records successful and unsuccessful sign-in events for all IAM Identity Center identity sources. IAM Identity Center, Active Directory (AD Connector and AWS Managed Microsoft AD), and external identity provider (IdP) sourced identities include additional sign-in events that are captured each time a user is prompted to solve a specific credential challenge or factor, in addition to the status of that particular credential verification request. Only after a user has completed all required credential challenges will the user be signed in, which will result in a `UserAuthentication` event being logged. @@ -15,2 +15,2 @@ Event name | Event purpose | Identity source applicability -`CredentialChallenge` | Used to notify that IAM Identity Center has requested the user to solve a specific credential challenge and specifies the `CredentialType` that was required (For example, PASSWORD or TOTP). | Native IAM Identity Center users, AD Connector, and AWS Managed Microsoft AD -`CredentialVerification` | Used to notify that the user has attempted to solve a specific `CredentialChallenge` request and specifies whether that credential succeeded or failed. | Native IAM Identity Center users, AD Connector, and AWS Managed Microsoft AD +`CredentialChallenge` | Used to notify that IAM Identity Center has requested the user to solve a specific credential challenge and specifies the `CredentialType` that was required (For example, PASSWORD or TOTP). | Native IAM Identity Center users, AD Connector, AWS Managed Microsoft AD, and external IdPs +`CredentialVerification` | Used to notify that the user has attempted to solve a specific `CredentialChallenge` request and specifies whether that credential succeeded or failed. | Native IAM Identity Center users, AD Connector, AWS Managed Microsoft AD, and external IdPs @@ -24,0 +25 @@ Field | Event purpose | Sign-in event applicability | Example values +`IdentityProviderId` | Identifies the external IdP configuration associated with the credential event. Included when the configuration identifier is available. | `CredentialChallenge`, `CredentialVerification` | "IdentityProviderId": "12345678-90ab-4cde-8f01-234567890abc" @@ -43,0 +45,2 @@ The **federated sign-in** flow, consisting of steps 1a, 2a, and 8, demonstrates +For sign-in with an external identity provider, IAM Identity Center records `CredentialChallenge` only when it prepares an outbound redirect to the IdP and `CredentialVerification` when it verifies the SAML response. These events have `CredentialType` set to `EXTERNAL_IDP`. For examples, see [Successful sign-in when authenticating with an external identity provider](./sign-in-events-examples.html#sign-in-events-examples-2). +