Configure Google Single Sign-On (SSO) with WordPress OAuth – WordPress Google SSO
Set up Single Sign-On (SSO) on your WordPress website via Google Apps with the WordPress OAuth & OpenID Connect Single Sign-On plugin via WordPress SSO. 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 Single Sign-On or GSuite, acts as the OAuth Provider and WordPress acts as the OAuth Client. WordPress Google SSO 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 Google Single Sign-On via 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 Google SSO. Google login via WordPress OAuth SSO secures the user’s login process and improves user authentication authority.
Using the OAuth SSO plugin, you can allow or restrict your organization users as well as guest users based on their email domains such as organization/comapny domain or personal domain such as gmail.com Follow the steps in the guide below to set up your WordPress SSO via installing 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 WordPress SSO using Google as OAuth Provider on your WordPress site, allowing users to use Google SSO login into the WordPress site with their Google login Credentials.
2. Setup WordPress as OAuth Client
- Go to Configure OAuth tab and click Add New Application to add a new client application into your website.
- Choose your Application from the list of OAuth / OpenID Connect Providers, Here Google
- Copy the Callback URL to be used in OAuth Provider Configuration. Click Next.
You need to enter the App name and Endpoints here, for that please refer the below table and click on Next.
- Enter the client credentials like Client ID & Client Secret as shown in the setup dialogue box. Enter the scope values as email openid profile. Click Next.
- Click on Finish to save the configuration.
| 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 |
| Custom redirect URL after logout: [optional] | https://www.google.com/accounts/Logout |
You've successfully configured WordPress SSO with Google making WordPress as OAuth Client, allowing users to implement secure Google SSO login into the WordPress site with Google login Credentials.
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.
- 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.
Finding user attributes
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.
- Go to WordPress Left Panel > Appearances > Widgets.
- Select miniOrange OAuth. Drag and drop to your favourite location and save.
- 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.
- 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).
Google Single Sign-On (SSO) should now be successfully configured with Google 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. You can also protect your complete WordPress site behind Google SSO. Otherwise, you can also configure other IDPs like 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
- WordPress Single Sign-On (SSO) OAuth / OpenID Connect / JWT
- 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.
Need Help? We are right here!
