如何使用DynamoDB加密客户端(Item Encryptor)解密DynamoDB Stream?
解密DynamoDB Stream中加密记录的问题解法
问题复盘
- 已完成的基础验证:使用DynamoDB Encryption Client的Item Encryptor加密表记录后,通过
get_item接口直接读取记录,配合decrypt_python_item方法可正常解密,说明*crypto_config配置、密钥体系均无问题*。 - 遇到的核心报错:解密DynamoDB Stream事件携带的
NewImage数据时,先后出现两类报错:直接调用
decrypt_dynamodb_item时的报错:"errorMessage": "Invalid material description", "errorType": "InvalidMaterialDescriptionError"先通过
ddb_to_dict转换再解密时的报错:"errorMessage": "Value must be of the following types: <class 'bytearray'>, <class 'bytes'>.", "errorType": "TypeError"
问题根因
两类报错的本质来源是DynamoDB Stream返回的NewImage结构与decrypt_dynamodb_item方法的输入要求不匹配:
decrypt_dynamodb_item方法的设计输入是符合boto3 DynamoDB SDK返回规范的带类型标记的结构,其中二进制类型(B类)属性必须是原始bytes/bytearray类型。而DynamoDB Stream事件输出的原始NewImage中,所有二进制类型属性都是base64编码的字符串形式,直接传入会触发类型校验失败,也就是报“值必须为bytearray或bytes类型”的错误。- “无效材料描述”的报错,是因为DynamoDB Encryption Client默认会将表的主键作为加密上下文的组成部分,校验加密与解密环节的主键值一致性。如果直接传入未经过类型校验的NewImage结构,加密客户端无法正确解析到主键字段的类型与值,就会判定加密材料描述无效。
- 之前尝试使用
ddb_to_dict方法的方向存在偏差:ddb_to_dict的作用是把带类型标记的DynamoDB结构转换为无类型的普通Python字典,并不具备将无类型结构转换为DynamoDB原生结构的能力,转换后传入加密客户端自然会触发类型不匹配问题。
正确处理步骤
- 拿到Stream事件的
NewImage原始结构后,遍历所有属性,对标记为二进制类型(即带"B"键)的属性值,使用base64解码转换为原始bytes类型:import base64 def convert_stream_newimage(new_image: dict) -> dict: converted = {} for attr_name, attr_val in new_image.items(): # 处理二进制类型值,从base64字符串转成bytes if "B" in attr_val: converted[attr_name] = {"B": base64.b64decode(attr_val["B"])} else: converted[attr_name] = attr_val return converted - 确认转换后的结构中,完整保留了所有主键字段(场景中为
ID字段),且字段值没有被篡改——这是加密客户端校验加密上下文的必要条件。 - 将转换完成的DynamoDB结构传入
decrypt_dynamodb_item方法执行解密即可。
补充说明
如果希望走decrypt_python_item的解密流程,也可以在完成上述二进制值转换后,再通过ddb_to_dict把结构转成无类型的普通Python字典,配合加密客户端自带的解密配置完成解密,流程和直接从表读取记录解密的逻辑完全一致。
内容的提问来源于stack exchange,提问作者unreal-developer
相关产品推荐
相关产品推荐

