GenerateAliyunBidCertWaysUrl

Access instructions

When you call the GenerateAliyunBidCertWaysUrl operation, the AccessKeyId in the common request parameters must be the key ID of the reseller's Alibaba Cloud account.

https://aas.aliyuncs.com/?Action=GenerateAliyunBidCertWaysUrl&Platform=pc&BidType=LIGHTWEIGHT&Timestamp=2021-09-28T09%3A35%3A30Z&Source=BID&Format=JSON&SubjectType=all&SignatureNonce=a193d4b3-e54b-40f7-9d22-62107514cedd&IsOpenApp=true&AliyunPk=10****4893&IsMobile=true&<Common request parameters>

The operation returns a URL that is valid for 3 hours. You can use this URL to directly complete the identity verification process.

Parameters

Common parameters

Business parameters

Return values

// Sample success response
{
  "RequestId":"7A4326A9-5B17-5BB2-B95D-4CE1EAAD55B9",
    // Open this URL directly on the corresponding platform.
 "Data":"https://account.aliyun.com/cert/listCertWays.html?token=YWxpeXVuSWxxxxxxxxxxdXRQa2RGY0R4Q3BoVjZ5M3ZuemdHRQ==",
 "Success":true
    }

// Sample failure response

{
  "RequestId":"382AD1A2-0641-55EB-A113-395A45AC80C7",
"Message":"Specified signature is not matched with our calculation. server string to sign is:POST&%2F&AccessKeyId%3DLTxxxxxxg0N7cz5%26Action%3DGenerateAliyunBidCertWaysUrl%26AliyunPk%3D1039740447764893%26BidType%3DLIGHTWEIGHT%26Format%3Djson%26IsMobile%3Dtrue%26IsOpenApp%3Dtrue%26Platform%3Dpc%26SignatureMethod%3DHmac-SHA1%26SignatureNonce%3Dcac135a3-a3f3-4b11-9cc8-2479bd2c4fb2%26SignatureVersion%3D1.0%26Source%3Decs%26SubjectType%3Dall%26Timestamp%3D2021-09-28T09%253A37%253A17Z%26Version%3D2015-07-01",
"Code":"SignatureDoesNotMatch"
}
            

Error messages

Frontend integration

Embed FastAuthc

// src is the link that you obtain from the API.
<iframe src={src} />

Listen for FastAuthc events

// Because FastAuthc is integrated into your application as an IFrame, use events for two-way communication.
window.addEventListener("message", (e) => {
  const { data }  = e;
  console.log(data);
})

Data structure

// The following shows the data structure of the message sent by FastAuthc.
// The data structure is as follows:
{
    success: boolean;
        type: MessageType;
    data: any; // Additional information
}
    

// MessageType indicates when FastAuthc sends a message.
export enum MessageType {
  INIT = "aliyun_fast_auth_init", // Page initialization
  LATER = "aliyun_fast_auth_later", // Verify later
  ANOTHER_AUTHC_WAY = "aliyun_fast_auth_another_authc_way", // Select another verification method
  AUTHC_SUCCESS = "aliyun_fast_auth_success", // Verification successful
  AUTHC_FAIL = "aliyun_fast_auth_fail", // Verification failed
  RE_AUTHC = "aliyun_fast_auth_re_authc", // Re-verify
  OPEN_ALIPAY = "aliyun_fast_auth_open_alipay", // Open Alipay verification page
}

// Example of a failed verification
{
    success: true,
    type: "fail",
    data: {
      reason: "Reason for verification failure",
    },
}

// Other cases
{
    success: true,
    type: The corresponding MessageType,
    data: {},
}

Appendix

For more information about signatures, see https://help.aliyun.com/document_detail/91847.htm#concept-2041363.

For more information about common parameters, see https://help.aliyun.com/document_detail/91846.html.