This DataDome module is to be used on Salesforce Commerce Cloud.

📘

Why use this module?

The new SalesforceCommerceCloud cartridge has been designed to use newer features of the Salesforce Commerce Cloud API and enhance the protection.

• Improved Architecture: This new cartridge makes the integration more secure, reliable, and better suited to modern security practices.
• Simplified DataDome Client-Side Integration: This new cartridge reduces the complexity and improves the overall compatibility with DataDome client-side integrations.
• Prioritized Maintenance: Moving forward, the SalesforceCommerceCloud cartridge will receive prioritized updates and support. This ensures ongoing improvements in security, performance, and ease of use, while the old cartridge will see limited future development.

Compatibility

The DataDome cartridge has been tested on:

• SFRA v7.0.0
• SiteGenesis v105.0.0
• All with Compatibility Mode v21.2

Installation

Migration from the SFCC cartridge

🚧

If you installed the previous cartridge:

Skip this page and follow these instructions: How to migrate from SFCC cartridge to SalesforceCommerceCloud

Requirements

• The server-side key available in your DataDome dashboard
• The client-side key available in your DataDome dashboard

Instructions

1. Download the DataDome cartridges
   It contains the following files and directories:
   • metadata.zip
   • int_datadome_bot_protect
   • datadome_bot_protect_sg_changes
   • datadome_bot_protect_sfra_changes

Upload the cartridges

2. Navigate to: Administration > Site Development > Code Deployment.
3. Create a new Code version.
4. Click on the version ID you have just created.
   This version summary will give you a WebDAV link to upload your cartridges.
   Note that DataDome cartridges should be uploaded to the root folder of your version.

Upload the metadata

5. Navigate to: Administration > Site development > Site Import & Export.
6. From the archive, upload the metadata.zip file.
7. Select instance/metadata.zip and click on Import to complete the import process.
8. You can check the import status at the bottom of the page.

Register the cartridges

9. Navigate to the following path: Administration dropdown > Sites > Manage Sites > Merchant Site > Settings.

10. Add the cartridge names to the Cartridges path, depending on your architecture:

    • For SiteGenesis: datadome_bot_protect_sg_changes:int_datadome_bot_protect: at the beginning of the Cartridges field.
    
    

    

    • For SFRA: datadome_sfra_changes:int_datadome: at the beginning of the Cartridges field.
    
    

    

Configure the service

11. Navigate to: Administration > Operations > Services.
12. Make sure the import was successful: the following will be added.

Configure the metadata

13. Navigate to Site > Merchant Tools > Site Preferences > Custom Preferences > DataDome Bot Protect Configurations

14. Enter your the server-side and client-side keys for DataDome APIs.

15. Save the configuration.

Congrats! You can now see your traffic in your DataDome dashboard.

Configuration

The configuration is found under Site > Merchant Tools > Site Preferences > Custom Preferences > DataDome Bot Protect Configurations.

Refer to the Settings section below for the full list of possible configuration settings.

Settings