AWS Security ChangesHomeSearch

AWS singlesignon: Document CloudTrail sign-in events for external IdP identities

Service: singlesignon · 2026-11-03 · Documentation medium

File: singlesignon/latest/userguide/understanding-sign-in-events.md · Type: logging

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).
+