Experiments Authority lets Firefox users trust their own X.509 certificate authorities for Mozilla-format signed XPIs and control WebExtension Experiment privileges. Mozilla-signed extensions continue to use Firefox's normal path.
Requires Firefox (or a compatible fork) and Sine 2.x.
- In Sine, install this repository as an unpublished mod using its GitHub URL.
- Enable
sine.allow-unsafe-jsinabout:config. - Restart Firefox and open Add-ons and themes → Experiments.
- Under Trusted certificate authorities, paste a named PEM certificate or
enter
owner/repo, a GitHub repository URL, or a direct HTTPS certificate URL. Select Resolve CA, review the certificate and SHA-256 fingerprint, then select Save to trust it.
Sine loads src/authority.sys.mjs as a background module and
src/addons-manager.uc.js in about:addons, as declared in theme.json.
The code itself does not depend on Sine and can also be loaded through a
compatible userChrome.js loader.
- CA manager: add, rename, edit, or remove user-trusted signing CAs.
Repository imports read the
signing.ca_certificatepath from the rootmanifest.json, falling back to scanningcertificates/for a single PEM when no path is declared. Importing never auto-trusts subsequent repo changes. - Experiment privileges: trusted add-ons declaring
experiment_apisreceive privileged access by default, with per-add-on enable/disable toggles. - Experiment API mapping: map an API name to a provider add-on ID instead
of Firefox's hardcoded
<api>@experiments.addons.mozilla.orgsuffix.
All settings live in a system-principal IndexedDB database named
experiments-authority, with certificates, privileges, and providers
object stores. CA changes trigger signature re-verification. Privilege changes
reload affected providers and consumers without rehashing their XPIs.
The verifier follows Mozilla Autograph's XPI signature structure:
META-INF/manifest.mf, mozilla.sf, and detached PKCS#7/CMS mozilla.rsa.
It validates the archive digests, CMS signature, X.509 chain to a user-trusted
CA, and the signing certificate's add-on ID and code-signing constraints.
The trusted root is not imported into Firefox's NSS trust store.
Only packed XPI roots can receive custom trust. Firefox's original signature
verification is unchanged, and the synthetic signing state is not persisted
in extensions.json. Removing EA and restarting removes its modifications.
For diagnostics, open the Browser Console (Ctrl+Shift+J) and filter
[Experiments Authority].
The source imports vendor/pkijs.sys.mjs, a checked-in PKI.js bundle. Firefox
users do not need Node or npm. Rebuild that vendor module only when its
dependencies change:
npm ci
npm run build
npm run checkMozilla format reference: Autograph XPI signer.
Experiments Authority is licensed under MPL-2.0 (see LICENSE).
Bundled third-party code retains its own licenses under third_party_licenses/.