Other Notes


Troubleshooter Add-on

When asking a question, users are prompted to install an addon that will return extra information to SUMO from about:support. This is opt-in, and considered generally non-sensitive data, but is not revelaed to all sites because of fingerprinting concerns.

This add-on only provides data to white listed domains. The built in whitelist is:

Note that the protocol and port are significant. If you try and run the site on http://localhost:8900/, the add-on will not provide any data.

The source of the addon is on GitHub, and it is hosted on AMO. The add-on is hosted on AMO instead of SUMO so that AMO will do the heavy lifting of providing automatic updates.

about:support API

The about:support API replaces the Troubleshooter Add-on and is available starting in Firefox 35. To test this locally during development, you need to run an ssl server and change some permissions in your browser.

To run the ssl server, first add sslserver to INSTALLED_APPS in settings_local.py:

INSTALLED_APPS = list(INSTALLED_APPS) + ['sslserver']

Run the ssl server:

$ ./manage.py runsslserver

Then you need to run the following in the Browser Console:

Services.perms.add(Services.io.newURI(“https://localhost:8000”, null, null), “remote-troubleshooting”, Services.perms.ALLOW_ACTION);


You need to Enable chrome debugging in developer console settings, so that you can access the browser console.

See also https://developer.mozilla.org/en-US/docs/Tools/Browser_Console