WeChat OAuth Single Sign-On (SSO) In WordPress | WeChat SSO Login

WeChat Single Sign-On (SSO) with WordPress OAuth & OpenID Connect Single Sign-On (SSO) plugin. Enable secure login into WordPress using WeChat as OAuth and OpenID Connect provider. WeChat Single Sign-On (SSO) with WordPress allows your users to login to your WordPress and access the site by authenticating with their WeChat identity provider. You can also configure plugin using different IDPs such as Azure AD, Office 365, and other custom providers. It supports advanced Single Sign-On (SSO) features such as user profile Attribute mapping, Role mapping, multi-tenant login etc. Here we will go through a guide to configure WeChat Single Sign-On (SSO) with WordPress for user authentication. By the end of this guide, users should be able to perform secure login to WordPress and access the site with WeChat SSO. To know more about other features we provide in WP OAuth Single Sign-On ( OAuth & OpenID Connect Client ) plugin, you can click here.

Pre-requisites : 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 WeChat Single Sign-On (SSO) Login into WordPress

1. Setup WeChat as OAuth Provider

• Go to https://open.weixin.qq.com/ and signup or login to your WeChat developer account.
• Go to the Applications page, click on the create a new app button.

• Enter your application name and description and upload two icons for the app. Then click the "Next" button.
• [Note*-28x28 pixels and 108x108 pixels in PNG format, up to 300 KB in file size for the icon image]

• On the next screen of creation, enter the "Authorized Callback URL" which you will get from your Configure Oauth tab of the OAuth Single Sign-On (SSO) plugin.
• Click on the download link to download the WeChat registration form.

• Print the downloaded WeChat registration form, fill the form, save or scan the signed version.
• Traverse back to the application creation page, click on the "Browse" button and upload the WeChat filled and signed version of the form. Click on the Submit button.

• Now Copy the Client ID and Client Secret and save it under the Client ID and Client Secret in your WordPress OAuth Single Sign-On (SSO) Plugin Configuration.

You have successfully configured WeChat as OAuth Provider for achieving WeChat Single Sign-On (SSO) with WordPress for user authentication.

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 Custom OAuth 2.0 App.

• Copy the Callback URL to be used in WeChat Configuration. Click Next.


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

  Client ID :	from the WeChat SSO application configured
  Client Secret :	from the WeChat SSO application configured
  Scopes	snsapi_login
  Authorize Endpoint:	https://open.weixin.qq.com/connect/oauth2/authorize
  Access Token Endpoint:	https://api.weixin.qq.com/sns/oauth2/access_token
  Userinfo Endpoint:	https://api.weixin.qq.com/sns/userinfo


• Enter the Client Credentials like Client ID & Client Secret in the setup dialogue box. Enter the scope value as snsapi_login. Click Next.

• Click on Finish to save the configuration.

You have successfully configured WordPress as OAuth Client for achieving WeChat Single Sign-On (SSO) with WordPress for user authentication.

3. User Attribute Mapping

• User Attribute Mapping is mandatory for enabling users to successfully Single Sign-On into WordPress using WeChat SSO. We will be setting up user profile attributes for WordPress using the 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 First Name, Last Name, Email or Username, 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.


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 WeChat 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 WeChat SSO login button there. You can test the WeChat 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 a WeChat SSO login button there. Once you click the login button, you will be able to test the WeChat Single Sign-On (SSO).


In this Guide, you have successfully configured WeChat Single Sign-On (SSO) by configuring WeChat as OAuth Provider and WordPress as OAuth Client using our WP OAuth Single Sign-On ( OAuth / OpenID Connect Client ) plugin.This solution ensures that you are ready to roll out secure access to your WordPress site using WeChat login credentials within minutes.

Additional Resources

• What is OAuth 2.0?
• 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.