gecko-dev/remote
Andreas Tolfsen 3852bf897f bug 1580470: remote: document security aspects of remote agent; r=remote-protocol-reviewers,maja_zf
This clarifies the security considerations we have made with the
remote agent.

The text is adapted from two sources:

	https://bugzilla.mozilla.org/show_bug.cgi?id=1542229
	https://docs.google.com/document/d/1LytMB7yueNLFehBp72Xzi_n4crncdHSHjQ3FCp0Meuo/edit#heading=h.k75yymb1qbxr

DONTBUILD

Differential Revision: https://phabricator.services.mozilla.com/D45542

--HG--
extra : moz-landing-system : lando
2019-09-12 11:39:13 +00:00
..
doc bug 1580470: remote: document security aspects of remote agent; r=remote-protocol-reviewers,maja_zf 2019-09-12 11:39:13 +00:00
domains Bug 1545724 - Add support for javascriptDialog APIs in Page domain r=remote-protocol-reviewers,whimboo,ochameau 2019-08-01 12:25:57 +00:00
server Bug 1563685 - Rename WebSocketDebuggerTransport class to match its JSM file name. r=remote-protocol-reviewers,jdescottes,ato 2019-07-09 09:36:16 +00:00
sessions Bug 1563690 - Make Target class save a list of Connection rather than Session. r=remote-protocol-reviewers,jdescottes 2019-07-18 16:39:11 +00:00
targets Bug 1568581. Stop mixing XULWindow and Window instances in TabObserver.jsm. r=ochameau 2019-07-24 16:43:26 +00:00
test bug 1540655: remote: connect Puppeteer spec tests with mach test flavour; r=remote-protocol-reviewers,jdescottes 2019-08-16 12:58:23 +00:00
.gitignore bug 1540655: remote: ignore non-vendored Node.js assets; r=remote-protocol-reviewers,jdescottes 2019-08-16 12:58:17 +00:00
Connection.jsm Bug 1563690 - Make Target class save a list of Connection rather than Session. r=remote-protocol-reviewers,jdescottes 2019-07-18 16:39:11 +00:00
Error.jsm Bug 1561435 - Format remote/, a=automatic-formatting 2019-07-05 10:56:48 +02:00
JSONHandler.jsm Bug 1561435 - Format remote/, a=automatic-formatting 2019-07-05 10:56:48 +02:00
Log.jsm Bug 1561435 - Format remote/, a=automatic-formatting 2019-07-05 10:56:48 +02:00
Observer.jsm Bug 1561435 - Format remote/, a=automatic-formatting 2019-07-05 10:56:48 +02:00
Protocol.jsm bug 1568865: remote: add missing license headers; r=remote-protocol-reviewers,jdescottes 2019-07-25 15:41:12 +00:00
README bug 1533831: remote: include remote agent in default build; r=firefox-build-system-reviewers,chmanchester 2019-04-24 17:18:22 +00:00
RecommendedPreferences.jsm Bug 1561435 - Format remote/, a=automatic-formatting 2019-07-05 10:56:48 +02:00
RemoteAgent.conf Bug 1536862 - Register RemoteAgent JS XPCOM by using new registration method. r=ato 2019-06-26 20:25:43 +00:00
RemoteAgent.jsm Bug 1563689 - Release DOM event listeners set on top level windows. r=remote-protocol-reviewers,jdescottes 2019-07-18 09:48:18 +00:00
Sync.jsm Bug 1561435 - Format remote/, a=automatic-formatting 2019-07-05 10:56:48 +02:00
jar.mn Bug 1545724 - Add support for javascriptDialog APIs in Page domain r=remote-protocol-reviewers,whimboo,ochameau 2019-08-01 12:25:57 +00:00
mach_commands.py bug 1540655: remote: add mach command for running Puppeteer tests; r=remote-protocol-reviewers,jdescottes 2019-08-16 12:58:15 +00:00
moz.build Bug 1572622 - Merge remote.js into all.js. r=ato 2019-08-13 23:49:39 +00:00

README

The Firefox remote agent is a low-level debugging interface based
on the CDP protocol.

With it, you can inspect the state and control execution of documents
running in web content, instrument Gecko in interesting ways,
simulate user interaction for automation purposes, and debug
JavaScript execution.

This component provides an experimental and partial implementation
of a remote devtools interface using the CDP protocol and transport
layer.

See https://firefox-source-docs.mozilla.org/remote/ for documentation.

The remote agent is disabled by default, but can be enabled by
setting a preference before running it:

	% ./mach run --setpref "remote.enabled=true" --remote-debugger