Skip to content
Flask example app using the OpenStreetMap teams from!
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Flask example app for using and the related loginpass library. Mapping Teams implements the OAuth 2 and OpenID Connect standards.

The OAuth 1 transaction with to verify the user is handled entirely over on the Mapping Teams server. After a successful login all the way through, a user_info object is passed through to your app, and the OAuth 2 token is added.

This example will use the app credentials you provide. For the users of this demo app, authentication will be verified by Mapping Teams. Then, the access key will be available which can be used as a bearer authentication header to e.g. create a new team at

Create your app on

To run this project you'll need a CLIENT_ID and CLIENT_SECRET from There you'll log in using your OpenStreetMap account, then visit the create client page and follow these instructions:

  1. Add a name for your app
  2. The callback will be http://localhost:5555/mappingteam/auth or whatever URL this example is running on
  3. Click on "Add new App" to receive your credentials
  4. The MAPPINGTEAM_CLIENT_ID is the client_id returned by the site
  5. The MAPPINGTEAM_CLIENT_SECRET is the client_secretreturned by the site
  6. Repeat for your live server, and remember to match the HTTP/HTTPS carefully.

Main instructions

  1. clone this repository git clone; cd osm-teams-python-example
  2. python3 -m venv flask_venv to create a new python venv environment.
  3. . flask_venv/bin/activate to enter the environment
  4. pip install -r requirements.txt to install the needed packages.
  5. Create a new localhost testing app at and keep the secret and ID information somewhere safe that you get when you create it. For the Callback Address, you should put in something like http://localhost:5555/mappingteam/auth – that is the callback Flask endpoint configured by loginpass.
  6. FLASK_APP=flask_example FLASK_ENV=development MAPPINGTEAM_CLIENT_ID= MAPPINGTEAM_CLIENT_SECRET= flask run -p 5555, to start your app. Be sure to add the actual values for the Client ID and Secret you got from . You will not need the Client Name.
  7. heroku create
  8. Create a new internet testing app at and keep the secret and ID information somewhere safe that you get when you create it. You should use as the callback address, updating the domain as needed to match the app you just created.
  9. heroku config:set MAPPINGTEAM_CLIENT_ID= MAPPINGTEAM_CLIENT_SECRET=, entering in the Client ID and Secret you just got for your internet testing app.
  10. git push heroku master
  11. Try out your app using your Heroku address. It should look something like the on at

An unfinished Django example is available on the Django_example branch, ready to follow the instructions with the loginpass library to use it. . The Loginpass example app may also be helpful:

See also:

You can’t perform that action at this time.