Skip to content

Deployment and Content Delivery

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 app 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 app.

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 center users):

Info:

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

CSP directives to whitelist:

Info:

  • Depending on the deployment model, you need to whitelist only the necessary directives.
  • Whitelist Google Analytics (GA) domains only if you have it configured for your account.
Deployment ModelCSP DirectivesDomain/value
Export (Content on the same server)connect-src*whatfix.com
www.google-analytics.com
analytics.google.com
style-srcunsafe-inline
img-srcdata:
www.google-analytics.com
analytics.google.com
font-src*.whatfix.com
media-src*.whatfix.com
Export (Content fetched from a different domain server)connect-src*whatfix.com
www.google-analytics.com
analytics.google.com
script-src*.<domain>, <domain>
frame-src
style-srcunsafe-inline
img-srcdata:
www.google-analytics.com
analytics.google.com
font-src*.whatfix.com
media-src*.whatfix.com
CDNconnect-src*.whatfix.com
*.whatfix.com
www.google-analytics.com
analytics.google.com
script-src*.whatfix.com
frame-src
style-srcunsafe-inline
img-srcdata:
www.google-analytics.com
analytics.google.com
font-src*.whatfix.com
media-src*.whatfix.com
Extensionconnect-srcwww.google-analytics.com
analytics.google.com
img-srcdata:
www.google-analytics.com
analytics.google.com
font-src*.whatfix.com
media-src*.whatfix.com
Dev scriptconnect-src*.whatfix.com
*whatfix.com
www.google-analytics.com
analytics.google.com
img-srcdata:
www.google-analytics.com
analytics.google.com
script-src*.whatfix.com *whatfix.com
frame-src
font-src*.whatfix.com
media-src*.whatfix.com

For EU data center users:

Info:

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

CSP directives to whitelist for EU Data Centers

Deployment ModelCSP DirectivesDomain/value
CDNconnect-src*.whatfix.com *.whatfix.com *.whatfix.com
script-src
frame-src
font-src*.whatfix.com
media-src*.whatfix.com
Dev scriptconnect-src*.whatfix.com *whatfix.com
script-src
frame-src
font-src*.whatfix.com
media-src*.whatfix.com

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,

To know more about SSL exemption for Zscaler, see


When do domains need whitelisting?

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


IP addresses to Whitelist

To ensure that Whatfix can access your organization's resources for crawling knowledge base content and integrations, you need to whitelist the certain IP addresses. For a list of all the IP addresses you need to whitelist, see IP Ranges.

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 Practice

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