What are the trusted Whatfix domains to whitelist?

If your organization uses a firewall to restrict network access to only specific websites or software, then you need to whitelist the following domains to ensure that your application can communicate with Whatfix and fetch content for your end users to view.

Also, if your organization has a Content Security Policy (CSP) in place to block external code insertions, then it could prevent Whatfix from working on your application.

To prevent this from happening and to resolve CSP violation errors, the following domains must be added as an exception (Whitelisted) as part of the application's CSP headers. For more information, see Content Security Policy Reference.

Domains to Whitelist:

For all users (excluding EU data centre users):

• https://whatfix.com/*

• https://cdn.whatfix.com/*

• https://cdn.whatfix.com/org_desktop_release/<ORG_ID>/manifest.json

Info:

Replace <ORG_ID> with your Organization ID. Contact your Whatfix Representative to get your Organization ID.

For EU data center users:

• https://eu.whatfix.com/*

• https://eucdn.whatfix.com/*

• https://eucdn.whatfix.com/org_desktop_release/<ORG_ID>/manifest.json

Info:

Replace <ORG_ID> with your Organization ID. Contact your Whatfix Representative to get your Organization ID.

Note:

• Your IT Admin can help in whitelisting the mentioned domains.

• If you are using any video or image links in your Whatfix content, then you need to whitelist those domains as well. For example, if you embed a YouTube video in a Pop-up, then you need to whitelist youtube.com.

For organizations that use Proxy servers

If your organization uses Zscaler or some other equivalent proxy server, then it could prevent Whatfix widgets from showing up even after the successful installation of the Desktop Player and Editor apps.

To prevent this issue, you must exempt the following Whatfix URLs from SSL certificate inspection,

• https://cdn.whatfix.com

• Other Whatfix URLs mentioned in this article

To know more about SSL exemption for Zscaler, see,

• Exempting URLs and Cloud Apps from Authentication

• About Zscaler Cookies

• About Provisioning and Authenticating Users

When do domains need whitelisting?

Whatfix recommends whitelisting the domains before you start creating content on Whatfix. This way, content creators will not have any issues previewing and testing the content.

IP addresses to Whitelist

Note:

IP addresses are the same for all users.

Processes to whitelist

Allow the nw.exe process in your firewall. For more information on how to whitelist a process in your Windows firewall, see Microsoft's official documentation.

Best Practices

Make sure you have applied the policy to every page. This must include error pages as well.