端云互信DEMO通信流程图

业务流程图

本地加密通信测试流程

PCC环境端云互信测试流程

准备测试服务端

步骤1：SDK下载

下载地址

步骤2：SDK安装（依赖 Python >= 3.8）。

version=0.1.7.28
pip3 install bytedance.jeddak_secure_channel-${version}-py3-none-any.whl

步骤3：准备服务端代码

代码示例（example_server.py）

步骤4：生成服务端验签用的公钥和私钥

执行如下命令生成 myPrivateKey.pem和myPublicKey.pem

openssl genrsa -out ./myPrivateKey.pem 4096
openssl rsa -pubout -in ./myPrivateKey.pem -out ./myPublicKey.pem

步骤5：服务端运行配置

{
  "tks_url": "open.volcengineapi.com", //固定不需要修改
  "tks_app_id": "2100278143",//火山引擎账号ID
  "tks_ring_id": "bfb396fe-3bab-43b6-a338-c44750645b88",//密钥环ID
  "tks_key_id": "8f4cb49a-11a9-4d28-83a1-2304f3567260",//密钥ID
  "bytedance_top_info": "{\"ak\": \"***\", \"sk\": \"***\", \"service\": \"pcc\"}",
  "refresh_interval": 3600,
  "root_key_config": "[{\"app_info\": \"test_id_test_name\", \"pub_key\":\"./myPublicKey.pem\"}]",
  "client_ra_config": "{\"open\": false,\"ra_service_name\": \"dhwdQ56TzxFVDtKA\",\"ra_policy_id\": \"9eb6b259-a3fe-580c-90c5-ef20a92309c8\"}"
}
JSON

• 参数获取说明：

  • 【tks_app_id】：在火山引擎页面查看账号ID，如下图所示，。

    

  • 【bytedance_top_info】点击火山账号，选择“API访问密钥”，新建该账号的【ak】、【sk】。

    

准备测试客户端

步骤1：SDK下载

下载地址

步骤2：SDK安装（依赖 Python >= 3.8）

version=0.1.7.28
pip3 install bytedance.jeddak_secure_channel-${version}-py3-none-any.whl

步骤3：客户端代码

代码示例（example_client.py）

步骤4：客户端签名私钥

详见 步骤4：生成服务端验签用的公钥和私钥。

步骤5：客户端运行配置

参考（client_config.json）

{
  "ra_url": "open.volcengineapi.com",// 固定不变
  "ra_service_name": "rag_client_test", //接收端服务在Jeddak PCC上部署时的服务名称
  "ra_policy_id": "16a371d7-130b-58eb-9e95-b5b816559ad8",//做远程证明时的策略ID
  "ra_uid": "2100278143",
  "bytedance_top_info": "{\"ak\": \"***\", \"sk\": \"**\", \"service\": \"pcc\"}",
  "attest_interval": 600
}

• 参数获取说明：
  • 【ra_uid】：在火山引擎页面查看账号ID，如下图所示，
    
  • 【bytedance_top_info】点击火山账号，选择“API访问密钥”，新建该账号的【ak】、【sk】。
    

服务容器打包部署至PCC

步骤1：示例服务镜像打包

• 准备环境
  • 安装 docker的Linux环境
• 准备镜像打包配置

  • 配置文件: server.dockerfile 和 Makefile

  • 建议修改位置

    • 基础镜像，建议使用debian10.python39
    
    • Makefile 中修改镜像仓库实际地址
      • 把【jeddak-cc-infra-cn-beijing.cr.volces.com/jsc_example】替换成用户本地的镜像仓库的实际地址；

  • 将修改好的两个配置文件放入Linux环境的打包目录；

• 打包镜像

  ## 执行如下命令 进行本地镜像打包
  make server
  

步骤2：服务镜像上传火山镜像仓库

• 登录火山镜像仓库：https://console.volcengine.com/cr/region:cr+cn-beijing/instances?projectName=default
• 创建或进入已有的实例，然后获取临时访问指令

• 复制后在本地控制台粘贴执行

  

• 完成到火山仓库的login过程后，执行如下命令

  ## 实现镜像服务的上传至火山镜像仓库
  make push_server
  

• 结果：将本地的镜像上传到火山镜像仓库，上传后在火山的镜像仓库中可见到类似如下内容：
  

步骤3：服务端镜像部署至PCC

• 详细步骤，见典型场景4【容器部署】未加密容器镜像部署 或 典型场景5【容器部署】加密容器镜像部署，可以根据实际情况选择对应场景进行容器部署；

• 部署成功后记录下服务端的IP地址和端口，详细位置如下：

  • 进入【机密容器服务】模块，点击【机密容器】菜单，选择服务部署的机密容器；
  
  • 点击名称进入机密容器详情页，按照如下位置找到对应的IP地址和端口；
  

步骤4：端云服务联调

• 修改example_client.py中的server_addr内容为新的服务端IP地址和端口
  
• 启动测试客户端进行测试

  python example_client.py