数据模型

SDK 包含以下数据模型：

• MYTFProfile

• SGXReport

• ProfileData

• MYTFInfo

• TAPPProfile

• TAPPInfo

• TAPPInstallRequest

• TAPPInstallResponse

• TAPPRemoveRequest

• TAPPRemoveResponse

• TAPPExecuteRequest

• TAPPExecuteResponse

• TAPPAuthorizeRequest

• TAPPAuthorizeResponse

MYTFProfile

MYTFProfile 是可验证的 MYTF 身份信息。Profile的概念是指可信计算引擎中的某个独立组件的身份和状态信息。该组件持有自己的签名密钥和加密密钥，签名密钥可以用于向外证明该组件在可信计算引擎中的行为，加密密钥可以用于该组件和外界进行端到端的加密通信。

在 MYTF 计算节点初始化时，首先通过 Intel SGX 提供的 Local Attestation 本地认证功能，Enclave 会生成代表自身身份的自荐信息 Quote。然后，通过 Intel SGX 提供的 Remote Attestation 远程认证功能，MYTF 会将自荐信息发送给 Intel 远程认证服务IAS。IAS 会对 MYTF 所在的可信执行硬件和 MYTF 中运行的 Enclave 代码进行核身校验。其中，具有唯一性的 MYTF 身份信息数据profileData的哈希会作为自荐信息中的一部分，一起被 IAS 进行完整性校验。

使用 MYTF SDK 的用户，可以向任意一个 MYTF 实例获取被IAS服务认证过的 MYTF 身份信息MYTFProfile并验证该 MYTF 实例是否安全可信。

SGXReport

Intel SGX 认证报告，IAS 对 MYTF 身份信息和所在硬件信息的验证报告。

ProfileData

ProfileData是具有唯一性的 MYTF 身份信息数据，其中包括MYTFInfoMYTF 身份信息和CounterInfo计数信息。在 MYTF 生成自荐信息Quote时，ProfileData的哈希会作为自定义数据，由 MYTF 自己注入在 Quote 中，一起被 IAS 进行完整性校验。

MYTFInfo

MYTFInfo是 MYTF 的身份信息。MYTFProfile 是被 IAS 校验过的MYTF身份信息，其中包括 MYTFInfo 和 IAS 的校验证明。在 MYTFInfo 中，Encryption Keys是 MYTF 的加密公钥，Signing Keys是 MYTF 的签名公钥，公钥根据不同算法有多个。

TAPPProfile

TAPPProfile是可验证的 TAPP 身份信息。包括TAPPInfo和 MYTF 对TAPPInfo的签名。

TAPPInfo

TAPPInfo是 TAPP 的身份信息。其中Encryption Keys是该 TAPP 的加密公钥。Signing Keys是 TAPP 的签名公钥，公钥根据不同加密算法有多个。

TAPPInstallRequest

构造安装 TAPP 请求示例：

// 构造安装 TAPP 请求
TappInstallRequest tappInstallRequest = TappInstallRequest.builder()
    .newTapp(tappId, tappVersion, bytecodes)
    .setTappDescription(tappDesc)
    .build();

TAPPInstallResponse

解析安装 TAPP 响应示例：

// 解析安装 TAPP 响应
TappInstallResponse tappInstallResponse = restClient.installTapp(tappInstallRequest);
boolean ifSuccess = tappInstallResponse.isSuccess();
int errorCode = tappInstallResponse.getErrorCode();
String errorMsg = tappInstallResponse.getErrorMessage();

TAPPRemoveRequest

构造删除 TAPP 请求示例：

// 构造删除 TAPP 请求
TappRemoveRequest tappRemoveRequest = TappRemoveRequest.builder()
  .defaultRequest(tappId, tappVersion)
  .build();

TAPPRemoveResponse

解析删除 TAPP 响应示例：

// 解析删除 TAPP 响应
TappRemoveResponse tappRemoveResponse = restClient.removeTapp(tappRemoveRequest);
Assert.assertTrue(tappRemoveResponse.isSuccess());

TAPPExecuteRequest

构造执行 TAPP 请求示例：

// 构造执行 TAPP 请求
TappExecuteRequest tappExecuteRequest = TappExecuteRequest.builder()
    .defaultRequest(tappId, tappVersion, testReqMethod)
    .build();

TAPPExecuteResponse

解析执行 TAPP 响应示例：

// 发送执行 TAPP 请求
TappExecuteResponse tappExecuteResponse = restClient.executeTapp(tappExecuteRequest);

// 可信计算任务请求是否合法
boolean ifReqSuccess = tappExecuteResponse.isRequestSuccess();

// 可信计算任务执行是否成功
boolean ifExeSuccess = tappExecuteResponse.isExecuteSuccess();

// 查看计算任务请求是否合法及错误码
int responseCode = tappExecuteResponse.getResponseCode();
String responseMessage = tappExecuteResponse.getResponseMessage();

// 查看计算任务执行过程中用户自定义输出或执行失败后计算引擎抛出的错误信息
byte[] returnValue = tappExecuteResponse.getOutput();

// 获取执行结果
byte[] returnValue = tappExecuteResponse.getReturnValue().getRawReturnValues();

// 获取 TAPP 签名
byte[] sig = tappExecuteResponse.getSignature();

TAPPAuthorizeRequest

构造授权 TAPP 请求示例：

// 构造授权TAPP请求
UserIdentityData authorizeeData = new UserIdentityData(UserDomainEnum.BAASREST, "user_id","", AccessTypeEnum.EXECUTE);

TappAuthorizeRequest tappAuthorizeRequest = TappAuthorizeRequest.builder()
  .defaultRequest(tappId, tappVersion, authorizeeData)
  .build();

TAPPAuthorizeResponse

解析授权 TAPP 响应示例：

// 解析授权 TAPP 响应
TappAuthorizeResponse tappAuthorizeResponse = restClient.authorizeTapp(tappAuthorizeRequest);
Assert.assertTrue(tappAuthorizeResponse.isSuccess());