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

原理说明

通过使用 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。