Vue Embedded AnalyticsSecurity

Version 3.1.0

AG Studio exposes security tools and parameters so an application can meet its own security requirements.

Content Security Policy (CSP) Copy Link

The basic information on Content Security Policy can be found on the MDN Web Documentation website and will cover the necessary information on the subject. Studio works with CSP, but some basic configuration is necessary to have your application load correctly. The minimum set of CSP rules for Studio is described below.

style-src Copy Link

Themes work by injecting CSS styles into the DOM when Studio initialises. By default this requires a style-src 'unsafe-inline' directive in your CSP.

However, you can avoid this requirement using the styleNonce Studio property as shown below. The styleNonce property should be set to a random value that changes with each page load.

<ag-studio
    :styleNonce="styleNonce"
    /* other studio properties ... */>
</ag-studio>

this.styleNonce = "416d1177";

This sets the nonce attribute on the style tag, so Studio will now work with the CSP directive style-src 'nonce-416d1177' without the need for 'unsafe-inline'.

CSP nonces are global to a page, so when a page has multiple Studio instances, all instances must have the same styleNonce set.

img-src Copy Link

The img-src data: directive is required because Studio uses data urls to embed SVG images in CSS files.

The Image widget's image URL, whether typed as a static URL or supplied from bound data, is requested by the browser of every viewer of the dashboard. Anyone who can set that URL can therefore cause each viewer's browser to contact the host it names. To restrict where images may be loaded from, add an img-src directive that lists only the image hosts your application allows, for example img-src 'self' data: https://images.example.com. An image whose URL is not allowed by the directive is blocked by the browser and not shown.

font-src Copy Link

If you use the loadThemeGoogleFonts Studio property, fonts will be loaded from the Google font CDN, which requires the font-src fonts.gstatic.com directive.

Example Locked-Down CSP Copy Link

This example CSP below allows Studio to be run in a secure manner:

<meta http-equiv="Content-Security-Policy"
      content="default-src 'self'; style-src 'self' 'nonce-123xyz'; img-src 'self' data:">

It assumes:

  1. The application loads assets from the same server ('self')
  2. You are not using loadThemeGoogleFonts
  3. The random string passed to styleNonce on this page load is "123xyz"
  4. Image widgets only show images served from the same server; add any other allowed image hosts to img-src

Trusted Content Copy Link

Some Studio inputs are rendered into the page, so they are either restricted or must come from a trusted source:

  • Link URLs on Text and Image Widgets must be relative URLs or absolute URLs using http:, https: or mailto:. Any other URL is rejected and is not rendered as a link. To apply your own rule instead, set a validateLinkUrl function in the options of the text and image Widget Overrides. It is called in place of the built-in check, so it must reject any URL that a browser would run as script, such as javascript:.
  • String icons are parsed as HTML. This applies to the icon on a Custom Widget, a Widget Override and an AI Prompt Starter. Supply string icons only from trusted sources, or use a CSS class name or an SVG URL instead.
  • Cell renderers returned from createCellRenderer that are plain functions returning a string are rendered by AG Grid as HTML. Escape any untrusted values in the string, or return a DOM element instead. Values from Linked Fields reach a cell renderer raw, like any cell value, so escape them in the same way.

Security Vulnerability Testing Copy Link

Applications may be required to pass an Application Security Test prior to being put into production. If your application is using AG Studio, you will want to make sure that AG Studio has also been tested for security vulnerabilities.

AG Studio is tested for a wide variety of security vulnerabilities using the SonarQube automatic security testing tool. SonarQube performs testing using a number of security rules, covering well-established security vulnerability standards such as CWE, SANS Top 25 and OWASP Top 10. For more details please refer to the section on Security-related Rules.

Security Contact Copy Link

At AG Grid, we take security seriously. If you believe you've discovered a vulnerability, security issue, or have any concerns related to the security of our libraries or websites, we encourage you to contact us directly.

Please email us at security@ag-grid.com with details of the issue. We appreciate responsible disclosure and will work quickly to investigate and resolve any confirmed concerns.