CloudServices/Sync: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(formatting fixes; Firefox Home has been retired)
 
(42 intermediate revisions by 14 users not shown)
Line 1: Line 1:
__NOTOC__
=Summary=
Welcome to the developer home of Firefox Sync. For end-user (non-technical) information, please see [https://www.mozilla.org/firefox/sync/ the official Sync web site].


https://services.mozilla.com/images/sync-logo.png
Firefox Sync is a set of software components and specifications that synchronize data between multiple Mozilla product instances. The software is open source and the specifications are all public. This means that others are free to implement components or run the software on their own.


==Summary==
==User Support==


Welcome to the developer home of Firefox Sync. For end-user (non-technical) information, please see [https://www.mozilla.com/en-US/mobile/sync/ the official Sync web site].
We have some pages we use to help our "advanced" users get us diagnostic information


Firefox Sync is a set of software components and specifications that synchronize data between multiple Mozilla product instances. The software is open source and the specifications are all public. This means that others are free to implement components or run the software on their own.
* [[CloudServices/Sync/File_a_desktop_bug|For desktop users.]]
* [[CloudServices/Sync/File_an_iOS_bug|For iOS users.]]
* [[CloudServices/Sync/File_an_Android_bug|For Android users.]]
 
 
We also have some [[CloudServices/Sync/Canned_bug_responses|canned responses]] for bugzilla bugs.


===Products and Services===
==Products and Services==
The Sync family consists of the following products and services:
The Sync family consists of the following products and services:


; [[Services/Sync/FxSync|Firefox Sync]] : Client integrated in the Firefox and Fennec browsers
; Client integrated in the Firefox and Firefox Mobile browsers
; [[Services/Sync/Server|Server]] : Server component used for cross-client communication
; [[Services/Sync/Server|Server]] : Server component used for cross-client communication
; Firefox Home : An iOS application (iPhone, iPad) that allows you to view Sync data from these devices
; <s>[https://blog.mozilla.org/services/2012/08/31/retiring-firefox-home/ Firefox Home] : An iOS application (iPhone, iPad) that allows you to view Sync data from these devices</s>
; Server Instance : A Sync Server operated by Mozilla available for use by anybody in the world, free of charge. This is what Firefox sends data to by default.
; Server Instance : A Sync server operated by Mozilla available for use by anybody in the world, free of charge. This is where Firefox sends data by default, unless you specify a different server.


===Specifications===
==Specifications==
The [[/Specs|Specifications]] of Sync cover:
The [[Services/Sync/Specs|Specifications]] of Sync cover:


; HTTP API : Implemented by the Sync Server. Used by clients to exchange data
; HTTP API : Implemented by the Sync Server. Used by clients to exchange data
Line 25: Line 31:
; Client APIs : These include the JavaScript API available in Firefox
; Client APIs : These include the JavaScript API available in Firefox


===Team===
=Get Involved=
Firefox Sync development is led by the [[Services]] team at Mozilla. Details from weekly [[/Meetings|team meetings]] concerning development and progress are available.
==Matrix==
Shout out in the [https://matrix.to/#/#sync:mozilla.org #sync:mozilla.org] room on [[Matrix|Mozilla's Matrix]] server.
 
Most team members are geographically located in North America and Australia. If you don't hear a response, try asking again in a few hours.
 
==Mailing List==
See [[Services/services-dev|services-dev]] for email contact info.
 
==Report Bugs==
Sync bugs should be reported in the [https://bugzilla.mozilla.org/describecomponents.cgi?product=Cloud%20Services Cloud Services Component] of Bugzilla.
 
==Source Code and Development==
Source code for all products and services is available and open source. Public contributions and feedback for product direction is encouraged and very welcome.
 
General development information is available at [[Services/Sync/Getting_Started|Getting Started]]. Production-specific information can be found at the linked product page from the list of products above. There is also a trove of documentation at [https://mozilla-services.readthedocs.io/ Mozilla Services Documentation].
 
=Team Docs=
==FAQ==
* [https://wiki.mozilla.org/CloudServices/Sync/FAQ Low level sync FAQ]
 
* [https://vreplay.mozilla.com/replay/showRecordingExternal.html?key=t0hTbNyvO5uhObi Sync internals video] | [https://docs.google.com/presentation/d/1zDjuboT81BgKmixFqQkxyKIEy2DWUt6YTe_Gpara1Bg/edit#slide=id.p slides]
 
==Telemetry==
* [[CloudServices/Sync/ReDash#Table_Described|Definitions of data available in Re:Dash under main Sync ping]]
* [[Firefox Sync extended logging]] for fetching successful sync event logfiles
 
==Working Docs==
* [https://wiki.mozilla.org/CloudServices/Sync/OKRs_2016Q3 Themes and Initiative OKRs]
 
* [https://trello.com/b/h8sS9Mxn/firefox-sync-product Feature Tracker/Trello Board]
 
* [https://wiki.mozilla.org/CloudServices/Sync/Sprint_1 Current Work - Sprint 1]
 
==Bug Queries==
* [https://wiki.mozilla.org/Bugmasters/Process/Triage Bug process for sprints]
* [https://bugzilla.mozilla.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=Sync%20Backlog&sharer_id=458547&list_id=13152406 Backlog (all priorities)]
* [https://bugzilla.mozilla.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=Sync%20Triage&sharer_id=458547&list_id=13152407 Triage (unprioritized)]
* [https://bugzilla.mozilla.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=Sync%20Team%20P1&sharer_id=465825&list_id=13152451 P1s Desktop]
* [https://wiki.mozilla.org/CloudServices/Sync/Status View Bugs by Feature]
 
==iOS Triage==
* [https://docs.google.com/document/d/10Ytw1kZjBHhlTkQGTW8usJ5CJLhko74dgFND9egjkI0/edit iOS issues doc]
 
* [https://docs.google.com/document/d/189f1pCcc8nKZGl-y1KhD0JoXgct8BdjQEiYvyTunejs/edit Bi-Directional bookmarks reference doc]
 
==Cross Team Projects==
===Device Manager===
* Problem
** Currently sync uses the 'clients' sync data collection as a list of active devices.  This list has no state and difficult to 'delete' an device off list.  Most client display a device if it's been active within the last two weeks.  This design creates a number of bugs visible to the user.
* Plan
** All devices, Desktop, Android, iOS register with FxA
** There should be events that removed devices from this list, such as uninstall, reinstall, or devices with the same name conflicts.
** FxA device manager endpoint provides real-time list of active devices to sync clients to display.
* [https://accounts.firefox.com/signin?forceDeviceList=1 FxA device manager *WIP*]
* [https://waffle.io/mozilla/fxa-features/cards/577dddd795b2701e003d7e1c Github Issue in Waffle board]
* [https://docs.google.com/document/d/1VrysJ4LFPZ20IeMMmRts5l_2GUHhm890rlQhD012U_g/edit# Feature Document]
 
* Current Status
** Pending device registration on iOS and fixing issues - [https://bugzilla.mozilla.org/show_bug.cgi?id=1250783 bug 1250783 - active WIP]
** Pending fixes to settings display
** Pending work to improve the accuracy of the device list controlled by user events.
** Pending management UI of devices.


==Getting Involved==
===Send Tab===
* [https://docs.google.com/document/d/17OkChAAlavNnYKzX-z-ihKdg3CWk26R0mgxhNhDz7o8/edit PRD]
* Design
** [https://github.com/mozilla/fxa-auth-server/issues/1316 Architecture and discussion]
** [https://github.com/mozilla/fxa-auth-server/issues/1357 Implementation]
* [https://wiki.mozilla.org/CloudServices/Sync/Status Send Tab Tasks]


For questions or to contact people involved with Sync, try the '''#sync''' channel in Mozilla's [[IRC]] server. Or, if you prefer email, see [[Services/services-dev|services-dev]] for contact info.
Plan
* Aug 9 - push send tab between desktop
* Next - send tab to fennec with push
** Android must have device registration
* Next2 - sent tab to iOS with push
** iOS must have device registration


Most of the Sync team members are geographically located in North America.
===Atomic IO===
* [https://wiki.mozilla.org/CloudServices/Sync/Atomic_IO Atomic IO]


==Other Info==
=Other Info=


If you are coming from Xmarks, see our [[/Xmarks|Xmarks quick reference]].
If you are coming from Xmarks, see our [[Services/Sync/Xmarks|Xmarks quick reference]].

Latest revision as of 20:37, 2 August 2023

Summary

Welcome to the developer home of Firefox Sync. For end-user (non-technical) information, please see the official Sync web site.

Firefox Sync is a set of software components and specifications that synchronize data between multiple Mozilla product instances. The software is open source and the specifications are all public. This means that others are free to implement components or run the software on their own.

User Support

We have some pages we use to help our "advanced" users get us diagnostic information


We also have some canned responses for bugzilla bugs.

Products and Services

The Sync family consists of the following products and services:

Client integrated in the Firefox and Firefox Mobile browsers
Server
Server component used for cross-client communication
Firefox Home : An iOS application (iPhone, iPad) that allows you to view Sync data from these devices
Server Instance
A Sync server operated by Mozilla available for use by anybody in the world, free of charge. This is where Firefox sends data by default, unless you specify a different server.

Specifications

The Specifications of Sync cover:

HTTP API
Implemented by the Sync Server. Used by clients to exchange data
Cryptography Model
How encryption is used to securely store data in the Sync Server (the Sync Server can't even read important data)
Data Storage Formats
How existing clients (like Firefox) format synchronized data
Client APIs
These include the JavaScript API available in Firefox

Get Involved

Matrix

Shout out in the #sync:mozilla.org room on Mozilla's Matrix server.

Most team members are geographically located in North America and Australia. If you don't hear a response, try asking again in a few hours.

Mailing List

See services-dev for email contact info.

Report Bugs

Sync bugs should be reported in the Cloud Services Component of Bugzilla.

Source Code and Development

Source code for all products and services is available and open source. Public contributions and feedback for product direction is encouraged and very welcome.

General development information is available at Getting Started. Production-specific information can be found at the linked product page from the list of products above. There is also a trove of documentation at Mozilla Services Documentation.

Team Docs

FAQ

Telemetry

Working Docs

Bug Queries

iOS Triage

Cross Team Projects

Device Manager

  • Problem
    • Currently sync uses the 'clients' sync data collection as a list of active devices. This list has no state and difficult to 'delete' an device off list. Most client display a device if it's been active within the last two weeks. This design creates a number of bugs visible to the user.
  • Plan
    • All devices, Desktop, Android, iOS register with FxA
    • There should be events that removed devices from this list, such as uninstall, reinstall, or devices with the same name conflicts.
    • FxA device manager endpoint provides real-time list of active devices to sync clients to display.
  • FxA device manager *WIP*
  • Github Issue in Waffle board
  • Feature Document
  • Current Status
    • Pending device registration on iOS and fixing issues - bug 1250783 - active WIP
    • Pending fixes to settings display
    • Pending work to improve the accuracy of the device list controlled by user events.
    • Pending management UI of devices.

Send Tab

Plan

  • Aug 9 - push send tab between desktop
  • Next - send tab to fennec with push
    • Android must have device registration
  • Next2 - sent tab to iOS with push
    • iOS must have device registration

Atomic IO

Other Info

If you are coming from Xmarks, see our Xmarks quick reference.

Retrieved from "https://wiki.allizom.org/index.php?title=CloudServices/Sync&oldid=1247431"