To add WeChat OAuth provider to your application, follow these steps:
- Visit the WeChat developer platform and register as a developer.
- After your web application or mobile application is approved, you will receive your App ID and App Secret.
The WeChat provider offers two different sets of keypairs:
The first keypair (
Client Secret) is for the
WeChat Open Platform (微信开放平台)and is designed for the PC login scenario. It allows you to display a QR code in the PC browser, which users can scan using the WeChat app on their mobile phone to sign in.
The second keypair (
Client ID 2,
Client Secret 2) is for the
WeChat Media Platform (微信公众平台)and is intended for the inside-WeChat-app login scenario. It enables users to log in with the WeChat built-in browser inside the WeChat mobile app, which will redirect them to your
WeChat Official Account (微信公众号)to log in. Please note that WeChat does not support logging in outside of the WeChat app in other mobile browsers or apps. This limitation is imposed by WeChat and not by Casdoor.
If you fill in the second keypair (
Client ID 2,
Client Secret 2) and enable the
Enable QR code switch, Casdoor will ask the user to follow the WeChat official account (微信公众号) before proceeding with the login process when the user clicks on the WeChat button to log in. It's important to note that this functionality is only available in the PC login scenario because a mobile phone cannot scan the QR code by itself. When used in the mobile scenario (i.e., the WeChat built-in browser inside the WeChat mobile app), Casdoor will automatically skip this step.
We recommend setting both key sets at the same time and linking your
WeChat Open Platform (微信开放平台) account and
WeChat Media Platform (微信公众平台) account together inside the
WeChat Open Platform (微信开放平台). This will allow Casdoor to recognize a WeChat user logged in through both PC and mobile as the same user.
Due to the limitations of WeChat OAuth, there is currently no way to log in via WeChat in a third-party mobile app or in a mobile browser other than the WeChat app. The mobile login must happen inside the WeChat app for now.
For more detailed information, please visit the WeChat Open Platform.