Add the Protocol Downgrade behavior

The process to add Protocol Downgrade varies, based on a new or existing Download Delivery property.

Add it to a new Download Delivery property

📘

This process doesn't cover all of the steps required to properly set up a new Download Delivery property. It only reveals the steps necessary to add the Protocol Downgrade (HTTPS Downgrade to Origin) behavior. See Define property configuration settings for more details on creating a Download Delivery property.

Protocol Downgrade (HTTPS Downgrade to Origin) is supported for use with either Standard TLS (L1) security or via the ​Akamai​ shared certificate hostname. You need to apply these securities via a Property hostname to Edge hostname association.

  1. Determine the level of security you want for access requests to your property:

    • Standard TLS. First, you need to create a new certificate using the ​Akamai​ Certificate Provisioning System. You'll need to complete the entire process and wait for the certificate to provision before continuing. (You'll receive an email when the cert is ready.) There are some specific considerations:

    • ​Akamai​ shared certificate hostname. This lets you quickly create a secure hostname that automatically incorporates a secure, shared certificate for access. There are no additional requirements if this is your chosen secure access method.

  2. Create a new Download Delivery property using Property Manager.

  3. Use the Property Hostname content panel to create a Property hostname to Edge hostname association, based on your selected level of security:

  4. In the Property Configuration Settings options, click Add Behavior.

  5. In the Search available behaviors field, input "Protocol Downgrade" to filter the listed behaviors. Ensure that you select Protocol Downgrade (HTTPS Downgrade to Origin) from the list.

  6. The new behavior is added to your configuration. Set the Status slider to On.

Add it to an existing Download Delivery property

You can apply the Protocol Downgrade (HTTPS Downgrade to Origin) behavior to an existing Download Delivery property, provided that configuration meets various requirements.

The property must deliver securely (HTTPS)

To support Protocol Downgrade (HTTPS Downgrade to Origin), an existing Download Delivery property must be set up to deliver content securely, via HTTPS. The following apply:

  • Standard TLS (L1). This is supported. You just need to add the behavior.

  • Shared Certificate hostname: This is supported. You just need to add the behavior.

  • Enhanced TLS (L3). This is NOT supported. You can migrate your configuration to Standard TLS (L1) if PCI compliance is not a concern in your environment. (PCI compliance isn't supported with Standard TLS.) Otherwise, you can work with your Account Representative to implement the legacy Protocol Downgrade behavior.

  • No security. This would apply if your current configuration delivers exclusively via HTTP and you need to convert to HTTPS, but want to keep the connection from your origin to the end user as HTTP. Here, you can apply security to this configuration (Standard TLS or Shared certificate hostname) and then apply this behavior. This would be similar to adding the behavior to a new property.

Add the Protocol Downgrade (HTTPS Downgrade to Origin) behavior

  1. In the Property Configuration Settings options, click Add Behavior.

  2. In the Search available behaviors field, input "Protocol Downgrade" to filter the listed behaviors. Ensure that you select Download Delivery from the list.

  3. The new behavior is added to your configuration. Set the Status slider to On.

The Cache Key Sharing behavior might be necessary

Once you enable Download Delivery in your Download Delivery property, a warning message is added to the Errors/Warnings/Notes Messages Display at the bottom of the Property Manager Editor UI. Click the up triangle (  ) to display messages.

As a result of the change from HTTPS to HTTP, the cache key will change. You should add this behavior and set it to On if your origin can't handle the excessive additional requests that this change may require.

📘

This applies to adding Protocol Downgrade to both new and existing properties


Did this page help you?