QuantumShield Browser setup →
Setup guide

Run QuantumShield locally or in the browser

Recommended path: the local qshield CLI. It reuses the Salesforce CLI session you already have on macOS, Windows, or Linux. Browser mode remains available if you want an in-tab workflow and are willing to create an External Client App or Connected App you own.

Recommended · local qshield CLI

Fastest path for real orgs. No Connected App, no callback URL, no CORS allowlist, and no QuantumShield auth infrastructure in the path.

  1. 1
    Clone the repo and install dependencies with npm install.
  2. 2
    Authenticate once with the Salesforce CLI: sf org login web --alias prod-eu.
  3. 3
    Run the scan: npm run qshield -- scan --target-org prod-eu --probe-tls --region NL,EU.
  4. 4
    Outputs land in ./qshield-out/ as PDF, CBOM JSON, OpenVEX JSON, findings CSV, and raw report JSON.

Browser mode · Create the External Client App you own

Browser mode never depends on a shared QuantumShield Connected App. You create the OAuth app inside your org, keep ownership of the client ID, and can revoke access at any time from Setup → App Manager.

  1. 1
    Open Setup → App Manager and click New External Client App. On orgs without External Client Apps yet, use New Connected App.
  2. 2
    Name: QuantumShield Scanner. Contact email: your own.
  3. 3
    Under API (Enable OAuth Settings): enable OAuth; leave Device Flow and Client Credentials off.
  4. 4
    Scopes: api and id only. refresh_token is not needed — the browser session intentionally ends when the tab closes. Do not select full or web.
  5. 5
    Save. OAuth configuration changes can take a few minutes to propagate — if the first sign-in attempt fails, wait briefly and retry.

Browser mode · Add the callback URL

In the External Client App you just created, add this URL to the Callback URL list:

https://quantumshield.opensf.foundation/callback

You can add multiple callback URLs. As with other OAuth settings, saved changes can take a few minutes to propagate.

Browser mode · Add QuantumShield to CORS

!

One-time admin task

This applies to browser mode only. The local CLI does not need a CORS allowlist.

  1. 1
    Open Setup → Quick Find → "CORS". Select CORS Allowlist.
  2. 2
    Click New and paste this origin:
    https://quantumshield.opensf.foundation
  3. 3
    Save. Subsequent users of the scanner in this org do not need to repeat this step.

Browser mode · Paste your Consumer Key

In your new External Client App, open the Manage Consumer Details panel. Copy the Consumer Key and paste it into /connect. We remember it in your browser's localStorage so you never need to paste it again on this device.

QuantumShield is read-only. We never modify your Salesforce configuration. Source: github.com/OpenSystemsFoundation/quantum-shield.