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:

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.202Z")
 @Stability(value=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 and Description
static 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.amazon.awscdk.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor and Description
	RequestAuthorizer(software.constructs.Construct scope, String id, RequestAuthorizerProps props)
protected	RequestAuthorizer(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	RequestAuthorizer(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

RequestAuthorizer

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

RequestAuthorizer

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

RequestAuthorizer

@Stability(value=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 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)