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

Immediately, 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 simply accept calls from IPv6 shoppers alongside the present IPv4 assist. You may also 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 essential for future-proofing community infrastructure. This dual-stack strategy helps organizations keep future community compatibility and broaden world attain. To be taught extra about dualstack within the Amazon Internet Providers (AWS) setting, see the IPv6 on AWS Documentation.

Creating new dual-stack assets

This submit focuses on two methods to create an API or a website identify with a dualstack IP tackle sort: AWS Administration Console and AWS Cloud Growth Package (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 possibly can choose the dualstack possibility when creating a brand new REST API.
For customized domains, you possibly can equally configure dualstack as proven within the subsequent picture.

If you could revert to IPv4-only for any cause, you possibly can 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 visitors, consumer supply IPs might be in IPv6 format. For those who use useful resource insurance policies, Lambda authorizers, or AWS Identification and Entry Administration (IAM) insurance policies that reference supply IP addresses, make certain they’re up to date to accommodate IPv6 tackle codecs.

For instance, to allow visitors from a particular 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 clean 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 assets, answering questions, and providing beneficial suggestions throughout the writing course of. This weblog submit was made potential 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 information gathered by way of this survey and won’t share the data collected with survey respondents.)