Integration workflow

Integration overview

This integration solution requires building a web client and an application server. These components connect to the verification server to complete the verification.

Server side

The server needs to integrate the InitFaceVerify (initiate verification request) and DescribeFaceVerify (get detailed verification data) APIs:

• The InitFaceVerify API is essential for verification. This API returns the verification page URL (CertifyUrl) and ID (CertifyID), and enables redirection to your business page after verification is complete.

• The DescribeFaceVerify API retrieves the final verification result. Call this API to obtain detailed result information when the client receives a completion status (passed or failed).

The following sequence diagram illustrates how to use these two APIs.

Sequence diagram:

Web client

The web client needs to build a verification trigger page and a result display page:

• The verification trigger page sends an initialization request to the InitFaceVerify API that is integrated on your server. After the server returns the CertifyUrl, your web client redirects the user to the verification page.

• After verification is complete, the verification server automatically redirects the user to the result display page. You specify this page's address with the ReturnUrl parameter when your server calls the InitFaceVerify API.

• On the result display page, send a request with the CertifyID to your server to call the DescribeFaceVerify API and retrieve the final verification result.

Prerequisites

1. To use the Financial-grade Identity Verification Service, you must first enable it. For instructions, see Enable Financial-grade Identity Verification Service.

2. For fine-grained service access management, create a RAM user before you integrate the SDK. Grant the RAM user access to your cloud resources to call service interfaces and obtain OpenAPI access credentials. For instructions on creating a RAM user, granting permissions, and generating an AccessKey, see Authorize a RAM user to access the service.

3. Add a verification scenario.

   Note

   When adding a verification scenario, you can authorize Alibaba Cloud to access a specified OSS bucket to store images from the verification process. For more information, see Activate and authorize OSS storage.