¶ Mobile App Use a small program to log in
Moving App Pull A Small Program Login is a key way to establish a mobile phone number as a central user system. Authing Through SDK, the developer greatly reduces the development of complexity, one line of code can obtain the mobile phone number authorized in the applet by the mobile terminal, establish an account system based on the mobile phone number.
- Application scenario: Mobile APP；
- Overview: Pull up the WeChat applet in your mobile application for login.
- View WeChat official document (opens new window)
¶ Step 1: Create a WeChat mobile app on the WeChat open platform
Please go to WeChat open platform (opens new window)Guide creates a WeChat mobile app, andWeChat open platform (opens new window) control center - Mobile Applications - Application details - Associate small program information page, To initiate an associated small program operation by an auditing mobile application. Required applet- Small login AppID is wxa0435021fd7a3af2.
¶ Step 2: Create a WeChat applet in the WeChat open platform (optional)
By default, the app pulls a mini program login. Authing default mini program is provided, if you need a stronger brand customization capability, or if you want to get the user WeChat account and your other WeChat public platform to log in through the applet, you need to apply for your own applet. If you belong to these two scenarios:
Please go to the WeChat public platform (opens new window) guide creates a WeChat applet, you need to record the App ID and App Secret of the app, will be used later.
At the same time, you need to contact us to get the source code of your login. For details, please consult Authing Contact.
¶ Step 3: Configure "App Pull up a Small Program Login" app in the Authing console (optional)
In the console's social login configuration page, find the app pull a mini program login, fill in the following configuration:
- AppID: AppId of mini program, select the user fill the privatization applet;
- AppSecret: mini program AppSecret，Select the user who is privatatically applying a mini program.
¶ Step 4: Start development access
¶ Pull up WeChat mini program
Developers need to call WechatOpenSDK（Please see WeChat official document (opens new window):
- mini program userName is gh_a781a791e29e
- path is /routers/explore
- path query parameter is:
- userPoolId: Your userpool ID
- getPhone: you need to get the user's mobile phone number, 1 means need, not fill or other means
- fromApp: 1, this parameter must be filled.
- useSelfWxapp: 0. This parameter is required.
Take swift language as an example:
let userPoolId = "5e4cdd055df3df65dc58b97d"
let req = WXLaunchMiniProgramReq()
req.userName = "gh_a781a791e29e"
req.path = "/routes/explore?userPoolId=\(userPoolId)&getPhone=1&fromApp=1&useSelfWxapp=0"
req.miniProgramType = WXMiniProgramType.test
WXApi.send(req)
¶ Receive data returned by the applet
Small login will return a string URL Query String to the app, and the developer can convert it into a dictionary:
- code: The business status code, 200 is successful.
- message: Tip information.
- ticket: The authorization is successful. Developers can use this acquisition user information
func onResp(_ resp: BaseResp) {
print("onResp: type=\(resp.type)")
if resp.isKind(of: WXLaunchMiniProgramResp.self ) {
if resp.errCode == 0 && resp.type == 0{//Authorized success
let response = resp as! WXLaunchMiniProgramResp
let extMsg = response.extMsg!
// WeChat login successful notice
debugPrint(extMsg)
let arr = extMsg.components(separatedBy:"&")
var data = [String:Any]()
for row in arr {
let pairs = row.components(separatedBy:"=")
data[pairs[0]] = pairs[1]
}
let code = data["code"]
let message = data["message"]
let ticket = data["ticket"]
debugPrint(code, message, ticket)
}
}
}
¶ Get user information
User agrees that the developer can use Ticket to exchange user information, Ticket default valid time is two minutes. By default, for security reasons, Ticket exchanges user information requires a user pool key, which means that user information cannot be exchanged directly within the app. We also provide the right to developer choices, developers can modify this option in the user pool base configuration page (see above).
ticket exchange user information
swift Code example:
import Alamofire
struct Body: Encodable {
let ticket: String
}
let body = Body(ticket: ticket)
let url = "https://core.authing.cn/oauth/app2wxapp/auth/5e4cdd055df3df65dc58b97d?ticket=\(ticket)"
AF.request(
url,
method: .post,
parameters: body,
encoder: JSONParameterEncoder.default
).responseJSON { response in
debugPrint("Response: \(response)")
}
¶ Next
After obtaining the user information, you can get the user's identity credential (the token field ), which you can carry in subsequent requests sent by the client to the backend server token, for axios example :
const axios = require("axios");
axios
.get({
url: "https://yourdomain.com/api/v1/your/resources",
headers: {
Authorization: "Bearer ID_TOKEN"
}
})
.then(res => {
// custom codes
});
The legitimacy of this needs to be checked in the back-end interface to verify the user's identity. For details of the verification method, see Verifying User Identity Credentials (token) . After identifying the user's identity, you may also need to perform permission management on the user to determine whether the user has permission to operate this API.