Configuring Content Security Policies (CSP) for Hub Embeds

Overview

A CSP (Content Security Policy) is a security feature implemented by websites to prevent a wide range of attacks, such as cross-site scripting (XSS) and data injection attacks. It acts as a whitelist that controls what types of resources (scripts, styles, images, etc.) a browser is allowed to load and execute on a webpage.

CSP works by letting the site owner specify a set of rules through HTTP headers or meta tags that define which domains or sources are trusted. For example, a CSP policy might allow images to be loaded only from specific domains, or it might block inline scripts unless they are explicitly allowed.

By restricting which external resources can be loaded, CSP helps to mitigate vulnerabilities that hackers could exploit by injecting malicious code into a website.

When embedding Hub into your website or app, you may have to add to add Hub specific domains to your CSP policy.

CSP Configuration

Strictest CSP Policy

At a minimum, the following CSP should work for most users embedding Hub:

Copy the following URLs

Content-Security-Policy:
  connect-src https://api.released.so https://events.released.so;
  script-src https://embed.released.so;
  style-src 'unsafe-inline' https://cdn.released.so https://embed.released.so;
  img-src https://cdn.released.so https://dwamxgqy3aotj.cloudfront.net;
  font-src https://embed.released.so

Please note that these policies cannot be copied as-is and instead must be merged with your existing policy, otherwise your own assets will be blocked by this policy.

Recommended CSP Policy

To simplify updates and future-proof your policy against changes we make, we recommend using the source https://*.released.so to allow any subdomain of released.so as a source:

Copy

Content-Security-Policy:
  connect-src https://*.released.so;
  script-src https://*.released.so;
  style-src 'unsafe-inline' https://*.released.so;
  img-src https://*.released.so https://dwamxgqy3aotj.cloudfront.net;
  font-src https://*.released.so

This policy covers all potential subdomains of Hub, making it easier to accommodate updates or changes in our infrastructure without further adjustments.

Additional Media Domains

If you are embedding video files or media content into your release notes and roadmaps and your CSP policy already includes a media-src or default-src directive, you will need to extend your media-src directive to include the locations of those images and videos.

Final Recommendations

For maximum flexibility and security, adopting the wildcard strategy (*.released.so) in your CSP will help avoid issues as Hub evolves. If you encounter specific errors, contact our support team for further assistance.