Allow Mavenoid resources in your site's content security policy (CSP)

Question

Accepted Answer

The Mavenoid assistant requires several resources hosted on mavenoid.com and a few other domains. If your website is using a content security policy (CSP), you will need to ensure that policy allows the required resources.

How to tell if this is a problem

If your website's content security policy blocks a Mavenoid resource, the assistant may not load or may look incorrect. You will see an error like this in the developer console:

Content Security Policy: The page's settings blocked the loading of a resource at https://app.mavenoid.com/static/js/21.8eafcd6b.chunk.js ("default-src").

The exact URL and text in parentheses may differ.

How to fix it

Be careful adding new directives. Work with your development and security teams to determine the correct set of directives to use.

For each of the following fetch directives, if your site is using a restrictive policy you will need to add the listed values.

connect-src *.mavenoid.com mavenoidfiles.com *.mavenoidfiles.com wss://twilio.com wss://*.twilio.com sentry.io *.sentry.io
font-src *.mavenoid.com
img-src *.mavenoid.com mavenoidfiles.com *.mavenoidfiles.com
script-src *.mavenoid.com
style-src *.mavenoid.com
media-src mavenoidfiles.com *.mavenoidfiles.com mediastream:

For example, if your content security policy is set to the following:

Content-Security-Policy: default-src *; img-src *.example.com; script-src *.example.com

We recommend updating it to the following:

Content-Security-Policy: default-src *; img-src *.example.com *.mavenoid.com mavenoidfiles.com *.mavenoidfiles.com; script-src *.example.com *.mavenoid.com

What each domain is used for

`mavenoid.com`

Serves the scripts that power the Mavenoid assistant, as well as some of the font, image, and style resources it uses.

If this domain is blocked, the assistant will not load at all.

`mavenoidfiles.com`

Serves any image assets or PDF documents embedded in a flow, any files uploaded by the user in a form, and any images or files shared in live support chat.

If this domain is blocked, none of these will display in the assistant.

`twilio.com`

Used in live support to connect agents and end users.

If this domain is blocked, live support won't work.

`sentry.io`

Detects and reports front-end errors.

If this domain is blocked, errors will not be reported automatically and will be harder to track and solve.

If your flows include embedded videos

If your flows include embedded YouTube or Vimeo videos, your site will also need to allow the use of frames embedding content from those sites. If your site is using a policy including the frame-src fetch directive, you will need to allow *.youtube.com and/or *.vimeo.com for that directive depending which site you are embedding from.

If the policy restricts by scheme

If your website's policy restricts by scheme, ensure that blob: is allowed for any script-src, worker-src, or img-src directives.

Administrators & Analysts