You need to enable JavaScript to run this app.
导航
模板鉴权
最近更新时间:2023.12.26 14:58:39首次发布时间:2023.04.14 16:41:38

本文将为您介绍有关为模板鉴权的原理说明、前提条件和操作步骤等,该配置主要用于图片模板中鉴权保护和链接失效保护。

原理说明

通过使用 HMAC-SHA1 算法、鉴权 key 作为参数对图片 URL 的 URI 部分生成签名,然后通过 Base64 URL Safe 对签名进行编码,最后将?sig=编码后的签名内容附于 URL 之后可得带签名信息的 URL。

生成签名信息 URL 示例说明

假设使用域名、模板、访问图片 Uri 拼接出来的 URL 如下图所示:

其中 URI 部分为 :/tos-img-cn-xxx.jpeg~tplv-example.image?(URI 结尾需要加上?)

则 URL 对应签名信息计算过程如下:

  1. 假设鉴权 key 为s1g2b755HYPeZZ4f,则首先计算的 URI 部分哈希值为:hash = HMAC_SHA1(URI, key)
  2. 然后使用 Base64 URL safe 编码 hash 信息为:hash_encoded = BASE64_URL(hash)
  3. 对应以上示例,得到的 hash_encoded 为:Ce1-ltwWKs_2vBifIbr5C41Y2d4=

最后把签名信息附于 URL 之后,得到的带签名信息的 URL 为:http://pic.example.com/tos-img-cn-xxx.jpeg~tplv-example.image?sig=Ce1-ltwWKs_2vBifIbr5C41Y2d4=

前提条件

  • 已完成新建服务
  • 确保您的服务为图像处理服务。

操作步骤

  1. 登录 veImageX 控制台,选择并进入服务管理

  2. 选择已创建的图像处理服务,并单击基础配置按钮,并进入该页面。

  3. 高级配置页签找到模板鉴权配置,单击修改按钮,设置主 KEY 和备 KEY。

    参数说明
    主 KEY自定义,不限制字符类型,长度范围在 8~32 字节
    备 KEY自定义,不限制字符类型,长度范围在 8~32 字节
  4. 单击保存按钮,保存当前配置。

OpenAPI

您可以通过调用 OpenAPI 更新模板鉴权配置,具体请参考 UpdateImageAuthKey