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.