Skip to content
This repository has been archived by the owner on Apr 3, 2019. It is now read-only.

SMS: Testing a new country

Jump to bottom
Shane Tomlinson edited this page Dec 19, 2017 · 1 revision

The steps

  1. In Firefox desktop, load up a new Firefox profile.
  2. Set the browser's default locale set to the local language.
  3. In the URL bar, open about:preferences#sync
  4. Click "Don't have an account? Get started".
  5. # for a new Firefox Account. For mozilla.com addresses, adding a suffix onto the username is an easy way to generate unique addresses, e.g., stomlinson+20171127@mozilla.com
  6. In the same browser, copy the verification link to the URL bar and before submitting, add the following query parameters: &forceExperiment=sendSms&forceExperimentGroup=signinCodes. Submit.
  7. If things are working up to this point, you should see a screen that says "This Firefox is connected" and a form that allows you to send yourself an SMS, the lone form field should contain your country's country code. If instead you see "# to Firefox on another device to complete set-up" that means we haven't correctly enabled SMS in your country.
  8. Try to enter a few invalid phone numbers - does FxA inform you that the numbers are invalid?
  9. Try to send an SMS to your mobile device. Does it work? Is the SMS received?
  10. If you click on the link, does it open Firefox on your device (if installed), and Firefox is not installed, is the appropriate store opened to the Firefox page?

Steps 8 and 9 are the parts being tested. Step 10 should "just work", we've tested that portion pretty thoroughly.

Testing a country from a different country

It is possible to force a specific country when testing from a 2nd country, e.g., force Spain when testing from the US or Romania. To do this, in step 6, a 3rd query parameter is needed: &country=<country_code>. The list of supported country codes is defined in the auth-server's config under sms.countryCodes.

Problems while testing

A common problem while testing is to click on the verification link from the email and then add the testing query parameters. This does not work because FxA has already decided which screen to display (/connect_another_device) and will never redirect to /sms. This will be fixed once PR #5766 merges

Clone this wiki locally