Firefox Extension

The Firefox extension is feature-equivalent to the Chrome/Edge build — same shield icon, same Gmail signing, same per-site verification. It's packaged as both a .zip (for unpacked dev install) and a .xpi (for the temporary or self-distribution install).

Before you start

The extension talks to the local TrustDID Service over https://localhost:8080. You need:

• TrustDID installed — the signed installer on Windows, or the install script on Linux
• An activated identity — paid tiers run trustdid-setup --managed YOUR_TOKEN YOUR_ID once (token + UUID from your enrolment email), which pulls the license from the API automatically; Free tier just runs trustdid-setup interactively
• The TrustDID Service running (trustdid-service status reports running)

See Software Bundle on Windows or Software Bundle on Linux if you haven't done that yet.

Step 1: Accept the local certificate

Open https://localhost:8080/health in Firefox and accept the self-signed certificate. Firefox stores cert exceptions per-profile, so if you switch Firefox profiles you'll need to do this again.

Step 2: Install the extension

There are two install paths during early access. Pick whichever you prefer.

Option A — Temporary install (development, lasts until restart)

Best while we're iterating: lets you reload after each update without re-signing.

1. Extract TrustDID-Firefox-v1.4.4.zip to a permanent folder.
2. Open about:debugging#/runtime/this-firefox.
3. Click Load Temporary Add-on....
4. Select manifest.json from the extracted folder.
5. The TrustDID shield appears in your toolbar.

The catch: temporary add-ons unload when Firefox restarts. You re-load them the same way next time.

Option B — Self-signed XPI install (persistent)

Use the .xpi build for a permanent install:

1. Open about:addons.
2. Click the gear icon → Install Add-on From File....
3. Pick TrustDID-Firefox-v1.4.4.xpi.
4. Confirm the install when Firefox prompts.

Firefox's default profile only accepts XPIs that are signed by Mozilla. Our early-access XPI is signed for distribution but not yet listed on AMO; if Firefox refuses to install it, switch to Firefox Developer Edition or set xpinstall.signatures.required = false in about:config (only do this on a non-production profile).

Step 3: Configure the extension

Right-click the TrustDID icon → Manage Extension → Options. Same fields as the Chrome version:

• API URL — defaults to https://localhost:8080
• Auto-sign Gmail, Auto-verify, Footer signature — all on by default
• Language — EN/FR

Step 4: Try it

Same as Chrome: visit any signed site, the shield turns green. Open Gmail, compose, send — the message is signed in the background.

Troubleshooting

"This add-on could not be installed because it appears to be corrupt." Almost always the cert exception. Hit https://localhost:8080/health first and accept the cert; the XPI install handshake hits the same origin.

Toolbar icon shows red even on the TrustDID homepage. Reload the page once after starting the service. Firefox sometimes caches a verification result from before the service was up.

"Add-on disabled by your environment." Enterprise Firefox policy blocks unsigned add-ons. Talk to your admin or use Firefox ESR with the xpinstall.signatures.required exception.

Verification works but Gmail signing doesn't. Firefox's Gmail integration is sensitive to Google's UI updates. Check about:debugging → Inspect → Console for any "TrustDID:" messages and email the output to support.

Need help?

about:debugging → This Firefox → click Inspect under TrustDID, then copy the console output to support@trustdid.ca with your Firefox version (about:support).