Amazon API Gateway now helps dual-stack (IPv4 and IPv6) endpoints

At this time, we’re launching IPv6 assist for Amazon API Gateway throughout all endpoint sorts, customized domains, and administration APIs, in all business and AWS GovCloud (US) Areas. Now you can configure REST, HTTP, and WebSocket APIs, and customized domains, to just accept calls from IPv6 shoppers alongside the prevailing IPv4 assist. You may as well name API Gateway administration APIs from dual-stack (IPv6 and IPv4) shoppers. As organizations globally confront rising IPv4 tackle shortage and growing prices, implementing IPv6 turns into important for future-proofing community infrastructure. This dual-stack strategy helps organizations keep future community compatibility and increase international attain. To be taught extra about dualstack within the Amazon Net Companies (AWS) atmosphere, see the IPv6 on AWS Documentation.

Creating new dual-stack sources

This put up focuses on two methods to create an API or a website identify with a dualstack IP tackle sort: AWS Administration Console and AWS Cloud Improvement Equipment (CDK).

AWS Console

When creating a brand new API or area identify within the console, choose IPv4 solely or dualstack (IPv4 and IPv6) for the IP tackle sort.

As proven within the following picture, you may choose the dualstack choice when creating a brand new REST API.
For customized domains, you may equally configure dualstack as proven within the subsequent picture.

If you should revert to IPv4-only for any purpose, you may modify the IP tackle sort setting, without having to redeploy your API for the replace to take impact.

REST APIs of all endpoint sorts (EDGE, REGIONAL and PRIVATE) assist dualstack. Non-public REST APIs solely assist dualstack configuration.

AWS CDK

With AWS CDK, begin by configuring a dual-stack REST API and area identify.

const api = new apigateway.RestApi(this, "Api", {
  restApiName: "MyDualStackAPI",
  endpointConfiguration: {ipAddressType: "dualstack"}
});

const domain_name = new apigateway.DomainName(this, "DomainName", {
  regionalCertificateArn: 'arn:aws:acm:us-east-1:111122223333:certificates/a1b2c3d4-5678-90ab',
  domainName: 'dualstack.instance.com',
  endpointConfiguration: {
    sorts: ['Regional'],
    ipAddressType: 'dualstack'
  },
  securityPolicy: 'TLS_1_2'
});

const basepathmapping = new apigateway.BasePathMapping(this, "BasePathMapping", {
  domainName: domain_name,
  restApi: api
});

IPv6 Supply IP and authorization

When your API begins receiving IPv6 site visitors, consumer supply IPs can be in IPv6 format. If you happen to use useful resource insurance policies, Lambda authorizers, or AWS Id and Entry Administration (IAM) insurance policies that reference supply IP addresses, be sure that they’re up to date to accommodate IPv6 tackle codecs.

For instance, to allow site visitors from a selected IPv6 vary in a useful resource coverage.

{
  "Model": "2012-10-17",
  "Assertion": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "execute-api:Invoke",
      "Resource": "execute-api:stage-name/*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24",
            "2001:db8:1234::/48"
          ]
        }
      }
    }
  ]
}

Abstract

API Gateway dual-stack assist helps handle IPv4 tackle shortage and prices, adjust to authorities and trade mandates, and put together for the way forward for networking. The dualstack implementation supplies a easy transition path by supporting each IPv4 and IPv6 shoppers concurrently.

To get began with API Gateway dual-stack assist, go to the Amazon API Gateway documentation. You possibly can configure dualstack for brand spanking new APIs or replace present APIs with minimal configuration adjustments.

–Betty

Particular because of Ellie Frank (elliesf), Anjali Gola (anjaligl), and Pranika Kakkar (pranika) for offering sources, answering questions, and providing precious suggestions in the course of the writing course of. This weblog put up was made doable by means of the collaborative assist of the service and product administration groups.

How is the Information Weblog doing? Take this 1 minute survey!

(This survey is hosted by an exterior firm. AWS handles your info as described within the AWS Privateness Discover. AWS will personal the info gathered by way of this survey and won’t share the knowledge collected with survey respondents.)