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

At present, we’re launching IPv6 help for Amazon API Gateway throughout all endpoint varieties, customized domains, and administration APIs, in all industrial 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 help. You can even 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 vital for future-proofing community infrastructure. This dual-stack method helps organizations keep future community compatibility and broaden international attain. To study extra about dualstack within the Amazon Net Providers (AWS) surroundings, 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 kind: 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 kind.

As proven within the following picture, you’ll be able to choose the dualstack possibility when creating a brand new REST API.
For customized domains, you’ll be able to equally configure dualstack as proven within the subsequent picture.

If you must revert to IPv4-only for any purpose, you’ll be able to modify the IP tackle kind setting, without having to redeploy your API for the replace to take impact.

REST APIs of all endpoint varieties (EDGE, REGIONAL and PRIVATE) help dualstack. Non-public REST APIs solely help 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: {
    varieties: ['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 might be in IPv6 format. Should you use useful resource insurance policies, Lambda authorizers, or AWS Id and Entry Administration (IAM) insurance policies that reference supply IP addresses, be sure 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 help helps handle IPv4 tackle shortage and prices, adjust to authorities and business mandates, and put together for the way forward for networking. The dualstack implementation gives a clean transition path by supporting each IPv4 and IPv6 shoppers concurrently.

To get began with API Gateway dual-stack help, go to the Amazon API Gateway documentation. You may configure dualstack for brand spanking new APIs or replace current APIs with minimal configuration modifications.

–Betty

Particular due to Ellie Frank, Anjali Gola, and Pranika Kakkar for offering assets, answering questions, and providing useful suggestions through the writing course of. This weblog submit was made potential by the collaborative help 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 data as described within the AWS Privateness Discover. AWS will personal the info gathered by way of this survey and won’t share the data collected with survey respondents.)