QuantumShield Browser setup →
Security & trust

How QuantumShield keeps your org's data yours.

QuantumShield has two execution paths. Preferred path: the local qshield CLI reusing the Salesforce CLI session already on your machine. Optional path: a static browser app using an External Client App or Connected App you own. In neither path does QuantumShield proxy your org data.

Recommended path

Local qshield CLI

Reuses the sf session you already authorised on macOS, Windows, or Linux. No Connected App, no callback URL, and no CORS allowlist required.

Browser mode

Static site, customer-owned OAuth

Cloudflare Pages serves static HTML and JS only. The browser talks directly to your Salesforce instance, and the client ID comes from an External Client App or Connected App you created in your own org.

Write access

None, ever

QuantumShield never modifies org configuration. Browser mode requests only api and id; CLI mode reuses the permissions already granted to your local sf session.

Browser OAuth scopes requested

api Access the REST, Tooling, and Metadata APIs to read configuration and metadata. Required
id Identify the user and org for display purposes. No profile or directory data queried. Required

No refresh_token scope: the browser session lives in sessionStorage and ends when the tab closes. Sign-in uses OAuth 2.0 authorization code with PKCE.

Content Security Policy

The deployed site serves the following CSP as an HTTP response header on every page, via the Cloudflare Pages _headers file in this repository (public/_headers). connect-src limits outbound requests to this origin plus Salesforce-owned domains (*.salesforce.com, *.force.com, *.my.site.com) — the scanner talks to your org directly and nowhere else. Fonts and images are served from this origin only; the page cannot be framed.

default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self' https://*.salesforce.com https://*.force.com https://*.my.site.com; worker-src 'self' blob:; frame-ancestors 'none'; base-uri 'self'; form-action 'self'

Also served: X-Content-Type-Options: nosniff · Referrer-Policy: strict-origin-when-cross-origin · Permissions-Policy: camera=(), microphone=(), geolocation=(). Local dev servers (astro dev/preview) do not apply these headers.