Package software.amazon.awscdk.services.apigateway

Class RequestAuthorizer

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.RequestAuthorizer

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)",
           date="2025-12-05T10:47:11.572Z")
@Stability(Stable)
public class RequestAuthorizer
extends Authorizer
implements IAuthorizer

Request-based lambda authorizer that recognizes the caller's identity via request parameters, such as headers, paths, query strings, stage variables, or context variables.

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

Example:

 Function authFn;
 Resource books;
 RequestAuthorizer auth = RequestAuthorizer.Builder.create(this, "booksAuthorizer")
         .handler(authFn)
         .identitySources(List.of(IdentitySource.header("Authorization")))
         .build();
 books.addMethod("GET", new HttpIntegration("http://amazon.com"), MethodOptions.builder()
         .authorizer(auth)
         .build());
 

Nested Class Summary

Nested Classes

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

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.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

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

IResource.Jsii$Default

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	Uniquely identifies this class.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	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 CfnAuthorizerProps	getAuthorizerProps()
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.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Stable)
public static final String PROPERTY_INJECTION_ID

Uniquely identifies this class.

Constructor Details

RequestAuthorizer

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

RequestAuthorizer

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

RequestAuthorizer

@Stability(Stable)
public RequestAuthorizer(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 RequestAuthorizerProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

lazyRestApiId

@Stability(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(Stable)
protected void setupPermissions()

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

getAuthorizerArn

@Stability(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(Stable)
@NotNull
public String getAuthorizerId()

The id of the authorizer.

Specified by:

getAuthorizerId in interface IAuthorizer

Specified by:

getAuthorizerId in class Authorizer

getAuthorizerProps

@Stability(Stable)
@NotNull
protected CfnAuthorizerProps getAuthorizerProps()

getHandler

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

The Lambda function handler that this authorizer uses.

getRole

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

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

getRestApiId

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

setRestApiId

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