MozillaWiki

DevTools/WiFi Debugging: Difference between revisions

Page Discussion

DevTools/WiFi Debugging (view source)

Revision as of 15:27, 25 March 2015

857 bytes removed ,  25 March 2015
Update after enabling by default
(→‎Toggle Feature Flags: In Nightly, the pref "devtools.webide.enabled" has been defaulting to "true" for a while now.)
(Update after enabling by default)
Line 1: Line 1:
== Security Warning ==
This page describes how to use the '''current version''' of WiFi debugging in the tree (after landing [https://bugzil.la/1000428 bug 1000428]).  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 [https://wiki.mozilla.org/DevTools/WiFi_Debugging/Design 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 ==


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


* Firefox Nightly:
== Enabling ==
** Set the pref <code>devtools.remote.wifi.scan</code> to <code>true</code>
* Firefox OS:
** Set the pref <code>devtools.remote.wifi.visible</code> to <code>true</code>
** Enable Settings -> Developer -> DevTools via Wi-Fi


Also, it's best to make sure you're using the latest Firefox Nightly and latest build of Firefox OS from master.
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:
 
# Go to Developer Settings on Device (Settings -> Developer)
# Enable DevTools via Wi-Fi
# Edit the device name if desired


== Connect ==
== Connect ==


# Enable WiFi debugging on Firefox OS (Settings -> Developer -> DevTools via Wi-Fi)
# Open WebIDE in Firefox Nightly (Tools -> Web Developer -> WebIDE)
# Open WebIDE in Firefox Nightly (Tools -> Web Developer -> WebIDE)
# Click "Select Runtime" to open the runtimes panel
# Click "Select Runtime" to open the runtimes panel
# Your Firefox OS device should show up in the "WiFi Devices" section
# Your Firefox OS device should show up in the "WiFi Devices" section
# A connection prompt may appear on device, choose "Accept"
# A connection prompt will appear on device, choose "Scan" or "Scan and Remember"
 
# Scan the QR code displayed in WebIDE
This process will change as we move forward to include device authentication steps when first connecting to a new device.
Jryans
Confirmed users
177

edits

Retrieved from "https://wiki.mozilla.org/Special:MobileDiff/1064357"