Akamai Connector for Salesforce Commerce Cloud

If youโ€™re a customer of both Salesforce Commerce Cloud and โ€‹Akamaiโ€‹, with the โ€‹Akamaiโ€‹ Connector for Salesforce Commerce Cloud you can:

  • Maintain your existing โ€‹Akamaiโ€‹ delivery service, communicating directly with Salesforce Commerce Cloud.
  • Tailor your site acceleration and protection features based on your companyโ€™s unique requirements.
  • Take advantage of additional โ€‹Akamaiโ€‹ products.

Implementation

  1. Open a Salesforce support ticket to begin the โ€‹Akamaiโ€‹ Connector integration.
  2. Once Salesforce confirms that their setup tasks are complete, open Property Manager.
  3. In Property Manager, select the property and rule you want to add the Connector behavior to.
  4. Add and set up the โ€‹Akamaiโ€‹ Connector for Salesforce Commerce Cloud behavior:

Field

Action

Enable

Set to On to enable the Connector for this property.

Salesforce Connector ID

Enter the ID provided by Salesforce Commerce Cloud. When entering the ID, make sure it starts with the correct instance for your implementation. The instance can either be production or development (sandbox). For example, this ID would be for a development instance of Salesforce Commerce Cloud: development-urn.example.salesforce-example_name.

Type of Salesforce Origin

Select whether to use a default or a custom Salesforce origin with the Connector. The default is the Host header value from the incoming request.

Custom Salesforce Origin

If using a custom origin, enter the hostname or IP address of the custom Salesforce origin.

Type of Salesforce Host Header

Enter the hostname or IP address of the custom Salesforce host header. The default is the Host header value from the incoming request.

Custom Salesforce Host Header

If using a custom host header, enter the hostname or IP address of the custom Salesforce host header.

Override Salesforce Origin Cache Key

Enable to override the forwarding originโ€™s cache key.

  1. Save your changes to the rule.
  2. Activate the property version.
  3. If you generate dynamic content on your Salesforce Commerce Cloud Origin, review Custom Client IP header Considerations.
  4. Review purge considerations.

Custom Client IP Header Considerations

If you generate dynamic content on your Salesforce Commerce Cloud Origin, you may need to complete a few extra steps to get the Connector to work.

  1. In the Salesforce Commerce Cloud Business Manager, review your Customer Content Delivery Network Settings.

  2. Specify which HTTP request header contains the client IP address.

If you enter True-Client-IP, Business Manager displays a warning that is safe to ignore.

  1. If the value of the Client IP Header field is not True-Client-IP, continue with this procedure. By default, the Connector sends the True-Client-IP header to Salesforce Commerce Cloud.

  2. In Property Manager, add the Modify Incoming Request Header behavior to the property containing your Connector settings.

  3. In the Modify Incoming Request Header behavior:

    • Add the name of your custom client IP header.

    • Set the header value to the AK_CLIENT_IP system variable for Property Manager: {{builtin.AK_CLIENT_IP}}.

  4. Save your changes and test them before activating the updated property version to production.

Purging Cache for the Connector

When the Connector is in use, Salesforce caches objects from your Salesforce Commerce Cloud origins within their configurations. Given this, Salesforce needs to purge your objects from their cache on your behalf. If you run into issues purging when using the Connector, contact your Salesforce representative.

However, if either Image Manager or Dynamic Page Caching is enabled on the same property as the Connector, Salesforce first has to purge the content on their configurations and inform you that the purge is complete. You'll then have to purge the cache for these products manually on the โ€‹Akamaiโ€‹ platform. To purge the derivative images and pages, you can use either Fast Purge or the Content Control Utility. Issues encountered with purging in these cases may require assistance from both Salesforce and โ€‹Akamaiโ€‹, so contact โ€‹Akamaiโ€‹ technical support for further guidance.


Did this page help you?