DocsOverviewQuick startSign inOn-premisesAPIChangelog

Integrations

The Integrations Engine puts protected uploads and the protected viewer inside your own site or application. Your users drop files on your page; SuperSecure seals them, your server decides who may open them, and the viewer renders them under DRM on your domain. It is in beta at integrations.supersecure.com.

#Concepts

  • Company — your organisation on SuperSecure, with a console at /<your slug>.
  • Project — one integration for one domain, with a sandbox environment that needs no DNS and a live environment on your verified domain.
  • Keys — a publishable key (pk_…) for the browser and secret keys (sk_live_…, sk_test_…) for your server. Secret keys are shown once and stored hashed.
  • Sessions — your server mints a short-lived viewer session for a user; the browser never holds a secret.
  • Assets, viewers, origins — every uploaded file, every person allowed to open it, and the origins allowed to embed the viewer.
  • Events and webhooks — uploads, opens, unshares and refusals, delivered to your endpoint and shown in the console's Activity view.

#The project console

Overview (health, a four-step checklist, live numbers, a demo thumbnail), Build (the node canvas, the sandbox playground, the demo site), Connect (code samples, keys and webhooks), Monitor (activity, files, usage and billing) and Settings. The canvas draws your integration as tiles and wires so a stakeholder can read it without reading code.

#Getting started

  1. Sign in at integrations.supersecure.com and create a project for your domain. Step 1 is the sandbox — no DNS needed.
  2. Add the publishable key and the upload component to your page; add a secret key to your server and mint viewer sessions from it.
  3. Try it in the playground, then verify your domain and switch the project to live.
  4. Point a webhook at your endpoint to mirror events into your own systems.

#Metering

Every keyed API call is an event. On Free accounts events meter at $0.02 each; paid tiers include them. Usage and the billing ledger are in Monitor → Usage & billing.

Updated September 2026