Commerce Modules

Google Auth Module Provider

In this document, you’ll learn about the Google Auth Module Provider and how to install and use it in the Auth Module.

The Google Auth Module Provider handles authenticating users with their Google account.

Tip: Learn about the authentication flow in this guide .

Install the Google Auth Module Provider#

Create a project in Google Cloud.↗Create authorization credentials. When setting the Redirect Uri, set it to a URL in your frontend that later uses Medusa's callback route to validate the authentication.↗

To install the Google auth module provider, run the following command in the directory of your Medusa application:

Next, add the module to the array of providers passed to the Auth Module:

medusa-config.js
1const { Modules } = require("@medusajs/utils")2
3// ...4
5const modules = {6  // ...7  [Modules.AUTH]: {8    resolve: "@medusajs/auth",9    options: {10      providers: [11        // other providers...12        {13          resolve: "@medusajs/auth-google",14          id: "google",15          options: {16            clientId: process.env.GOOGLE_CLIENT_ID,17            clientSecret: process.env.GOOGLE_CLIENT_SECRET,18            callbackUrl: process.env.GOOGLE_CALLBACK_URL,19          },20        },21      ],22    },23  },24}

Environment Variables#

Make sure to add the necessary environment variables for the above options in .env:

Code
1GOOGLE_CLIENT_ID=<YOUR_GOOGLE_CLIENT_ID>2GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>3GOOGLE_CALLBACK_URL=<YOUR_GOOGLE_CALLBACK_URL>

Module Options#

ConfigurationDescriptionRequired

clientId

A string indicating the Google API Client ID.

Yes

clientSecret

A string indicating the Google Client Secret.

Yes

callbackUrl

A string indicating the URL to redirect to in your frontend after the user completes their authentication in Google.

At this URL, the frontend will receive a code query parameter. It then sends that code query parameter to the Medusa application's /auth/{actor_type}/google/callback route.

Yes

Examples#

Was this page helpful?
Edit this page