Learn to Code via Tutorials on Repl.it!

← Back to all posts
Google Authentication with Flask
h
DillonB07

Google Authentication with Flask

Introduction

In this tutorial, I'm going to show you how you can authenticate users with Google on your Flask website. I will not be going over how to create a Flask application, how they work, or Python syntax.

Prerequisites

You should know the following before following this tutorial:

  • Basic Flask knowledge
  • Intermediate Python knowledge (OOP)
  • How to use Replit

It would benefit you if you have used Google's Developer Console before, but you should be fine if you haven't.

Tutorial

Let's get started by creating our Google credentials.

Google Developer Console Setup

First, sign in to Google's Developer Console

If you haven't used the Developer Console before, Google will ask you a few questions. Complete those, then continue with the tutorial.

Configure OAuth2 Consent Screen

Create a project and configure your Google OAuth2 Consent Screen. Make sure that you select External user type unless the project is only for inside your Google organisation.

Fill out the required fields. For the Authorised Domain, put username.repl.co

OAuth2 Credentials

Now, we need to get our credentials. Go back to the Credentials tab, and press Create Credentials. Select Oauth2 Client ID.

Select a Web Application, name your client and add a redirect URI. The URI will be your repl's url with /callback on the end. Example: https://Flask-Google-Auth-Demo.dillonb07.repl.co/callback
Download the credentials you created. We will need the json file inside our repl.

We've now finished with the Google Developer Console. Let's start making our Flask Application.

Creating our Flask App

Create a new Python repl with these imports:

These are the packages needed for the webserver and Google Authentication

Next, do the basic Flask application setup.

Upload the file that you downloaded from Google into Replit. It will be called something like client_secret_29774424209-u35ovepadeq7iuov24vs30ed24ja68fq.apps.googleusercontent.com.json.

Rename it to something more readable like client_secret.json.

Go into the file and get your Client ID and set it inside a variable.

Now, create a variable called client_secrets_file that creates a path to your file.

Now, let's create a flow.

This uses Google's oauthlib library to create a flow that sends the necessary data to Google servers.

Now, we're going to create a custom decorator for our non-existent endpoints.

This code will create a decorator that we can use to make sure that the user is authenticated with Google before accessing the endpoint. If they aren't logged in,

Now, let's work on our endpoints. We're going to have five endpoints.
1. / - Homepage with login with Google button
2. /login - Redirects the user to Google's OAuth2 Screen
3. /callback - Sends and receives data to and from Google
4. /logout - Logout of session and redirect to homepage
5. /logged_in - Page that you must be logged in with Google to access

Let's start with the easiest endpoint. The homepage.

This is just a basic endpoint that displays a login button.

This endpoint sends the user to the Google OAuth2 Consent Screen using the flow that we created earlier.

This endpoint is the most complicated. Here, we fetch Google's response and send the data to a Flask session.

This endpoint clears the user's session data and redirects them to the homepage.

Here, we use the decorator we created to make sure that the user is logged in with Google to access the page.

We now have a fully functioning website!
Run the program and try to log in with Google. You should be able to see the Logged in message after signing in with Google.

Here is the website I made: https://Flask-Google-Auth-Demo.dillonb07.repl.co

I hope that you found this tutorial useful. If you have any suggestions for more tutorials, put them in the comments. If you have any questions about this tutorial, put them in the comments as well!

Voters
CosmicBear
DillonB07