1248594 - Move GeoIP detection from geo.mozilla.org to MLS

Status: RESOLVED FIXED

(support.mozilla.org :: General, defect)

Description

[Hanno Schlichting]

Currently SUMO/kitsune uses geo.mozilla.org to do GeoIP based country detection. The geo.mozilla.org service is scheduled to be shutdown. We currently are tracking down all users and asking them to switch over to the Mozilla Location Service (MLS) instead. We'd appreciate it if this switch could happen in the next weeks.

The MLS API is documented at https://mozilla.github.io/ichnaea/api/region.html, though the simplest way is to do a GET request, like:

curl https://location.services.mozilla.com/v1/country?key=fa6d7fc9-e091-4be1-b6c1-5ada5815ae9d

and get a status code 200 JSON response, with a body of:

{
    "country_code": "US",
    "country_name": "United States",
    "fallback": "ipf"
}

In failure cases 4xx and 5xx status codes can be returned, not all of them necessarily containing JSON in the body.

The API key here is only used to identify the consuming service/website, so we can collect metrics about their individual usage and attribute back problems to the right caller. The key in the curl example is meant to be used by SUMO. It can be put into a public repo and be shared across dev/stage/prod sites.

For another code example of the snippets service switching over see:

https://github.com/mozilla/snippets-service/pull/143/files#diff-3adb3669370af06c37adc916ba7b7c3cL398

Comment 1

[Michael Cooper [:mythmon]]

Deployed to prod.