Set up Single Sign-On (SSO) on your WordPress website via Google Apps with the WordPress OAuth & OpenID Connect Single Sign-On plugin. Implementing G Suite SSO allows users to log into your websites and applications with a single set of credentials using the G Suite login credentials.

Google Workspace SSO, or GSuite, acts as the OAuth Provider and WordPress acts as the OAuth Client. WordPress G Suite Authentication provides smooth login between these two, removing the need to remember usernames and passwords. If you are looking for Google Classroom SSO, you can visit the setup guide here.

The G Suite OAuth WordPress plugin also provides advanced SSO features like user profile attribute mapping, role mapping, and role-based access for user profiles. You can also protect your complete WordPress site behind SSO. Google Sign In WordPress OAuth SSO secures the user’s login process and improves user authentication authority. Follow the steps in the guide below to install this plugin.

Prerequisites: Download and Installation

• Log into your WordPress instance as an admin.
• Go to the WordPress Dashboard -> Plugins and click on Add New.
• Search for a WordPress OAuth Single Sign-On (SSO) plugin and click on Install Now.
• Once installed click on Activate.

Steps to configure Google OAuth Login with WordPress

1. Setup Google as OAuth Provider

• Go to https://console.developers.google.com/ and sign up/login.
• Click on Select Project to create a new Google Apps Project,you will see a popup with the list of all your projects.

• You can click on the New project button to create new project.

• Enter your Project name under the Project Name field and click on Create.

• Go to Navigation MenuAPIsServicesCredentials.

• Click on Create Credentials button and then select OAuth Client ID from the options provided.

• In case you are facing some warning saying that in order to create an OAuth Client ID, you must set a product name on consent screen (as shown in below image). Click on the Configure consent screen button.

• Choose how you want to configure and register your app and click on create button.

• Enter the required details such as App Name, User Support Email. and click on Save and Continue button.

• Now for configuring scopes, click on Add or Remove the Scopes button.

• Now, Select the Scopes to allow your project to access specific types of private user data from their Google Account and click on Update button.

• Go to the Credentials tab and click on Create Credentials button. Select Web Application from dropdown list to create new application.

• Enter the name you want for your Client ID under the name field and enter the Redirect/Callback URI from miniOrange OAuth Client plugin/module under the Authorized redirect URIs field and click on Create button.

• You will see a popup with the Client ID and Client Secret Copy your Client ID and Client Secret and save it on your miniOrange OAuth Client plugin Configuration.

You've successfully configured Google (G-suite) as OAuth Provider on your WordPress site, allowing users to securely access their digital resources using a single set of G Suite login credentials and improve user authentication by WordPress login with Google.

2. Setup WordPress as OAuth Client

3. User Attribute Mapping

• User Attribute Mapping is mandatory for enabling users to successfully login into WordPress. We will be setting up user profile attributes for WordPress using below settings.

Finding user attributes

• Go to Configure OAuth tab. Scroll down and click on Test Configuration.

• You will see all the values returned by your OAuth Provider to WordPress in a table. If you don't see value for Email or Username, etc. make the required settings in your OAuth Provider to return this information.
• Once you see all the values in Test Configuration, go to Attribute / Role Mapping tab, you will get the list of attributes in a Username dropdown.

4. Sign In Settings

• The settings in Single Sign-On (SSO) Settings tab define the user experience for Single Sign-On (SSO). To add a G Suite login widget on your WordPress page, you need to follow the below steps.

Sign in settings for WordPress 5.7 and before

• Go to WordPress Left Panel > Appearances > Widgets.
• Select miniOrange OAuth. Drag and drop to your favourite location and save.


Sign in settings for WordPress 5.8

• Go to WordPress Left Panel > Appearances > Widgets.
• Select miniOrange OAuth. Drag and drop to your favourite location and save.

• Open your WordPress page and you can see the Google SSO login button there. You can test the Google Single Sign-On (SSO) now.

Sign in settings for WordPress 5.9

• Make sure the "Show on login page" option is enabled for your application. (Refer to the below image)

• Now, go to your WordPress Login page. (Eg. https://< your-wordpress-domain >/wp-login.php)
• You will see an Google SSO login button there. Once you click the login button, you will be able to test the Google Single Sign-On (SSO).

5. Scope & Endpoints

• Please refer the below table for configuring the endpoints for Google in the plugin.

Scope:	openid email profile
Authorize Endpoint:	https://accounts.google.com/o/oauth2/auth
Access Token Endpoint:	https://www.googleapis.com/oauth2/v4/token
Get User Info Endpoint:	https://www.googleapis.com/oauth2/v1/userinfo

WordPress Google OAuth SSO plugin should now be successfully configured with Google Workspace as the OAuth Provider and WordPress as the OAuth Client. Google SSO should fulfill all your needs with features like multiple grant type support, attribute mapping, role mapping, etc. You may set up the SSO with G-Suite, Google Workspace, and Google social login using the same process.

Additional Resources

• What is OAuth 2.0?
• Google OAuth and OpenID Connect
• Google Developers Console
• Frequently Asked Questions (FAQs)
• Secure G Suite Apps

Mail us on oauthsupport@xecurify.com for quick guidance(via email/meeting) on your requirement and our team will help you to select the best suitable solution/plan as per your requirement.