开发者指南

API 文档

SDK 文档

服务端加密概述

最近更新时间:2020-07-30 18:33:20

概述

对象存储 COS 在数据写入数据中心内的磁盘之前,支持在对象级别上应用数据加密的保护策略,并在访问数据时自动解密。加密和解密这一操作过程都是在服务端完成,这种服务端加密功能可以有效保护静态数据。

注意:

  • 访问加密对象与访问未加密的对象在体验上并无差别,但前提是用户已拥有对象的访问权限。
  • 服务端加密仅加密对象数据而不加密对象元数据,而且使用服务端加密的对象必须使用有效签名访问,不可被匿名用户访问。

适用场景

  • 私密数据存储场景:对于私密数据的存储,服务端加密可以对存储的数据进行加密,保证用户的隐私,用户访问时会自动解密。
  • 私密数据传输场景:对于私密数据的传输,COS 提供用 HTTPS 部署 SSL 证书实现加密的功能,在传输链路层上建立加密层,确保数据在传输过程中不会被窃取及篡改。

加密方式

COS 支持多种服务端加密方式:SSE-COS、SSE-KMS、SSE-C。用户可以自行选择合适的加密方式对存放到 COS 中的数据进行加密。

SSE-COS 加密

SSE-COS 加密即 COS 托管密钥的服务端加密。由腾讯云 COS 托管主密钥和管理数据。用户通过 COS 直接对数据进行管理和加密。SSE-COS 采用了多因素强加密,确保使用唯一的密钥加密每个对象,同时采用 256 位高级加密标准(即 AES-256)来加密数据,并且会通过定期轮换的主密钥来对密钥本身进行加密。

注意:

  • 当使用POST操作上传对象时,需在表单字段中提供相同的信息,而不是提供 x-cos-server-side-encryption 头部。详情请参见 POST Object
  • 对于使用预签名 URL 上传的对象,则无法使用 SSE-COS 加密。只能使用 COS 控制台或 HTTP 请求头部指定服务端加密。

使用对象存储控制台

用户可以参见 设置对象加密 控制台文档,了解如何通过控制台对对象进行 SSE-COS 加密。

使用 REST API

注意:

  • 在列出存储桶中对象时,列表会返回所有对象的列表,无论对象是否加密。
  • 当使用 POST 操作上传对象时,请在表单字段中提供相同的信息,而不是提供该请求头部,详情请参见 POST Object

当用户请求以下接口时,可以通过提供 x-cos-server-side-encryption 头部来应用服务端加密,详情请参见 公共请求头部 - SSE-COS

SSE-KMS 加密

SSE-KMS 加密即使用 KMS 托管密钥的服务端加密。KMS 是腾讯云推出的一款安全管理类服务,使用经过第三方认证的硬件安全模块 HSM(Hardware Security Module)来生成和保护密钥。它能够帮助用户轻松创建和管理密钥,满足用户多应用多业务的密钥管理需求以及满足监管和合规要求。

首次使用 SSE-KMS 加密,需要 开通 KMS 服务,开通 KMS 服务后,系统会自动为您创建一个默认主密钥(CMK)。您也可以通过 KMS 控制台 自主创建密钥,定义密钥策略及使用方法,KMS 支持用户自主选择密钥材料来源为 KMS外部,更多信息请参见 创建密钥外部密钥导入

注意:

  • SSE-KMS 仅加密对象数据,不会加密任何对象元数据。
  • 目前 SSE-KMS 仅支持北京、上海、广州地域。
  • 使用 SSE-KMS 加密,会产生额外费用,由 KMS 收取,详情请参见 KMS 计费概述

使用对象存储控制台

用户可以参见 设置对象加密 控制台文档,了解如何通过控制台对对象进行 SSE-KMS 加密。

使用 REST API

注意:

  • 在列出存储桶中对象时,列表会返回所有对象的列表,无论对象是否加密。
  • 当使用 POST 操作上传对象时,请在表单字段中提供相同的信息,而不是提供该请求头部,详情请参见 POST Object

当用户请求以下接口时,可以通过提供 x-cos-server-side-encryption 头部来应用服务端加密,详情请参见 公共请求头部 - SSE-KMS

注意事项

若您未使用过 COS 控制台进行 SSE-KMS 加密,而只使用 API 的方式进行 SSE-KMS 加密时,您需先创建 CAM 角色,具体创建步骤如下:

  1. 登录访问管理控制台,进入 角色 列表页面。
  2. 单击【新建角色】,选择角色载体为【腾讯云产品服务】。
  3. 选择支持角色的服务为【对象存储】,然后单击【下一步】。
  4. 配置角色策略,搜索并勾选【QcloudKMSCreaterFullAccess】,然后单击【下一步】。
  5. 输入指定角色名称:COS_QcsRole。
  6. 最后单击【完成】即可创建完毕。

SSE-C 加密

SSE-C 加密即用户自定义密钥的服务端加密。加密密钥由用户自己提供,用户在上传对象时,COS 将使用用户提供的加密密钥对用户的数据进行 AES-256 加密。

注意:

  • COS 不存储用户提供的加密密钥,而是存储加密密钥添加了随机数据的 HMAC 值,该值用于验证用户访问对象的请求。COS 无法使用随机数据的 HMAC 值来推导出加密密钥的值或解密加密对象的内容。因此,如果用户丢失了加密密钥,则无法再次获取到该对象。
  • 当使用 POST 操作上传对象时,需在表单字段中提供相同的信息,而不是提供x-cos-server-side-encryption-* 头部。详情请参见 POST Object
  • SSE-C 仅能通过 API 进行使用,不支持控制台操作。

使用 REST API

当用户请求以下接口时,对于 PUT 和 POST 请求可以通过提供x-cos-server-side-encryption-*头部来应用服务端加密,对于 GET 和 HEAD 请求使用 SSE-C 加密的对象时,需要提供x-cos-server-side-encryption-*头部来解密指定对象,详情请参见 公共请求头部 - SSE-C。以下操作支持此头部:

目录