To setup Single Sign-On between two wordpress websites (wp-wp single sign on), consider WordPress site 'A' as a server-side database for your users. And WordPress site 'B' serves as the client side, allowing users to log in using the credentials from site 'A.' Installing the OAuth Server plugin on server site (site A) and the OAuth Client plugin on client site (site B) will allow users to connect to your WordPress client site using their WordPress server site credentials (site B) using OAuth / OpenID Connect / JWT protocol. On the WordPress client site (site B) where you wish to execute SSO, install our OAuth Client plugin to perform wordpress single sign between multiple sites. WordPress client site responsibilities can be mapped based on WordPress client site attributes/groups. To know more about other features we provide in the WP OAuth Client plugin, you can click here and for OAuth Server Plugin you can click here. Also, this will allow you to Auto-Login into multiple WordPress sites using a single WordPress site credentials.

Pre-requisites : Download And Installation

1. Installation Steps for WordPress OAuth Server Single Sign-On (SSO) plugin

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

2. Installation Steps for WordPress OAuth Single Sign-On (SSO) plugin

• Log into your WordPress instance" B " 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 SSO across Multiple WordPress Sites

1. Setup Wordpress as OAuth Server

• Go to miniOrange OAuth Server plugin on the left side menu and choose your OAuth client from the list, Here WordPress.

• Enter Client name as you want. Copy Redirect / Callback URL from OAuth Client Single Sign-On (SSO) plugin and enter under Authorized Redirect URI field. Click on Save client button.

• Note down Client Id and Client Secret to configure in the OAuth Client Single Sign-On (SSO) plugin

You have successfully configured WordPress as OAuth Server for achieving user authentication and SSO between multiple wordpress sites

2. Setup WordPress as OAuth Client

• Free
• Premium

• 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 WordPress.

• Copy the Callback URL to be used in OAuth Provider Configuration and click Next.


• Please refer the below table for configuring the scope & endpoints for WordPress OAuth Server in the plugin .

Client ID :	from the step 1 above
Client Secret :	from the step 1 above
Scope:	openid
Authorize Endpoint:	https://<your-site-url>/wp-json/moserver/authorize
Access Token Endpoint:	https://<your-site-url>/wp-json/moserver/token
Get User Info Endpoint:	https://<your-site-url>/wp-json/moserver/resource

• Now, configure App Name, Authorization Endpoint, Token Endpoint, Userinfo Endpoint received from WordPress OAuth Server. Click Next.

• Configure the client credentials like Client ID & Client Secret as shown in the setup dialogue box and enter the scope value as openid. Click Next.

• Click on the Finish button.

You've successfully established WordPress as an OAuth Client, allowing users to perform Single Sign-On (SSO) between multiple wordpress sites using a single set of login credentials with WP - WP Single Sign-On (SSO) login into your WordPress site.

• Go to the Configure OAuth tab in the Plugin and search for WordPress in the applications list and select WordPress.

• Configure App Name, Client ID, Client Secret, Scope and Endpoints from Wordpress OAuth Server SSO application.

• Please refer the below table for configuring the scope & endpoints for WordPress OAuth Server in the plugin. And click on Save button.

Scope:	openid
Authorize Endpoint:	https://<your-site-url>/wp-json/moserver/authorize
Access Token Endpoint:	https://<your-site-url>/wp-json/moserver/token
Get User Info Endpoint:	https://<your-site-url>/wp-json/moserver/resource

You've successfully established WordPress as an OAuth Client, allowing users to perform Single Sign-On (SSO) between multiple wordpress sites using a single set of login credentials with WP - WP Single Sign-On (SSO) login into your WordPress site.

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.

• Free
• Premium

• You will see different user attributes returned by your OAuth Provider in a test configuration table. If you don't see any user attributes, 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, select attributes from Username dropdown and click on Save.

You have successfully configured WordPress as OAuth Client for achieving user authentication with Wordpress OAuth Server Single Sign-On (SSO) login into your WordPress Site.

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

• You will see different user attributes returned by your OAuth Provider in a test configuration table. If you don't see any user attributes, make the required settings in your OAuth Provider to return this information.

• Once you see all the values in Test Configuration, scroll down and go to Attribute / Role Mapping section, 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 WordPress 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 WordPress SSO login button there. You can test the WordPress 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 WordPress SSO login button there. Once you click the login button, you will be able to test the WordPress Single Sign-On (SSO).

You have successfully configured Single Sign-On between two wordpress sites by configuring WordPress as OAuth Provider and WordPress as OAuth Client using our WP OAuth Single Sign-On (SSO). This solution ensures that you configure wp-wp Single Sign-On and are ready to increase user authentication authority by securing login to your WordPress site A using WordPress site 'B' as client side where you want to login users using site 'A' account credentials.

Additional Resources

• What is OAuth 2.0?
• WordPress to WordPress SSO plugin
• SSO between two wordpress sites
• Frequently Asked Questions (FAQs)

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.