Overview

Domain Whitelisting is a security feature by CleverTap that ensures only approved domains can send data to your CleverTap account. This helps prevent unauthorized data ingestion, protects against data pollution, and safeguards campaign execution.

🚧

SDK Compatibility

Domain Whitelisting for Web is compatible with SDK version 1.17.0 and above. To check your Web SDK version, use the clevertap.getSDKVersion method.

By default, the Web SDK accepts events from all domains. When domain whitelisting is enabled, CleverTap checks the source of each Web SDK request. If the domain matches one of the entries in your allowlist, the data is accepted; otherwise, it is rejected. When the feature is disabled (the default setting), data is accepted from all domains without restriction.

📘

Note

• You can add up to 20 domains per account.
• Only admins can make changes to domain whitelisting. This permission cannot be assigned to custom roles.

Set Up Domain Whitelisting

To set up Domain Whitelisting:

1. Click Settings, then go to Security > Domain Whitelisting.
2. Click Whitelist Domain.

3. Enter a domain name and a name for identification.
4. Click Whitelist to add the domain to your allowlist.

5. Use the toggle switch in the dashboard to enable or disable domain whitelisting.

📘

Note

• Whitelisting only takes effect after at least one domain is added and the toggle is switched on.
• When domain whitelisting is enabled or disabled, an email is sent to the account admin to notify the change.

7. You can edit and delete domains from the list at any time.

Domain Name Guidelines

Adhere to the following domain name guidelines when adding domains to your allowlist. The following are valid domain name formats:

• www.example.com
• example.com

The following are invalid domain name formats and can not be saved:

• https://example.com or example.com/path - Do not include protocols (https://) or paths. Use only the root domain, such as example.com.
• Duplicate or conflicting domains are not allowed. For example, www.example.com and example.com.