Marketplace/FirefoxAccounts

This page discusses how we'll integrate Firefox Accounts with the Marketplace, which currently uses Persona.

Marketplace

For the web

Because Marketplace will have to work on Firefox OS 1.0 - 1.4, Android and Desktop, the primary Firefox Accounts flow will be the web based flow.

Documentation: https://github.com/mozilla/fxa-oauth-server/blob/master/docs/api.md

Sample application: https://123done.dev.lcip.org/

• Login
  • Set up a Marketplace account on the Firefox Account server
  • Add Log in button, that calls /v1/authorization.
  • Add Sign in button, that calls the above URL slightly differently. Dependent bugs: https://github.com/mozilla/fxa-content-server/issues/980, https://github.com/mozilla/fxa-content-server/issues/1062, https://github.com/mozilla/fxa-oauth-server/issues/50
  • Add an insertial page to complete the log in? Or just bounce back to the original page. Upon receiving the response it:
    • Calls POST /v1/token
    • Sends resulting call to the profile server (undocumented but on github)
    • Matches the email up with users account in zamboni, or creates an account and signs the user in, by creating a session.
    • Redirects the user back to the original page.
• Logout
  • Nuke the marketplace session, update any UI elements or reload.

For Firefox OS 2.0

On Firefox 2.0, we'll use the native Firefox Accounts.

• TODO: figure out the flow, but it sounds like its very much a navigator.id kind of flow.

Payments

Note: Firefox Accounts does not allow unverified accounts.

• Login
  • As above for Firefox for the web.
• Reset PIN
  • Log the user out
  • Restart the payment flow

Migration

Persona users allowed users to login with unverified emails, Firefox Accounts does not. If a user has an unverified email they will have to log in to Firefox Accounts with a new email. In this case the record of paid apps on the server will be inaccurate, they haven't paid for an app. This will never really affect a user until they try to purchase a previously installed app.

Note: this currently affects users anyway, but Firefox OS accounts by forcing new accounts is more likely to trigger it.

• Add in a move purchase page to the admin lookup pages
  • Takes two user accounts, listing all purchases
  • Moves all app purchases from account A to account B