DevTools/WiFi Debugging: Difference between revisions

 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Security Warning ==
== Overview ==


The current version of WiFi debugging is '''not authenticated or encrypted'''. This means that, if you enable it as described below:
WiFi debugging allows WebIDE to connect to your Firefox OS device via your local WiFi network instead of a USB cable.


* Anyone on the same WiFi network can connect to your device with the DevTools
The connection experience is generally more straightforward (especially after connecting to a device the first time) than with USB and also more convenient to use since you're no longer tied down by a cable.
* Anyone on the same WiFi network can read your debugging traffic (which can include full requests, responses, etc.)


Because of this, it would be wise to avoid enabling this feature at this time on a device with data that is sensitive or personal in any way.  These issues will be resolved before this feature is available by default.
== Security ==


== Overview ==
WiFi debugging uses TLS for encryption and authentication over the WiFi network.  Each device creates a self-signed certificate for authentication.  When connecting, a QR code is scanned to verify the certificates were presented by the correct devices.  After the first connection, these certs can be remembered to allow for immediate connection if desired.


WiFi debugging allows WebIDE to connect to your Firefox OS device via your local WiFi network instead of a USB cable.
== Enabling ==


The connection experience is generally more straightforward (especially after connecting to a device the first time) than with USB and also more convenient to use since you're no longer tied down by a cable.
As of [https://bugzil.la/1027454 bug 1027454], this feature is no longer hidden.  Assuming you have Firefox 39 for desktop and Firefox 3.0 on device, you can enable this feature on the device:


== Toggle Feature Flags ==
# Go to Developer Settings on device (Settings -> Developer)
# Enable DevTools via Wi-Fi
# Edit the device name if desired


Since this feature is still under heavy development, there are few things you must do make it available:
== Connect ==


* In Firefox Nightly:
# Open WebIDE in Firefox Nightly (Tools -> Web Developer -> WebIDE)
** Set the pref <code>devtools.remote.wifi.scan</code> to <code>true</code>
# Click "Select Runtime" to open the runtimes panel
* On Firefox OS:
# Your Firefox OS device should show up in the "WiFi Devices" section
** Set the pref <code>devtools.remote.wifi.visible</code> to <code>true</code>
# A connection prompt will appear on device, choose "Scan" or "Scan and Remember"
*** This exposes a UI option to control WiFi debugging from Settings -> Developer
# Scan the QR code displayed in WebIDE
Confirmed users
177

edits