Skip to navigation

Install the Salesforce Commerce Cloud Enforcer

Learn how to install the SFCC Enforcer using Salesforce cartridges.

If your organization uses Salesforce Commerce Cloud, you can use HUMAN’s Salesforce Commerce Cloud Enforcer to protect against malicious behavior. The SFCC Enforcer is installed using Salesforce cartridges and is deployed to your content delivery network (CDN). The Enforcer dictates how traffic should be handled per your organization’s standards.

You can learn how to install the SFCC Enforcer with this article.

Prerequisites

  • A Salesforce Commerce Cloud account with admin access to the Business Manager.
  • HUMAN’s SFCC cartridge ZIP file. Contact HUMAN support directly to get this file.
  • A method to deploy cartridges to your Salesforce Commerce Cloud instance. The following guide uses Eclipse with Salesforce UX Studio, but you can use other methods such as Visual Studio Code, a CLI, or Business Manager Code Deployment.
  • Your unique HUMAN information:
    • Your Application ID. You can find this in Platform Settings > Applications > Overview in the HUMAN console. If you have multiple environments, you will also have multiple Application IDs, so be sure to choose the correct ID for the environment you want to install on.
    • Your Server Token. You can find this in Platform Settings > Applications, then selecting an application and navigating to Application settings > Server token.
    • Your Risk Cookie Key. You can find this in Sightline Cyberfraud Defense > Policies > Traffic Policy Settings, then clicking the key icon and selecting Copy value. If you don’t see this option, click Generate new first.

Installation

1

Import the cartridge

  1. Unzip the HUMAN SFCC cartridge ZIP file to a local directory.
  2. In Eclipse with Salesforce UX Studio, click File > Import.
  3. In the General tab, select Existing Project into Workspace and click Next.
  4. With Select root directory selected, click Browse and navigate to the unzipped HUMAN SFCC cartridge folder.
  5. Ensure the projects are displayed and selected in the Projects area, then click Finish.
  6. Upload the cartridges to an active code version on your instance.

If your team already deploys cartridges with Visual Studio Code, a CLI, or Business Manager Code Deployment, upload the same unzipped cartridge folders to a code version using that method instead.

2

Register the cartridge

  1. In Salesforce Business Manager, select Administration > Sites > Manage Sites.
  2. Select the Storefront site that you want to add the HUMAN SFCC Cartridge to from the list available sites.
  3. Click the Settings tab.
  4. Under the Effective Cartridge Path section, add int_perimeterx: to the beginning of the list.
  5. Add the storefront cartridge that matches your site’s architecture to the beginning of the list:

The storefront cartridges attach to Salesforce’s onRequest hook and evaluate every storefront route. To skip specific paths, add them to Path Whitelist.

  1. Depending on the API you use, add the following:
  2. Click Apply to save the new settings.
3

Import metadata & services

  1. In Salesforce Business Manager, select Administration > Site Development > Site Import & Export.
  2. Under Import, click Choose File, select the metadata.zip file from cartridge directory’s metadata directory, then click Upload.
  3. After the upload finishes, select metadata.zip in the import file list and click Import to apply the metadata and services.
4

Configure the cartridge

  1. In Salesforce Business Manager, select Merchant Tools > Site Preferences > Custom Preferences.
  2. Under Custom Site Preference Groups, select PXConfig.
  3. Select your current Instance Type.
  4. Complete the following fields:
    • Authentication token: Your HUMAN Server Token.
    • AppID: Your HUMAN Application ID.
    • Cookie Key: Your HUMAN Risk Cookie Key.
    • SGJC Cartridge Name: If you use SGJC, enter your SGJC controllers cartridge name. Otherwise, leave this blank.
    • Any other optional configurations you want to set.
  5. Click Save.
5

Set up first party

If you chose to use a first party Sensor integration, then you must complete these steps. If you chose third party, you can skip to Deploy.

  1. In Salesforce Business Manager, select Merchant Tools > Site URLs > Dynamic Mapping.
  2. Add the following above the catch-all rule:
/px/** p,,,PXFP-Handle,,src,{0}
  1. Navigate to Merchant Tools > Site Preferences > Custom Preferences.
  2. In Custom Site Preference Groups, select PXConfig.
  3. Select your current Instance Type.
  4. Navigate to the First Party Enabled property and change its value to True.
  5. Click Save.
6

Deploy

  1. In Salesforce Business Manager, select Administration > Site Development > Code Deployment.
  2. Open the code version that contains both your storefront cartridges and the HUMAN cartridges. Confirm the HUMAN cartridge folders are in that version.
  3. Click Activate beside that version.

The SFCC Enforcer is now deployed to your Storefront.