Akamai Connector for

Salesforce Commerce Cloud

Learn about the Akamai Connector for Salesforce Commerce Cloud, which lets your
existing Akamai delivery service communicate directly with Salesforce Commerce Cloud.

If you’re a customer of both Salesforce Commerce Cloud and Akamai, Note: If you are configuring a new property, see the Web Performance Getting
the Akamai Connector for Salesforce Commerce Cloud allows you to: Started Guide for the protocol your hostname supports (HTTP or HTTPS).

• Maintain your existing Akamai delivery service, communicating directly with To select a property:
Salesforce Commerce Cloud. 1. Log in to Luna Control Center (https://control.akamai.com).
• Tailor your site acceleration and protection features based on your 2. If your organization has multiple accounts, click the dropdown
company’s unique requirements. next to the orange Context Selector button and choose the
• Take advantage of additional Akamai products. desired account.
3. Click the Context Selector. The Select Context menu displays.
Configuration Overview
4. Either enter the property name in the Find Context field, or expand the
Akamai customers, need to complete several steps in order to use the Akamai
desired group and click on the property name.
Connector for Salesforce Commerce Cloud. Most of the tasks you need to
5. On the Property Details page, click Open Version # at the top of
complete are in Property Manager, Akamai’s portal management application.
the page and select the version number. The Property Manager Editor
To set up the Connector: displays.
1. Contact your Salesforce representative about your interest in the Connector.
2. Once Salesforce confirms they completed their setup tasks, open Property
Manager.
Select the account (1), then the
3. In Property Manager, select the property and rule you want to add the 1 property context (2).
Salesforce Commerce Cloud Connector behavior to. The Property Details screen (3)
4. Activate the updated property version in Property Manager. opens. From there open the
Property Manager Editor (4) by
Contact Your Salesforce Representative clicking the version
The first thing you need to do is contact your Salesforce representative to 2 you want to edit.
express your interest in the Akamai Connector for Salesforce Commerce Cloud.
Your representative will help you determine whether the Connector is right for your
configuration. If it is, Salesforce will:
• Work with you to determine which of your properties should use the
Connector
• Complete some behind-the-scenes configuration tasks
• Let you know when you can update your properties with the Connector 3
behavior
Once you hear back from Salesforce, you can continue with the tasks in this quick
reference.

Open the Property to Edit

After you determine which properties you want to add the Connector to, log into
Luna Control Center and select a property. Properties determine what you can do
and see on the Akamai portal. 4
Property configurations tell Akamai edge servers how to treat requests and their
subsequent responses. Each property can include multiple versions. You can set up
different property versions to meet changing business needs or to test out different
settings.
Determine Which Rule Supports Your 6. In the behavior, complete these fields:
Connector Configuration Field Action
Enable Select On to enable the Akamai Connector for
Salesforce Commerce Cloud for this property.
Salesforce Enter the ID provided by Salesforce Commerce Cloud.
Connector ID 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 Select whether to use a default or a custom Salesforce
Origin origin with the Connector. The default is the Host
header value from the incoming request.
Custom Salesforce If using a custom origin, enter the hostname or IP
Origin address of the custom Salesforce origin.

Type of Salesforce Enter the hostname or IP address of the custom

Host Header Salesforce host header. The default is the Host header
value from the incoming request.
Rules are the heart of each property version: setting them allows you to define the Custom Salesforce If using a custom host header, enter the hostname or IP
handling and behavior for any and all objects served over the Akamai platform. In the Host Header address of the custom Salesforce host header.
Property Manager Editor, the rules are listed in the Property Configuration Settings Override Enable to override the forwarding origin’s cache key.
section. Salesforce Origin See the purging section below for more information.
Cache Key
For the Connector, you will most likely edit the property’s default rule.
The default rule applies to all hostnames listed in the property configuration. The 7. Click Save.
default settings are those already present when you first create the property. So,
for a property that contains the hostname www.example.com, the default rule Activate the Property Version with the
would be “requests for hostnames matching www.example.com”. Connector Behavior
Once you’ve finished the property version settings, you are ready to activate the
You can also add a new rule or edit an existing rule. Refer to the Property Manager
version on the desired Akamai network.
help system for information about the importance of rule order, as well as rule
nesting considerations. As a best practice, you should activate on Akamai’s staging environment before
activating on the production environment.
Set Up the Connector Behavior Note: You will receive an email notification once the activation is complete.

Select the Activate tab (1).

from the Activate tab (2),
click the activation button
for the network you want
to activate on.
1

Within a rule, a behavior contains settings for a particular feature. To set up the
Salesforce Commerce Cloud Connector behavior:

1. If you have not done so already, select your property and open the Property
Manager Editor.
2. Select the rule you are adding the Connector to. 2
3. In the Behaviors section of the rule, click Add Behavior.
4. Select the Salesforce Commerce Cloud Connector behavior.
5. Click Insert Behavior.
To activate a property version: 2. You can specify which HTTP request header contains the client IP address. If
1. Access the Property Manager Editor. you enter True-Client-IP, Business Manager displays a warning that is
safe to ignore.
2. Click the Activate tab on the top of the Property Editor page.
3. If the value of the Client IP Header field is not True-Client-IP, continue
3. Click Activate v# on Network in the column for the network you want to
with this procedure. By default, the Connector sends the True-Client-IP
activate on.
header to Salesforce Commerce Cloud.
4. On the activation window, add a comment describing the change and enter
4. In Property Manager, add the Modify Incoming Request Header behavior to
the email addresses that should receive activation notifications.
the property containing your Connector settings.
5. Click Activate v# on Network.
5. In the Modify Incoming Request Header behavior, add the name of your
6. View the Version Activity area to track progress. custom client IP header, and set the header value to the AK_CLIENT_IP
system variable for Property Manager:
Purging Cache for the Connector
{{builtin.AK _ CLIENT _ IP}}.
When the Connector is in use, Salesforce purges the cache for you.
6. Save your changes and test them before deploying the updated property
However, if you have enabled Image Manager or Dynamic Page Caching on the version to production.
same property as the Connector, you’ll have to purge the cache for these products
manually. To purge the derivative images and pages, you can use either Fast Purge or
the Content Control Utility.

If you run into issues purging when using the Connector, please contact your
Salesforce representative.

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.

©2018 Akamai Technologies, Inc. All Rights Reserved. Reproduction in whole or in part in any form or medium without express written permission is prohibited. Akamai and the Akamai
wave logo are registered trademarks. Other trademarks contained herein are the property of their respective owners. Akamai believes that the information in this publication is accurate
as of its publication date; such information is subject to change without notice. Published 10/17.