software.amazon.awscdk.services.apigateway

Interface CognitoUserPoolsAuthorizerProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CognitoUserPoolsAuthorizerProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.145Z")
 @Stability(value=Stable)
public interface CognitoUserPoolsAuthorizerProps
extends software.amazon.jsii.JsiiSerializable

Properties for CognitoUserPoolsAuthorizer.

Example:

 Resource books;
 UserPool userPool = new UserPool(this, "UserPool");
 CognitoUserPoolsAuthorizer auth = CognitoUserPoolsAuthorizer.Builder.create(this, "booksAuthorizer")
         .cognitoUserPools(List.of(userPool))
         .build();
 books.addMethod("GET", new HttpIntegration("http://amazon.com"), MethodOptions.builder()
         .authorizer(auth)
         .authorizationType(AuthorizationType.COGNITO)
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CognitoUserPoolsAuthorizerProps.Builder A builder for CognitoUserPoolsAuthorizerProps
static class	CognitoUserPoolsAuthorizerProps.Jsii$Proxy An implementation for CognitoUserPoolsAuthorizerProps

Method Summary

Modifier and Type	Method and Description
static CognitoUserPoolsAuthorizerProps.Builder	builder()
default String	getAuthorizerName() An optional human friendly name for the authorizer.
List<IUserPool>	getCognitoUserPools() The user pools to associate with this authorizer.
default String	getIdentitySource() The request header mapping expression for the bearer token.
default Duration	getResultsCacheTtl() How long APIGateway should cache the results.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getCognitoUserPools

@Stability(value=Stable)
 @NotNull
List<IUserPool> getCognitoUserPools()

The user pools to associate with this authorizer.

getAuthorizerName

@Stability(value=Stable)
 @Nullable
default String getAuthorizerName()

An optional human friendly name for the authorizer.

Note that, this is not the primary identifier of the authorizer.

Default: - the unique construct ID

getIdentitySource

@Stability(value=Stable)
 @Nullable
default String getIdentitySource()

The request header mapping expression for the bearer token.

This is typically passed as part of the header, in which case this should be method.request.header.Authorizer where Authorizer is the header containing the bearer token.

Default: `IdentitySource.header('Authorization')`

See Also:

https://docs.aws.amazon.com/apigateway/api-reference/link-relation/authorizer-create/#identitySource

getResultsCacheTtl

@Stability(value=Stable)
 @Nullable
default Duration getResultsCacheTtl()

How long APIGateway should cache the results.

Max 1 hour. Disable caching by setting this to 0.

Default: Duration.minutes(5)

builder

@Stability(value=Stable)
static CognitoUserPoolsAuthorizerProps.Builder builder()

Returns:

a CognitoUserPoolsAuthorizerProps.Builder of CognitoUserPoolsAuthorizerProps