software.amazon.awscdk.services.apigateway

Interface LambdaAuthorizerProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

RequestAuthorizerProps, TokenAuthorizerProps

All Known Implementing Classes:

LambdaAuthorizerProps.Jsii$Proxy, RequestAuthorizerProps.Jsii$Proxy, TokenAuthorizerProps.Jsii$Proxy

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

Base properties for all lambda authorizers.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.apigateway.*;
 import software.amazon.awscdk.services.iam.*;
 import software.amazon.awscdk.services.lambda.*;
 Function function_;
 Role role;
 LambdaAuthorizerProps lambdaAuthorizerProps = LambdaAuthorizerProps.builder()
         .handler(function_)
         // the properties below are optional
         .assumeRole(role)
         .authorizerName("authorizerName")
         .resultsCacheTtl(Duration.minutes(30))
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static LambdaAuthorizerProps.Builder	builder()
default IRole	getAssumeRole() An optional IAM role for APIGateway to assume before calling the Lambda-based authorizer.
default String	getAuthorizerName() An optional human friendly name for the authorizer.
IFunction	getHandler() The handler for the authorizer lambda function.
default Duration	getResultsCacheTtl() How long APIGateway should cache the results.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getHandler

@Stability(value=Stable)
 @NotNull
IFunction getHandler()

The handler for the authorizer lambda function.

The handler must follow a very specific protocol on the input it receives and the output it needs to produce. API Gateway has documented the handler's input specification {@link https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-input.html | here} and output specification {@link https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-output.html | here}.

getAssumeRole

@Stability(value=Stable)
 @Nullable
default IRole getAssumeRole()

An optional IAM role for APIGateway to assume before calling the Lambda-based authorizer.

The IAM role must be assumable by 'apigateway.amazonaws.com'.

Default: - A resource policy is added to the Lambda function allowing apigateway.amazonaws.com to invoke the function.

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 construcrt ID

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 LambdaAuthorizerProps.Builder builder()

Returns:

a LambdaAuthorizerProps.Builder of LambdaAuthorizerProps