Amazon Elastic Compute Cloud
User Guide for Linux Instances

Bring Your Own IP Addresses (BYOIP)

You can bring part or all of your public IPv4 address range from your on-premises network to your AWS account. You continue to own the address range, but AWS advertises it on the internet. After you bring the address range to AWS, it appears in your account as an address pool. You can create an Elastic IP address from your address pool and use it with your AWS resources, such as EC2 instances, NAT gateways, and Network Load Balancers.

Requirements

  • The address range must be registered with your regional internet registry (RIR), such as the American Registry for Internet Numbers (ARIN) or Réseaux IP Européens Network Coordination Centre (RIPE). It must be registered to a business or institutional entity and may not be registered to an individual person.

  • The most specific address range that you can specify is /24.

  • You can bring each address range to one region at a time.

  • You can bring 5 address ranges per region to your AWS account.

  • The addresses in the IP address range must have a clean history. We may investigate the reputation of the IP address range and reserve the right to reject an IP address range if it contains an IP address that has poor reputation or is associated with malicious behavior.

Prepare to Bring Your Address Range to Your AWS Account

To ensure that only you can bring your address range to your AWS account, you must authorize Amazon to advertise the address range and provide proof that you own the address range.

A Route Origin Authorization (ROA) is a document that you can create through your RIR. It contains the address range, the ASNs that are allowed to advertise the address range, and an expiration date. An ROA authorizes Amazon to advertise an address range under a specific AS number. However, it does not authorize your AWS account to bring the address range to AWS. To authorize your AWS account to bring an address range to AWS, you must publish a self-signed X509 certificate in the RDAP remarks for the address range. The certificate contains a public key, which AWS uses to verify the authorization-context signature that you provide. You should keep your private key secure and use it to sign the authorization-context message.

The commands in the following procedure require OpenSSL version 1.0.2 or later.

To prepare to bring your address range to your AWS account

  1. Create an ROA to authorize Amazon ASNs 16509 and 14618 to advertise your address range. You must set the maximum length to the size of the smallest prefix that you want to bring (for example, /24). It might take up to 24 hours for the ROA to become available to Amazon. For more information, see the following:

  2. Generate an RSA 2048-bit key pair as follows:

    openssl genrsa -out private.key 2048
  3. Create a public X509 certificate from the key pair using the following command. In this example, the certificate expires in 365 days, after which time it cannot be trusted. Therefore, be sure to set the expiration appropriately. When prompted for information, you can accept the default values.

    openssl req -new -x509 -key private.key -days 365 | tr -d "\n" > publickey.cer
  4. Create a signed message. The format of the message is as follows, where the date is the expiry date of the message:

    1|aws|account|cidr|YYYYMMDD|SHA256|RSAPSS

    The following command signs the message using the key pair that you created and saves it as base64_urlsafe_signature:

    echo "1|aws|123456789012|198.51.100.0/24|20191201|SHA256|RSAPSS" | tr -d "\n" | openssl dgst -sha256 -sigopt rsa_padding_mode:pss -sigopt rsa_pss_saltlen:-1 -sign private.key -keyform PEM | openssl base64 | tr -- '+=/' '-_~' | tr -d "\n" > base64_urlsafe_signature
  5. Update the RDAP record for your RIR with the X509 certificate. Be sure to copy the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- from the certificate. To view your certificate, run the following command:

    cat publickey.cer

    For ARIN, add the certificate in the "Public Comments" section for your address range.

    For RIPE, add the certificate as a new "desc" field for your address range.

Provision the Address Range for use with AWS

When you provision an address range for use with AWS, you are confirming that you own the address range and authorizing Amazon to advertise it. We also verify that you own the address range.

To provision the address range, use the following provision-byoip-cidr command. The message in the --cidr-authorization-context parameter is the signed message that you created in the previous section, not the ROA message.

aws ec2 provision-byoip-cidr --cidr address-range --cidr-authorization-context Message="message",Signature="signature"

Provisioning an address range is an asynchronous operation, so the call returns immediately, but the address range is not ready to use until its status changes from pending-provision to provisioned. To monitor the status of the address range, use the following describe-byoip-cidrs command:

aws ec2 describe-byoip-cidrs --max-results 5

Advertise the Address Range through AWS

After the address range is provisioned, it is ready to be advertised. We recommend that you stop advertising the address range from other locations before you advertise it through AWS. If you keep advertising your IP address range from other locations, we can't reliably support it or troubleshoot issues. Specifically, we can't guarantee that traffic to the address range will enter our network.

To minimize down time, you can configure your AWS resources to use an address from your address pool before it is advertised, and then simultaneously stop advertising it from the current location and start advertising it through AWS. For more information about allocating an Elastic IP address from your address pool, see Allocating an Elastic IP Address.

To advertise the address range, use the following advertise-byoip-cidr command:

aws ec2 advertise-byoip-cidr --cidr address-range

Important

You can run the advertise-byoip-cidr command at most once every 10 seconds, even if you specify different address ranges each time.

To stop advertising the address range, use the following withdraw-byoip-cidr command:

aws ec2 withdraw-byoip-cidr --cidr address-range

Important

You can run the withdraw-byoip-cidr command at most once every 10 seconds, even if you specify different address ranges each time.

Deprovision the Address Range

To stop using your address range with AWS, release any Elastic IP addresses still allocated from the address pool, stop advertising the address range, and deprovision the address range.

To release each Elastic IP address, use the following release-address command:

aws ec2 release-address --allocation-id eipalloc-12345678

To stop advertising the address range, use the following withdraw-byoip-cidr command:

aws ec2 withdraw-byoip-cidr --cidr address-range

To deprovision the address range, use the following deprovision-byoip-cidr command:

aws ec2 deprovision-byoip-cidr --cidr address-range