Secure AWS API Gateway Endpoints Using Custom Authorizers
A serverless application runs custom code as a compute service without the need to maintain an operating environment to host your service. Instead, a service like AWS Lambda or webtask.io executes your code on your behalf.
The API Gateway extends the capabilities of Lambda by adding a service layer in front of your Lambda functions to extend security, manage input and output message transformations, and provide capabilities like throttling and auditing. A serverless approach simplifies your operational demands since concerns like scaling out and fault tolerance are now the responsibility of the compute service that is executing your code.
This tutorial will show you how to set up your API with API Gateway, create and configure your Lambda functions (including the custom authorizers) to secure your API endpoints, and implement the authorization flow so that your users can retrieve the Access Tokens needed to gain access to your API from Auth0.
More specifically, the custom authorizers will:
- Confirm that the Access Token has been passed via the
authorizationheader of the request to access the API
- Verify the RS256 signature of the Access Token using a public key obtained via a JWKS endpoint
- Ensure the Access Token has the required Issuer
To that end, this tutorial will be divided into the following sections.
- Step 1 - Configure Auth0
- Step 2 - Set up and Deploy the AWS API Gateway
- Step 3 - Create the Custom Authorizers
- Step 4 - Secure the API Using Custom Authorizers
According to Amazon, an API Gateway custom authorizer is a "Lambda function you provide to control access to your API using bearer token authentication strategies, such as OAuth or SAML."
Whenever someone (or some program) attempts to call your API, API Gateway checks to see if there's a custom authorizer configured for the API.
If there is a custom authorizer for the API, API Gateway calls the custom authorizer and provides the authorization token extracted from the request header received.
You can use the custom authorizer to implement different types of authorization strategies, including JWT verification, to return IAM policies authorizing the request. If the policy returned is invalid or if the permissions are denied, the API call fails.
For a valid policy, API caches the returned policy, associating it with the incoming token and using it for the current and subsequent requests. You can configure the amount of time for which the policy is cached. The default value is
300 seconds, and the maximum length of caching is
3600 seconds (you can also set the value to 0 to disable caching).
Before You Begin
Before beginning this tutorial, you'll need to sign up for an AWS account. This grants you access to all of the AWS features we'll use in this tutorial, including API Gateway and Lambda. All new members receive twelve months of free tier access to AWS.
For details, see the Amazon API Gateway developer guide: Use API Gateway Lambda Authorizers.