An example Flask application demonstrating how to use the WorkOS Python SDK to authenticate users via SSO.

• Python 3.6+

1. Clone the main git repo for these Python example apps using your preferred secure method (HTTPS or SSH).

   # HTTPS
   $ git clone https://github.com/workos/python-flask-example-applications.git

   or

   # SSH
   $ git clone git@github.com:workos/python-flask-example-applications.git

2. Navigate to the sso app within the cloned repo.

   $ cd python-flask-example-applications/python-flask-sso-example

3. Create and source a Python virtual environment. You should then see (env) at the beginning of your command-line prompt.

   $ python3 -m venv env
   $ source env/bin/activate
   (env) $

4. Install the cloned app's dependencies.

   (env) $ pip install -r requirements.txt

5. Obtain and make note of the following values. In the next step, these will be set as environment variables.

   • Your WorkOS API key and Client ID

6. Ensure you're in the root directory for the example app, python-flask-sso-example/.

7. Create a .env file to securely store the environment variables. Open this file with the Nano text editor. (This file is listed in this repo's .gitignore file, so your sensitive information will not be checked into version control.)

   (env) $ touch .env
   (env) $ nano .env

8. Once the Nano text editor opens, you can directly edit the .env file by listing the environment variables:

   WORKOS_API_KEY=<value found in step 5>
   WORKOS_CLIENT_ID=<value found in step 5>
   APP_SECRET_KEY=<any string value you\'d like>

   If you are unsure what to use for the APP_SECRET_KEY, you can generate a random UUID using Python.

    (env) $ python3 -c "import uuid; print(uuid.uuid4())"

   To exit the Nano text editor, type CTRL + x. When prompted to "Save modified buffer", type Y, then press the Enter or Return key.

9. Source the environment variables so they are accessible to the operating system.

   (env) $ source .env

   You can ensure the environment variables were set correctly by running the following commands. The output should match the corresponding values.

   (env) $ echo $WORKOS_API_KEY | grep sk_test_
   (env) $ echo $WORKOS_CLIENT_ID | grep client_

10. In python-flask-sso-example/app.py change the CUSTOMER_ORGANIZATION_ID string value to the organization you will be testing the login for. This can be found in your WorkOS Dashboard by clicking on the "Organizations" link on the left side of the dashboard.

11. The final setup step is to start the server.

(env) $ flask run -h localhost

If you are using macOS Monterey, port 5000 is not available and you'll need to start the app on a different port with this slightly different command.

(env) $ flask run -h localhost -p 5001

You'll know the server is running when you see no errors in the CLI, and output similar to the following is displayed:

* Tip: There are .env or .flaskenv files present. Do "pip install python-dotenv" to use them.
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Navigate to localhost:5000, or localhost:5001 depending on which port you launched the server, in your web browser. You should see a "Login" button. If you click this link, you'll be redirected to an HTTP 404 page saying "Invalid redirect URI" because we haven't set up SSO yet!

You can stop the local Flask server for now by entering CTRL + c on the command line.

Follow the SSO authentication flow instructions to set up an SSO connection.

When you get to the step with the "Add Redirect URI" value, use http://localhost:5000/auth/callback

If you get stuck, please reach out to us at support@workos.com so we can help.

11. Naviagte to the python-flask-sso-example directory. Source the virtual environment we created earlier, if it isn't still activated from the steps above. Start the Flask server locally.

$ cd ~/Desktop/python-flask-sso-example/
$ source env/bin/activate
(env) $ flask run

Once running, navigate to localhost:5000, or localhost:5001 depending on which port you launched the server, to test out the SSO workflow.

Hooray!

If you get stuck and aren't able to resolve the issue by reading our API reference or tutorials, you can reach out to us at support@workos.com and we'll lend a hand.