Integrate the client SDK and server API to authenticate users online within your existing client application.
Prerequisites
You must know how to create a request signature to call the ID Verification service API over HTTP or HTTPS. For more information, see Integrate with the ID Verification service.
Procedure
Activate the ID Verification service. For more information, see Activate the ID Verification service.
Integrate the mobile SDK with the server.
This process is called Mobile SDK and Server Integration and involves the following steps.
Call the server-side initialization API.
Integrate the client SDK.
Call the server-side query API.
The following sequence diagram shows the detailed integration steps.
No.
Description
1
A user initiates a business process, such as an identity proofing process, through the merchant application.
2
The merchant app calls the getMetaInfo interface to obtain the meta information about the Alibaba Cloud SDK and the user's device.
3
The Alibaba Cloud SDK returns the meta information to the merchant application.
4
The merchant application initializes a transaction and passes the meta information to the merchant server.
5
Using the meta information as an input, the merchant server calls the Initialize API to obtain the client configuration information. This information includes parameters about the SDK connection and behavior.
6
The Alibaba Cloud server performs a usability check based on the meta information. If the check is passed, the Alibaba Cloud server returns the client configuration information to the merchant server.
7
The merchant server returns the client configuration information to the merchant application.
8
The merchant application starts the Alibaba Cloud SDK with the client configuration information that is obtained in Step 7.
9
The Alibaba Cloud SDK interacts with the user, captures required data such as face images, and uploads the data to the Alibaba Cloud server for verification. There might be multiple rounds of interaction between the Alibaba Cloud SDK and the Alibaba Cloud server.
10
The Alibaba Cloud server performs related checks on the uploaded user data and returns the transaction status to the Alibaba Cloud SDK. If all checks are passed, a result code that indicates success is returned to the Alibaba Cloud SDK. Otherwise, the process might be interrupted and require further interaction between the user and the Alibaba Cloud SDK.
11
The Alibaba Cloud SDK notifies the merchant application that the transaction is complete.
12
The merchant application notifies the merchant server that the transaction is complete and initiates a verification of the transaction details.
13
The merchant server calls the CheckResult API to verify the transaction details with the Alibaba Cloud server.
14
The Alibaba Cloud server returns the transaction details to the merchant server.
NoteTo ensure information security, sensitive information such as the captured face image is returned only to the merchant server.
15
The merchant server filters the transaction details returned from the Alibaba Cloud server and returns the non-sensitive information to the merchant application.
16
The merchant application informs the user that the process is complete.
Choose one of the following integration methods.
For server-side integration, see Initialize.
For client-side integration, see the following documents for detailed instructions based on your platform.