You need to enable JavaScript to run this app. 如何使用DynamoDB加密客户端(Item Encryptor)解密DynamoDB Stream?
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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原生结构的能力,转换后传入加密客户端自然会触发类型不匹配问题。

正确处理步骤

  1. 拿到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
    
  2. 确认转换后的结构中,完整保留了所有主键字段(场景中为ID字段),且字段值没有被篡改——这是加密客户端校验加密上下文的必要条件。
  3. 将转换完成的DynamoDB结构传入decrypt_dynamodb_item方法执行解密即可。

补充说明

如果希望走decrypt_python_item的解密流程,也可以在完成上述二进制值转换后,再通过ddb_to_dict把结构转成无类型的普通Python字典,配合加密客户端自带的解密配置完成解密,流程和直接从表读取记录解密的逻辑完全一致。


内容的提问来源于stack exchange,提问作者unreal-developer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 11:36:02