火山方舟
火山方舟
资源
请输入
- 文档首页
火山方舟安全管理推理会话数据应用层加密方案
复制全文
下载 pdf推理会话数据应用层加密方案
文档反馈
问问助手注意
为了保证推理会话数据的传输安全 ，在默认的网络层加密方案基础上，方舟安全团队为 在线推理的会话数据 提供了 端到端应用层加密 方案，支持用户通过 SDK 在本地对推理会话的内容进行加密。
为什么需要网络层和应用层的双层加密？请看这个形象的比喻：网络层的加密就像给文件加了一层保险盒，而应用层加密就如同再给保险盒上了一把锁，双重保险确保即便有人拦截了这个文件，也无从打开它。
方案介绍
会话数据应用层加密的具体流程，如下面的视频所示：
Replay
00:00
/
00:00
Live
Play
00:00
Fullscreen
Cssfullscreen
Click and hold to drag
用户可以依靠 SDK 在本地私域对推理会话内容进行加密，会话密文安全传输至沙箱后，仅在安全沙箱内存中解密成明文，用于模型推理。安全沙箱内的模型推理结束后，生成的推理结果会由安全沙箱加密，以密文的形式从安全沙箱传输至用户私域，最终由用户通过 SDK 在本地解密，获取明文推理结果。
使用说明
说明
- 语言情况：目前仅支持 Python SDK、Java SDK。
- 版本要求：
- Python SDK：需要保证 SDK 版本 volcengine-python-sdk 1.0.104及以上。参考升级 Python SDK获得 SDK 的最新版本。
- Java SDK：需要保证 SDK 版本 volcengine-java-sdk-ark-runtime 0.2.50及以上。参考升级 Java SDK获得 SDK 的最新版本。
- 三方支持：不支持三方 SDK ，包括 OpenAI SDK。
- 能力支持：仅支持火山方舟平台发布的文生文对话模型和 Doubao-vision 系列图片理解模型（注：图片仅支持 Base64 图片加密， URL 图片无法加密）请求，仅支持 Chat Completions 中的单轮/多轮会话，支持流式/非流式，同步/异步调用。
SDK 语言 | 功能说明 | 上线时间 |
Python | 1.0.104 正式支持应用层端到端加密能力 | 2024-10-10 |
Python | 1.0.111 更新 Cryptography 依赖版本至最新 | 2024-11-29 |
Python | 1.0.117 更新支持 Doubao-vision 系列模型请求 | 2024-12-23 |
Python | 1.0.119 支持 API-Key 请求证书，本地缓存证书 | 2025-01-02 |
Python | 1.0.121-125 暂不支持 AK/SK 获取证书 | 2025-01-16 |
Python | 1.0.126 优先使用 API-Key 获取证书 | 2025-02-27 |
Python | 3.0.3 支持 batch_chat API | 2025-05-22 |
Python | 3.0.15 Cryptography 最低支持版本为 42.0.0，对于chat api风控情况输出导致的解密 exception 的修复 | 2025-06-19 |
Python | 4.0.5 修复并发情况下本地证书目录冲突异常；修复会话加密情况下对 Chat 数据的内存修改 | 2025-07-10 |
Python | 2025-08-22 | |
Python | 4.0.16 缓存目录更新为当前用户的目录 | 2025-09-04 |
Python | 4.0.22 解决部分非流式请求结果解密失败问题 | 2025-09-25 |
Python | 4.0.25 解决部分非流式请求结果解密失败问题，TKS 加解密支持; batch chat加密功能暂时存在问题 | 2025-10-16 |
Python | 4.0.29 解决非流式请求结果解密失败问题 / batch chat 加密请求失败问题 | 2025-10-27 |
Python | 4.0.30 校验本地的数据是否是base64 / http / https URL | 2025-10-30 |
Java | 0.2.45 支持 API-Key 请求 Chat 接口进行加解密请求 | 2025-11-13 |
Java | 0.2.50 修复普通聊天请求对于 bouncycastle 软件包的依赖问题 | 2025-12-04 |
原理说明
用 Alice 和 Bob 分别代表客户 SDK 和推理模型所在的安全沙箱容器，基本原理是利用 ECIES 实现一个 0-RTT 协议（即让客户端在第一条消息中就发送加密的 Payload 的协议），协议如下：
- Alice 通过公开渠道获得 Bob 的公钥PK[Bob]，该公钥须是椭圆曲线公钥。
- Alice 生成随机数r ，通过和椭圆曲线基点相乘获得R = r × G，R为会话密钥的密文。会话密钥S = r × PK[Bob]，使用会话密钥S衍生密钥加密明文得到会话密文Payload。将(R, Payload)发送给 Bob。
- Bob 收到R后利用自己的私钥解密会话密钥SK[Bob] × R = SK[Bob] × r × G = S，使用S衍生密钥解密密文Payload得到会话明文。
验证说明
验证消息加密
动作：SDK 调用时，会对其中的 content 字段进行加密并使用 base64 编码。
验证：通过抓包工具的 HTTPS 抓包，查看请求体 body 中的会话数据是否是密文。
验证证书获取
动作：使用 AK/SK 初始化客户端 SDK ，每个推理接入点第一次请求会话数据应用层加密时，会调用 GetEndpointCertificate 接口，用于获取该接入点对应的证书。
证书说明
证书详情：
叶子证书信息：
中间根证书和根证书信息：
性能说明
在 Intel(R) Xeon(R) Platinum 8260 CPU ＠ 2.40GHz 单核情况下，按照消息长度 256 字节计算，一次对话请求的加解密额外耗时平均为 0.5786 ms。
最近更新时间：2026.07.07 18:03:11
这个页面对您有帮助吗？
有用
有用
无用
无用