software.amazon.awscdk.services.apigateway

Class TokenAuthorizer

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.apigateway.Authorizer

software.amazon.awscdk.services.apigateway.TokenAuthorizer

All Implemented Interfaces:

IResource, IAuthorizer, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.240Z")
 @Stability(value=Stable)
public class TokenAuthorizer
extends Authorizer
implements IAuthorizer

Token based lambda authorizer that recognizes the caller's identity as a bearer token, such as a JSON Web Token (JWT) or an OAuth token.

Based on the token, authorization is performed by a lambda function.

Example:

 Function authFn;
 Resource books;
 TokenAuthorizer auth = TokenAuthorizer.Builder.create(this, "booksAuthorizer")
         .handler(authFn)
         .build();
 books.addMethod("GET", new HttpIntegration("http://amazon.com"), MethodOptions.builder()
         .authorizer(auth)
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TokenAuthorizer.Builder A fluent builder for TokenAuthorizer.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.apigateway.IAuthorizer

IAuthorizer.Jsii$Default, IAuthorizer.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor and Description
	TokenAuthorizer(software.constructs.Construct scope, String id, TokenAuthorizerProps props)
protected	TokenAuthorizer(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	TokenAuthorizer(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
String	getAuthorizerArn() The ARN of the authorizer to be used in permission policies, such as IAM and resource-based grants.
String	getAuthorizerId() The id of the authorizer.
protected IFunction	getHandler() The Lambda function handler that this authorizer uses.
protected String	getRestApiId()
protected IRole	getRole() The IAM role that the API Gateway service assumes while invoking the Lambda function.
protected String	lazyRestApiId() Returns a token that resolves to the Rest Api Id at the time of synthesis.
protected void	setRestApiId(String value)
protected void	setupPermissions() Sets up the permissions necessary for the API Gateway service to invoke the Lambda function.

Methods inherited from class software.amazon.awscdk.services.apigateway.Authorizer

getAuthorizationType, isAuthorizer

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.services.apigateway.IAuthorizer

getAuthorizationType

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Methods inherited from interface software.constructs.IConstruct

getNode

Constructor Detail

TokenAuthorizer

protected TokenAuthorizer(software.amazon.jsii.JsiiObjectRef objRef)

TokenAuthorizer

protected TokenAuthorizer(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

TokenAuthorizer

@Stability(value=Stable)
public TokenAuthorizer(@NotNull
                                                software.constructs.Construct scope,
                                                @NotNull
                                                String id,
                                                @NotNull
                                                TokenAuthorizerProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

lazyRestApiId

@Stability(value=Stable)
 @NotNull
protected String lazyRestApiId()

Returns a token that resolves to the Rest Api Id at the time of synthesis.

Throws an error, during token resolution, if no RestApi is attached to this authorizer.

setupPermissions

@Stability(value=Stable)
protected void setupPermissions()

Sets up the permissions necessary for the API Gateway service to invoke the Lambda function.

getAuthorizerArn

@Stability(value=Stable)
 @NotNull
public String getAuthorizerArn()

The ARN of the authorizer to be used in permission policies, such as IAM and resource-based grants.

getAuthorizerId

@Stability(value=Stable)
 @NotNull
public String getAuthorizerId()

The id of the authorizer.

Specified by:

getAuthorizerId in interface IAuthorizer

Specified by:

getAuthorizerId in class Authorizer

getHandler

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

The Lambda function handler that this authorizer uses.

getRole

@Stability(value=Stable)
 @Nullable
protected IRole getRole()

The IAM role that the API Gateway service assumes while invoking the Lambda function.

getRestApiId

@Stability(value=Stable)
 @Nullable
protected String getRestApiId()

setRestApiId

@Stability(value=Stable)
protected void setRestApiId(@Nullable
                                                     String value)