How to map static outbound IP with the AWS Lambda function
In this article, I will share how to map elastic IP and make sure that, all the outgoing requests from the lambda function have the same IP address/origin.
There is an External API and it only allows or entertains the requests originating from specific IP addresses which are whitelisted as a part of the policy of the external API.
Here, we want to invoke/access the external API from the lambda function but there is a problem.
The problem here is that the AWS Lambda function does not guarantee the same outbound IP address with each invocation since the AWS Lambda function runs on containers within the AWS environment in AWS-managed VPC and at times the container could run in different execution environments. And different environments have a different IP addresses, hence whitelisting any outbound IP within external IP is not possible since it is bound to change.
So how can we assign the static IP to the lambda function and make sure that all the requests made from the Lambda function originate from the same IP address?
The solution is to map static/elastic IP to all the outgoing traffic from the lambda function and for that, place the lambda function in VPC. However, as soon as you place the lambda function in VPC, it will lose the internet connectivity and here we want to invoke the external API which is over the internet. Now, to enable internet connectivity, the NAT Gateway & Internet Gateway is also required.
- Create VPC with Public & Private subnets
- Create NAT Gateway under Public subnet with Elastic IP
- Create Internet Gateway
- Map NAT Gateway within private subnets route table (Source: 0.0.0.0/0 Destination: nat-gateway)
- Map Internet Gateway within public subnet route table (Source: 0.0.0.0/0 Destination: internet-gateway)
- Place lambda function in VPC under Private subnet
Create & Configure VPC
To get started, navigate to VPC Management Console to create the VPC and select VPC and more option to create & configure VPC, subnets, AZs, NAT Gateway & Internet Gateway on a single screen.
Configure the asked details as per your requirement. My configuration is as follows:
- Name tag auto-generation: lambda-elastic-ip
- IPv4 CIDR block: 10.100.0.0/16
- IPv6 CIDR block: No IPv6 CIDR block
- Tenancy: Default
- Number of Availability Zones (AZs): 2
- First availability zone: us-east-1a
- Second availability zone: us-east-1b
- Number of public subnets: 2
- Public subnet CIDR block in us-east-1a: 10.100.0.0/20
- Public subnet CIDR block in us-east-1b: 10.100.16.0/20
- Number of private subnets: 2
- Private subnet CIDR block in us-east-1a: 10.100.128.0/20
- Private subnet CIDR block in us-east-1b: 10.100.144.0/20
- NAT gateways: In 1 AZ
- VPC endpoints: None
- DNS options
✓ Enable DNS hostnames
✓ Enable DNS resolution
The above VPC setup will take care of adding necessary routes (NAT & IG mappings) in the respective route tables.
Create & configure lambda function
Navigate to Lambda Management Console and create the lambda function with Python3.9 as runtime. Post creation, open the relevant IAM role attached with the lambda function and add AWSLambdaVPCAccessExecutionRole permission to it.
As a next step, add the below snippet as a part of the function code for testing purposes. The below snippet will invoke (GET) the API Endpoint mentioned as a part of API_URL.
import urllib3def lambda_handler(event, context):
http = urllib3.PoolManager()
API_URL = "YOUR_API_URL"
response = http.request("GET", API_URL)
'body': json.dumps('Hello from Srce Cde!')
Note: Replace YOUR_API_URL with the actual API endpoint.
As a next step, place the lambda function in VPC under private subnets as shown below.
For testing, I have an external REST API (API Gateway) where I can control which requests to entertain based on the origin (IP address). If you also want to have similar setup then you can follow my tutorial video on How to whitelist IP address to access API Gateway | REST
Execution log of the lambda function before adding/whitelisting the Elastic IP address of the lambda function.
Execution log of the lambda function after adding/whitelisting the Elastic IP address of the lambda function.
Response “Successful Invocation!” is returned from the external API.
Finally, we successfully attached/mapped the Elastic IP address with the AWS Lambda function.
For a detailed step-by-step tutorial and implementation of the above setup, you can refer to the below video.
If you have any questions, comments, or feedback then please leave them below.