CognitoIdentityProvider / Paginator / AdminListUserAuthEvents

AdminListUserAuthEvents#

class CognitoIdentityProvider.Paginator.AdminListUserAuthEvents#
paginator = client.get_paginator('admin_list_user_auth_events')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from CognitoIdentityProvider.Client.admin_list_user_auth_events().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    UserPoolId='string',
    Username='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • UserPoolId (string) –

    [REQUIRED]

    The user pool ID.

  • Username (string) –

    [REQUIRED]

    The user pool username or an alias.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'AuthEvents': [
        {
            'EventId': 'string',
            'EventType': 'SignIn'|'SignUp'|'ForgotPassword'|'PasswordChange'|'ResendCode',
            'CreationDate': datetime(2015, 1, 1),
            'EventResponse': 'Pass'|'Fail'|'InProgress',
            'EventRisk': {
                'RiskDecision': 'NoRisk'|'AccountTakeover'|'Block',
                'RiskLevel': 'Low'|'Medium'|'High',
                'CompromisedCredentialsDetected': True|False
            },
            'ChallengeResponses': [
                {
                    'ChallengeName': 'Password'|'Mfa',
                    'ChallengeResponse': 'Success'|'Failure'
                },
            ],
            'EventContextData': {
                'IpAddress': 'string',
                'DeviceName': 'string',
                'Timezone': 'string',
                'City': 'string',
                'Country': 'string'
            },
            'EventFeedback': {
                'FeedbackValue': 'Valid'|'Invalid',
                'Provider': 'string',
                'FeedbackDate': datetime(2015, 1, 1)
            }
        },
    ],

}

Response Structure

  • (dict) –

    • AuthEvents (list) –

      The response object. It includes the EventID, EventType, CreationDate, EventRisk, and EventResponse.

      • (dict) –

        The authentication event type.

        • EventId (string) –

          The event ID.

        • EventType (string) –

          The event type.

        • CreationDate (datetime) –

          The date and time, in ISO 8601 format, when the item was created.

        • EventResponse (string) –

          The event response.

        • EventRisk (dict) –

          The event risk.

          • RiskDecision (string) –

            The risk decision.

          • RiskLevel (string) –

            The risk level.

          • CompromisedCredentialsDetected (boolean) –

            Indicates whether compromised credentials were detected during an authentication event.

        • ChallengeResponses (list) –

          The challenge responses.

          • (dict) –

            The challenge response type.

            • ChallengeName (string) –

              The challenge name.

            • ChallengeResponse (string) –

              The challenge response.

        • EventContextData (dict) –

          The user context data captured at the time of an event request. This value provides additional information about the client from which event the request is received.

          • IpAddress (string) –

            The source IP address of your user’s device.

          • DeviceName (string) –

            The user’s device name.

          • Timezone (string) –

            The user’s time zone.

          • City (string) –

            The user’s city.

          • Country (string) –

            The user’s country.

        • EventFeedback (dict) –

          A flag specifying the user feedback captured at the time of an event request is good or bad.

          • FeedbackValue (string) –

            The authentication event feedback value. When you provide a FeedbackValue value of valid, you tell Amazon Cognito that you trust a user session where Amazon Cognito has evaluated some level of risk. When you provide a FeedbackValue value of invalid, you tell Amazon Cognito that you don’t trust a user session, or you don’t believe that Amazon Cognito evaluated a high-enough risk level.

          • Provider (string) –

            The provider.

          • FeedbackDate (datetime) –

            The event feedback date.