Authorizer class
Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
Constructors
-
Authorizer({String? authType, String? authorizerCredentials, int? authorizerResultTtlInSeconds, String? authorizerUri, String? id, String? identitySource, String? identityValidationExpression, String? name, List<
String> ? providerARNs, AuthorizerType? type}) -
Authorizer.fromJson(Map<
String, dynamic> json) -
factory
Properties
-
Specifies the required credentials as an IAM role for API Gateway to invoke
the authorizer. To specify an IAM role for API Gateway to assume, use the
role's Amazon Resource Name (ARN). To use resource-based permissions on the
Lambda function, specify null.
final
-
The TTL in seconds of cached authorizer results. If it equals 0,
authorization caching is disabled. If it is greater than 0, API Gateway will
cache authorizer responses. If this field is not set, the default value is
300. The maximum value is 3600, or 1 hour.
final
-
Specifies the authorizer's Uniform Resource Identifier (URI). For
TOKEN
orREQUEST
authorizers, this must be a well-formed Lambda function URI, for example,arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations
. In general, the URI has this formarn:aws:apigateway:{region}:lambda:path/{service_api}
, where{region}
is the same as the region hosting the Lambda function,path
indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial/
. For Lambda functions, this is usually of the form/2015-03-31/functions/
.FunctionARN
/invocationsfinal - authType → String?
-
Optional customer-defined field, used in OpenAPI imports and exports without
functional impact.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- id → String?
-
The identifier for the authorizer resource.
final
- identitySource → String?
-
The identity source for which authorization is requested.
final
- identityValidationExpression → String?
-
A validation expression for the incoming identity token. For
TOKEN
authorizers, this value is a regular expression. ForCOGNITO_USER_POOLS
authorizers, API Gateway will match theaud
field of the incoming token from the client against the specified regular expression. It will invoke the authorizer's Lambda function when there is a match. Otherwise, it will return a 401 Unauthorized response without calling the Lambda function. The validation expression does not apply to theREQUEST
authorizer.final - name → String?
-
Required
The name of the authorizer.final -
providerARNs
→ List<
String> ? -
A list of the Amazon Cognito user pool ARNs for the
COGNITO_USER_POOLS
authorizer. Each element is of this format:arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}
. For aTOKEN
orREQUEST
authorizer, this is not defined.final - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- type → AuthorizerType?
-
The authorizer type. Valid values are
TOKEN
for a Lambda function using a single authorization token submitted in a custom header,REQUEST
for a Lambda function using incoming request parameters, andCOGNITO_USER_POOLS
for using an Amazon Cognito user pool.final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited