Delivery & Security (SRI)

Pushly supports loading a pinned, immutable version of the Web SDK using Subresource Integrity (SRI).

This option is intended for customers with strict security requirements, such as enforced CSP policies. Most customers should continue using the Latest SDK.


When should I use SRI?

Use SRI only if you require:

  • Cryptographic verification of third-party scripts

  • Enforcement of require-sri-for script in Content Security Policy

  • Explicit control over when SDK updates occur

If you do not have these requirements, use the Latest SDK instead.


Pinned SDK snippet example (SRI)

<script
  src="https://cdn.p-n.io/sdk/web/[email protected]"
  integrity="sha384-REPLACE_WITH_HASH"
  crossorigin="anonymous"
  async
  data-domain-key="DOMAIN_KEY">
</script>

This loads a specific SDK version that will never change.


Get the integrity hash

The integrity hash for each SDK release is published in a release manifest.

For version 3.1.0:

Look for the files[].integrity field and copy its value into the integrity attribute.


Upgrading a pinned SDK

Pinned SDKs do not auto-update.

To upgrade:

  1. Update the SDK version in the script src

  2. Update the corresponding integrity hash

  3. Deploy the updated snippet

If you do not update the snippet, your site will continue running the older SDK indefinitely.

Last updated