如何在扣子中配置对称加密与解密节点保护传输过程中的用户隐私

在扣子（Coze）工作流中处理用户隐私数据时，最核心的底线就是：数据在离开Bot执行环境之前必须完成加密，而且密钥绝不能硬编码在流程图里。否则，手机号、身份证号这些敏感信息一旦暴露在日志或调试缓存里，后果可想而知。下面直接进入实操——如何配置对称加密与解密节点，确保数据安全流转。

在扣子中启用对称加密保护用户输入数据

打开扣子工作台，进入目标Bot编辑页，点击「工作流」标签页，在画布空白处右键选择「添加节点」，搜索并拖入「对称加密」节点。

双击节点，关键一步来了：在「密钥来源」下拉菜单中

，千万别选“固定值”。点击右侧「+ 添加环境变量」，新建一个名为AES_KEY_256的变量，值为32字节随机字符串（比如Ux7v9qKm2RtFyBnGzWcLpHjD4sV8aXeN）。保存后这个变量会被自动隐藏，不会出现在调试面板里，安全系数直接拉满。

接着在「明文字段」输入框中填写上游节点输出的字段名，例如user_input.phone；「算法」保持默认的AES-256-CBC；别忘了勾选「Base64编码输出」——这一步跳过的话，后续HTTP请求体很可能因为二进制内容损坏而失败，这点坑已经有不少人踩过。

配置解密节点还原服务端可用数据

下游API接收到的是Base64编码的AES密文，必须在扣子工作流末端插入解密节点，确保交付给业务系统的仍是原始明文格式。

在加密节点下游拖入「对称解密」节点，双击打开设置。「密钥来源」同样选「环境变量」，输入与加密节点完全一致的变量名AES_KEY_256。「密文字段」填入加密节点的输出字段名，例如encrypt_output.ciphertext。「算法」严格匹配为AES-256-CBC，同时勾选「Base64解码输入」。

当需要兼容旧版服务或自定义填充向量时，可以拖入「代码」节点，语言选Python，粘贴以下代码：

import base64, json
from Crypto.Cipher import AES
from Crypto.Util.Padding import unpad

key = context.get_env("AES_KEY_256").encode()
ciphertext_b64 = context.get("encrypt_output.ciphertext")
ciphertext = base64.b64decode(ciphertext_b64)
iv = ciphertext[:16]
cipher = AES.new(key, AES.MODE_CBC, iv)
plaintext = unpad(cipher.decrypt(ciphertext[16:]), AES.block_size)
context.set("decrypted_data", plaintext.decode())

注意：

，否则运行时会报ModuleNotFoundError。进入「插件」→「Python依赖」→点击「+ 添加」，输入pycryptodome==3.19.0并保存。

验证加密链路是否生效

配置完成后，总得验证一下有没有生效。可以按以下步骤走：

第一步：在工作流起始处添加「调试」节点，输入{"phone": "13800138000"}模拟用户输入。

第二步：运行调试，观察加密节点输出字段ciphertext的值——应该是一长串Base64字符（长度约44字符起），而且每次相同输入生成的密文都不同（因为IV是随机的）。

第三步：检查解密节点输出字段decrypted_data或对应字段值，是否精确还原为"13800138000"，没有空格、换行或乱码。

第四步：在「网络」面板中查看HTTP请求载荷，确认发送至下游API的body内该字段已变为密文，而不是原始手机号。至此，整个加密链路才算真正跑通。