Migration guide

Migrating from the SFCC cartridge to the SalesforceCommerceCloud cartridge is nearly as simple as performing an update. Just follow these few additional steps, and you’ll be protected by the latest version of our SalesforceCommerceCloud cartridge.

Install the new cartridge

  1. Follow the installation steps provided for the new cartridge. Make sure to install it as per the documentation.

Copy the configuration values

  1. Navigate to Site > Merchant Tools > Site Preferences > Custom Preferences > DataDome Configurations. Here, you’ll find the previous configuration settings.

  2. Keep the currently active DataDome settings to reuse them in the new integration. These options are listed below.

    Name in DataDomeName in DataDome Bot protectComment
    DataDome API KeyDataDome Server-side API Key
    DataDome JS KeyDataDome Client-side API Key
    JS Tag OptionsDataDome Client-side OptionsThe option sfcc: trueshould be removed.
    JS Tag URLDataDome JS Tag URL
    JS Tag EndpointDataDome JS Tag Endpoint
    DataDome Excluded Request RegexDataDome URL Pattern Exclusion Regex
    DD Allowed Request RegexDataDome URL Pattern Inclusion Regex
  3. Navigate to Site > Merchant Tools > Site Preferences > Custom Preferences > DataDome Bot Protect Configurations. Here, you’ll find the new configuration settings.

  4. Enter the values you listed in step 3, taking into account the comments.

Deactivate the old cartridge

Navigate to Site > Merchant Tools > Site Preferences > Custom Preferences > DataDome Configurations.

Set the value of DataDome Cartridge Enabled to false.

Congratulations! You are now protected by the latest version of our Salesforce Commerce Cloud Cartridge.