OpenHarmony解读之设备认证：pake协议-客户端发起end请求

一、概述

在前面的文中，客户端首先发起start请求，然后服务端进行响应，本文将介绍客户端收到来自服务端的响应（response）消息的处理过程以及客户端针对该响应发起end请求的过程。

二、源码分析

这一模块的源码位于：/base/security/deviceauth。

1. 首先解析该response消息，调用parse_pake_response函数实现：

/*
函数功能：解析pake服务端响应消息
函数参数：
    payload：消息负载
    data_type：数据类型
函数返回值：
    成功：返回存放解析完成后的数据结构pake_start_response_data
    失败：NULL
*/
void *parse_pake_response(const char *payload, enum json_object_data_type data_type)
{
   
   
    struct pake_start_response_data *pake_response =
        (struct pake_start_response_data *)MALLOC(sizeof(struct pake_start_response_data));//为"响应消息"内容申请空间
    if (pake_response == NULL) {
   
   
        return NULL;
    }
    (void)memset_s(pake_response, sizeof(*pake_response), 0, sizeof(*pake_response));//清空该空间
    json_pobject obj = parse_payload(payload, data_type);//解析消息负载部分，将json格式的字符串数据解析成cjson结构体对象
    if (obj == NULL) {
   
   
        LOGE("Parse Pake Response parse payload failed");
        goto error;
    }
    /* challenge */
    int32_t result = byte_convert(obj, FIELD_CHALLENGE, pake_response->challenge.challenge,
                                  &pake_response->challenge.length, CHALLENGE_BUFF_LENGTH);//获取挑战值，字节转换函数，将十六进制字符串转换为byte数组
    if (result != HC_OK) {
   
   
        LOGE("Parse Pake Response failed, field is null in challenge");
        goto error;
    }
    /* salt */
    result = byte_convert(obj, FIELD_SALT, pake_response->salt.salt,
                          (uint32_t *)&pake_response->salt.length, HC_SALT_BUFF_LEN);//获取salt值，字节转换函数，将十六进制字符串转换为byte数组
    if (result != HC_OK) {
   
   
        LOGE("Parse Pake Response failed, field is null in salt");
        goto error;
    }
    /* epk */
    result = byte_convert(obj, FIELD_EPK, pake_response->epk.epk,
                          &pake_response->epk.length, PAKE_EPK_LENGTH);//获取epk值，字节转换函数，将十六进制字符串转换为byte数组
    if (result != HC_OK) {
   
   
        LOGE("Parse Pake Response failed, field is null in epk");
        goto error;
    }
    /* version */
    json_pobject obj_ver = get_json_obj(obj, FIELD_VERSION);//获取版本号
    bool ret = parse_version(obj_ver, &pake_response->self_version, &pake_response->self_support_version);//解析版本号
    if (!ret) {
   
   
        LOGE("Parse Pake Response failed, field is null in version");
        goto error;
    }
    free_payload(obj, data_type);
    return (void *)pake_response;//返回解析完成的消息数据
error:
    free_payload(obj, data_type);
    FREE(pake_response);
    return NULL;
}

/*
函数功能：如果消息负载为json格式的字符串，则将json格式的数据解析成cjson结构体对象；如果消息负载为cjson结构体对象类型，则返回原内容；否则返回NULL
函数参数：
    payload：消息负载地址
    data_type：数据类型：只有JSON_STRING_DATA和JSON_OBJECT_DATA
*/
void *parse_payload(const char *payload, enum json_object_data_type data_type)
{
   
   
    if (data_type == JSON_STRING_DATA) {
   
   //如果json对象类型为：json格式的字符串
        return parse_json(payload);//将json格式的数据解析成cjson结构体对象
    } else if (data_type == JSON_OBJECT_DATA) {
   
   //如果json对象类型为：cjson结构体对象
        return (void *)payload;//直接返回原内容
    } else {
   
   
        return NULL;//如果都不是，返回NULL
    }
}

/*
函数功能：字节转换函数，将十六进制字符串转换为byte数组
函数参数：
    obj：cjson结构体对象
    field：目标字段
    hex：目标数组地址
    length：数组长度
    max_len：最大长度
函数返回值：
    成功：0
    失败：error number
*/
int32_t byte_convert(json_pobject obj, const char *field, uint8_t *hex, uint32_t *length, uint32_t max_len)
{
   
   
    const char *str_json = get_json_string(obj, field);//获取field对象的字符串值
    if (str_json == NULL) {
   
   
        return HC_INPUT_ERROR;
    }

    uint32_t len = strlen(str_json);//获取字符串长度
    if ((len / BYTE_TO_HEX_OPER_LENGTH) > max_len) {
   
   
        r