Specify signers that can create signed URLs and signed cookies (original) (raw)

Topics

• Choose between trusted key groups (recommended) and AWS accounts
• Create key pairs for your signers
• Reformat the private key (.NET and Java only)
• Add a signer to a distribution
• Rotating key pairs

To create signed URLs or signed cookies, you need a signer. A signer is either a trusted key group that you create in CloudFront, or an AWS account that contains a CloudFront key pair. We recommend that you use trusted key groups with signed URLs and signed cookies. For more information, see Choose between trusted key groups (recommended) and AWS accounts.

The signer has two purposes:

• As soon as you add the signer to your distribution, CloudFront starts to require that viewers use signed URLs or signed cookies to access your files.
• When you create signed URLs or signed cookies, you use the private key from the signer’s key pair to sign a portion of the URL or the cookie. When someone requests a restricted file, CloudFront compares the signature in the URL or cookie with the unsigned URL or cookie, to verify that it hasn’t been tampered with. CloudFront also verifies that the URL or cookie is valid, meaning, for example, that the expiration date and time hasn’t passed.

When you specify a signer, you also indirectly specify the files that require signed URLs or signed cookies by adding the signer to a cache behavior. If your distribution has only one cache behavior, viewers must use signed URLs or signed cookies to access any file in the distribution. If you create multiple cache behaviors and add signers to some cache behaviors and not to others, you can require that viewers use signed URLs or signed cookies to access some files and not others.

To specify the signers (the private keys) that are allowed to create signed URLs or signed cookies, and to add the signers to your CloudFront distribution, do the following tasks:

1. Decide whether to use a trusted key group or an AWS account as the signer. We recommend using a trusted key group. For more information, see Choose between trusted key groups (recommended) and AWS accounts.
2. For the signer that you chose in step 1, create a public–private key pair. For more information, see Create key pairs for your signers.
3. If you’re using .NET or Java to create signed URLs or signed cookies, reformat the private key. For more information, see Reformat the private key (.NET and Java only).
4. In the distribution for which you’re creating signed URLs or signed cookies, specify the signer. For more information, see Add a signer to a distribution.

Choose between trusted key groups (recommended) and AWS accounts

To use signed URLs or signed cookies, you need a signer. A signer is either a trusted key group that you create in CloudFront, or an AWS account that contains a CloudFront key pair. We recommend that you use trusted key groups, for the following reasons:

• With CloudFront key groups, you don’t need to use the AWS account root user to manage the public keys for CloudFront signed URLs and signed cookies. AWS best practices recommend that you don’t use the root user when you don’t have to.
• With CloudFront key groups, you can manage public keys, key groups, and trusted signers using the CloudFront API. You can use the API to automate key creation and key rotation. When you use the AWS root user, you have to use the AWS Management Console to manage CloudFront key pairs, so you can’t automate the process.
• Because you can manage key groups with the CloudFront API, you can also use AWS Identity and Access Management (IAM) permissions policies to limit what different users are allowed to do. For example, you can allow users to upload public keys, but not delete them. Or you can allow users to delete public keys, but only when certain conditions are met, such as using multi-factor authentication, sending the request from a particular network, or sending the request within a particular date and time range.
• With CloudFront key groups, you can associate a higher number of public keys with your CloudFront distribution, giving you more flexibility in how you use and manage the public keys. By default, you can associate up to four key groups with a single distribution, and you can have up to five public keys in a key group.
  When you use the AWS account root user to manage CloudFront key pairs, you can only have up to two active CloudFront key pairs per AWS account.

Create key pairs for your signers

Each signer that you use to create CloudFront signed URLs or signed cookies must have a public–private key pair. The signer uses its private key to sign the URL or cookies, and CloudFront uses the public key to verify the signature.

The way that you create a key pair depends on whether you use a trusted key group as the signer (recommended), or a CloudFront key pair. For more information, see the following sections. The key pair that you create must meet the following requirements:

• It must be an SSH-2 RSA key pair.
• It must be in base64-encoded PEM format.
• It must be a 2048-bit key pair.

To help secure your applications, we recommend that you rotate key pairs periodically. For more information, see Rotating key pairs.

Create a key pair for a trusted key group (recommended)

To create a key pair for a trusted key group, perform the following steps:

1. Create the public–private key pair.
2. Upload the public key to CloudFront.
3. Add the public key to a CloudFront key group.

For more information, see the following procedures.

To create a key pair

Note

The following steps use OpenSSL as an example of one way to create a key pair. There are many other ways to create an RSA key pair.

1. The following example command uses OpenSSL to generate an RSA key pair with a length of 2048 bits and save to the file namedprivate_key.pem.

openssl genrsa -out private_key.pem 2048  

1. The resulting file contains both the public and the private key. The following example command extracts the public key from the file namedprivate_key.pem.

openssl rsa -pubout -in private_key.pem -out public_key.pem  

You upload the public key (in the public_key.pem file) later, in the following procedure.

To upload the public key to CloudFront

1. Sign in to the AWS Management Console and open the CloudFront console athttps://console.aws.amazon.com/cloudfront/v4/home.
2. In the navigation menu, choose Public keys.
3. Choose Create public key.
4. In the Create public key window, do the following:
   1. For Key name, type a name to identify the public key.
   2. For Key value, paste the public key. If you followed the steps in the preceding procedure, the public key is in the file named public_key.pem. To copy and paste the contents of the public key, you can:
      • Use the cat command on the macOS or Linux command line, like this:

      cat public_key.pem  

      Copy the output of that command, then paste it into the Key value field.

      • Open the public_key.pem file with a plaintext editor like Notepad (on Windows) or TextEdit (on macOS). Copy the contents of the file, then paste it into theKey value field.
   3. (Optional) For Comment, add a comment to describe the public key.
      When finished, choose Add.
5. Record the public key ID. You use it later when you create signed URLs or signed cookies, as the value of the Key-Pair-Id field.

To add the public key to a key group

1. Open the CloudFront console at https://console.aws.amazon.com/cloudfront/v4/home.
2. In the navigation menu, choose Key groups.
3. Choose Add key group.
4. On the Create key group page, do the following:
   1. For Key group name, type a name to identify the key group.
   2. (Optional) For Comment, type a comment to describe the key group.
   3. For Public keys, select the public key to add to the key group, then choose Add. Repeat this step for each public key that you want to add to the key group.
5. Choose Create key group.
6. Record the key group name. You use it later to associate the key group with a cache behavior in a CloudFront distribution. (In the CloudFront API, you use the key group ID to associate the key group with a cache behavior.)

Important

We recommend that you create a public key for a trusted key group instead of following these steps. For the recommended way to create public keys for signed URLs and signed cookies, see Create a key pair for a trusted key group (recommended).

You can create a CloudFront key pair in the following ways:

• Create a key pair in the AWS Management Console and download the private key. See the following procedure.
• Create an RSA key pair by using an application such as OpenSSL, and then upload the public key to the AWS Management Console. For more information about creating an RSA key pair, see Create a key pair for a trusted key group (recommended).

To create CloudFront key pairs in the AWS Management Console

1. Sign in to the AWS Management Console using the credentials of the AWS account root user.

Important

IAM users can’t create CloudFront key pairs. You must sign in using root user credentials to create key pairs. 2. Choose your account name, then choose My Security Credentials. 3. Choose CloudFront key pairs. 4. Confirm that you have no more than one active key pair. You can’t create a key pair if you already have two active key pairs. 5. Choose Create New Key Pair.

Note

You can also choose to create your own key pair and upload the public key. CloudFront key pairs support 1024, 2048, or 4096-bit keys. 6. In the Create Key Pair dialog box, chooseDownload Private Key File, and then save the file on your computer.

Important

Save the private key for your CloudFront key pair in a secure location, and set permissions on the file so that only the desired administrators can read it. If someone gets your private key, they can generate valid signed URLs and signed cookies and download your content. You cannot get the private key again, so if you lose or delete it, you must create a new CloudFront key pair. 7. Record the key pair ID for your key pair. (In the AWS Management Console, this is called the Access Key ID.) You’ll use it when you create signed URLs or signed cookies.

Reformat the private key (.NET and Java only)

If you’re using .NET or Java to create signed URLs or signed cookies, you cannot use the private key from your key pair in the default PEM format to create the signature. Instead, do the following:

• .NET framework – Convert the private key to the XML format that the .NET framework uses. Several tools are available.
• Java – Convert the private key to DER format. One way to do this is with the following OpenSSL command. In the following command, private_key.pem is the name of the file that contains the PEM-formatted private key, andprivate_key.der is the name of the file that contains the DER-formatted private key after you run the command.

openssl pkcs8 -topk8 -nocrypt -in private_key.pem -inform PEM -out private_key.der -outform DER  

To ensure that the encoder works correctly, add the JAR for the Bouncy Castle Java cryptography APIs to your project and then add the Bouncy Castle provider.

Add a signer to a distribution

A signer is the trusted key group (recommended) or CloudFront key pair that can create signed URLs and signed cookies for a distribution. To use signed URLs or signed cookies with a CloudFront distribution, you must specify a signer.

Signers are associated with cache behaviors. This allows you to require signed URLs or signed cookies for some files and not for others in the same distribution. A distribution requires signed URLs or cookies only for files that are associated with the corresponding cache behaviors.

Similarly, a signer can only sign URLs or cookies for files that are associated with the corresponding cache behaviors. For example, if you have one signer for one cache behavior and a different signer for a different cache behavior, neither signer can create signed URLs or cookies for files that are associated with the other cache behavior.

Important

Before you add a signer to your distribution, do the following:

• Define the path patterns in cache behaviors and the sequence of cache behaviors carefully so you don’t give users unintended access to your content or prevent them from accessing content that you want to be available to everyone.
  For example, suppose a request matches the path pattern for two cache behaviors. The first cache behavior does not require signed URLs or signed cookies and the second cache behavior does. Users will be able to access the files without using signed URLs or signed cookies because CloudFront processes the cache behavior that is associated with the first match.
  For more information about path patterns, see Path pattern.
• For a distribution that you’re already using to distribute content, make sure you’re ready to start generating signed URLs and signed cookies before you add a signer. When you add a signer, CloudFront rejects requests that don’t include a valid signed URL or signed cookie.

You can add signers to your distribution using either the CloudFront console or the CloudFront API.

Console

The following steps show how to add a trusted key group as a signer. You can also add an AWS account as a trusted signer, but it’s not recommended.

To add a signer to a distribution using the console

1. Record the key group ID of the key group that you want to use as a trusted signer. For more information, see Create a key pair for a trusted key group (recommended).
2. Open the CloudFront console at https://console.aws.amazon.com/cloudfront/v4/home.
3. Choose the distribution whose files you want to protect with signed URLs or signed cookies.

Note

To add a signer to a new distribution, you specify the same settings that are described in step 6 when you create the distribution. 4. Choose the Behaviors tab. 5. Select the cache behavior whose path pattern matches the files that you want to protect with signed URLs or signed cookies, and then chooseEdit. 6. On the Edit Behavior page, do the following:

1. For Restrict Viewer Access (Use Signed URLs or Signed Cookies), chooseYes.
2. For Trusted Key Groups or Trusted Signer, choose Trusted Key Groups.
3. For Trusted Key Groups, choose the key group to add, and then choose Add. Repeat if you want to add more than one key group.
4. Choose Yes, Edit to update the cache behavior.

API

You can use the CloudFront API to add a trusted key group as a signer. You can add a signer to an existing distribution or to a new distribution. In either case, specify the values in the TrustedKeyGroups element.

You can also add an AWS account as a trusted signer, but it’s not recommended.

See the following topics in the Amazon CloudFront API Reference:

• Update an existing distribution – UpdateDistribution
• Create a new distribution – CreateDistribution

Rotating key pairs

We recommend that you periodically rotate (change) your key pairs for signed URLs and signed cookies. To rotate key pairs that you’re using to create signed URLs or signed cookies without invalidating URLs or cookies that haven’t expired yet, do the following tasks:

1. Create a new key pair, and add the public key to a key group. For more information, see Create a key pair for a trusted key group (recommended).
2. If you created a new key group in the previous step, add the key group to the distribution as a signer.

Important

Don’t remove any existing public keys from the key group, or any key groups from the distribution yet. Only add the new ones. 3. Update your application to create signatures using the private key from the new key pair. Confirm that the signed URLs or cookies that are signed with the new private keys are working. 4. Wait until the expiration date has passed in URLs or cookies that were signed using the previous private key. Then remove the old public key from the key group. If you created a new key group in step 2, remove the old key group from your distribution.