AWS CloudFormation
User Guide (API Version 2010-05-15)

Elastic Load Balancing V2 AuthenticateCognitoConfig

The AuthenticateCognitoConfig property type specifies request parameters to use when integrating with Amazon Cognito to authenticate users.

AuthenticateCognitoConfig is a property of the Elastic Load Balancing V2 Actions property type.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "AuthenticationRequestExtraParams" : { String:String, ... } , "OnUnauthenticatedRequest" : String, "Scope" : String, "SessionCookieName" : String , "SessionTimeout" : Number, "UserPoolArn" : String, "UserPoolClientId" : String , "UserPoolDomain" : String }

YAML

AuthenticationRequestExtraParams: { String:String, ... } OnUnauthenticatedRequest: String Scope: String SessionCookieName: String SessionTimeout: Number UserPoolArn: String UserPoolClientId: String UserPoolDomain: String

Properties

AuthenticationRequestExtraParams

The query parameters (up to 10) to include in the redirect request to the authorization endpoint.

Required: No

Type: Type: String to String map

Update requires: No interruption

OnUnauthenticatedRequest

The behavior if the user is not authenticated. The following are possible values:

  • deny: Return an HTTP 401 Unauthorized error.

  • allow: Allow the request to be forwarded to the target.

  • authenticate: Redirect the request to the IdP authorization endpoint. This is the default value.

Required: No

Type: String

Update requires: No interruption

Scope

The set of user claims to be requested from the IdP. The default is openid.

To verify which scope values your IdP supports and how to separate multiple values, see the documentation for your IdP.

Required: No

Type: String

Update requires: No interruption

SessionCookieName

The name of the cookie used to maintain session information. The default is AWSELBAuthSessionCookie.

Required: No

Type: String

Update requires: No interruption

SessionTimeout

The maximum duration of the authentication session, in seconds. The default is 604800 seconds (7 days).

Required: Yes

Type: Type: Number

Update requires: No interruption

UserPoolArn

The Amazon Resource Name (ARN) of the Amazon Cognito user pool.

Required: Yes

Type: String

Update requires: No interruption

UserPoolClientId

The ID of the Amazon Cognito user pool client.

Required: Yes

Type: String

Update requires: No interruption

UserPoolDomain

The domain prefix or fully-qualified domain name of the Amazon Cognito user pool.

Required: Yes

Type: String

Update requires: No interruption

See Also

On this page: