DevTools/WiFi Debugging: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Security Warning ==
This page describes how to use the '''current version''' of WiFi debugging in the tree.  There is still much work to be done to make it secure.  If you want more info what the completed version would be like, check out the design details.
The current version of WiFi debugging is '''not authenticated or encrypted'''.  This means that, if you enable it as described below:
* Anyone on the same WiFi network can connect to your device with the DevTools
* 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.
== Overview ==
== Overview ==


Line 16: Line 5:
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.
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.


== Toggle Feature Flags ==
== Security ==
 
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.
 
== Enabling ==


Since this feature is still under heavy development, there are few things you must do make it available:
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:


* Firefox Nightly:
# Go to Developer Settings on device (Settings -> Developer)
** Set the pref <code>devtools.remote.wifi.scan</code> to <code>true</code>
# Enable DevTools via Wi-Fi
* Firefox OS:
# Edit the device name if desired
** Set the pref <code>devtools.remote.wifi.visible</code> to <code>true</code>
*** This exposes a UI option to control WiFi debugging from Settings -> Developer


== Connect ==
== Connect ==


# Open
# Open WebIDE in Firefox Nightly (Tools -> Web Developer -> WebIDE)
# Click "Select Runtime" to open the runtimes panel
# Your Firefox OS device should show up in the "WiFi Devices" section
# A connection prompt will appear on device, choose "Scan" or "Scan and Remember"
# Scan the QR code displayed in WebIDE

Latest revision as of 17:48, 25 March 2015

Overview

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

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.

Security

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.

Enabling

As of 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:

  1. Go to Developer Settings on device (Settings -> Developer)
  2. Enable DevTools via Wi-Fi
  3. Edit the device name if desired

Connect

  1. Open WebIDE in Firefox Nightly (Tools -> Web Developer -> WebIDE)
  2. Click "Select Runtime" to open the runtimes panel
  3. Your Firefox OS device should show up in the "WiFi Devices" section
  4. A connection prompt will appear on device, choose "Scan" or "Scan and Remember"
  5. Scan the QR code displayed in WebIDE