全部产品
Search
文档中心

HTTPDNS:鉴权解析接口

更新时间:Oct 18, 2022

1. 背景

为了避免CC攻击刷费用问题对计费系统的影响,设计了HTTPDNS鉴权机制。

2. 鉴权方案

由于老用户已经发布了产品,采用的是非鉴权功能方式接入,这部分产品的用户需要继续可以访问非鉴权接口。

所以我们开放一个新的鉴权接口,产品新版本可以逐渐迁移至新接口,当旧app用户减少到一定量后,可以关闭非鉴权接口,以避免对计费系统的影响,如下图所示。

鉴权

2.1 老用户迁移方案

  • 关闭非鉴权接口,会导致老版本的存量正在使用产品的用户,无法访问HttpDNS服务。

  • 引导老用户更新版本,逐渐迁移至鉴权接口。

  • 非鉴权接口存量产品用户下降,直至可以接受关闭非鉴权接口带来的损失的时候,可以手动关闭非鉴权接口。

2.2 新用户使用方案

  • 为避免鉴权带来的额外接入成本,非鉴权接口默认是开启的。

  • 如果仅需要鉴权接口功能,请手动关闭非鉴权访问权限。

2.3 非鉴权接口开关的管理

  • 开启时,可能会引入安全隐患。

  • 只有关闭非鉴权接口开关时,才能避免被攻击导致的费用。

3. 签名生成和鉴权机制

3.1 签名生成算法及示例

新鉴权接口

重要
  • 其中的 {account_id} 需要替换为用户的HTTPDNS Account ID,在HTTPDNS控制台上可以获得这个ID。

  • 鉴权接口可以添加IP参数,是否添加该参数及参数内容不影响签名的计算。

签名算法

sign = md5sum( host-secret-timestamp )

鉴权字段说明

字段

描述

host

需要被解析的host,与URL中的host参数取同样的值。

secret

由服务器负责生成,查看方式:控制台 > 鉴权配置 > 鉴权secretkey。

timestamp

签名失效时间,1970年1月1日以来的秒数(整形正数,固定长度10)。

签名示例

此方案优缺点

  • 客户端时间不同

  • 密钥放在客户端丢失有风险

  • 无需去服务器拉取

3.2 鉴权响应

  • 鉴权成功时,HTTP响应的状态码为200,响应结果同原HTTPDNS响应。

  • 鉴权失败时,HTTP响应的状态码为403400,响应结果同时也返回具体的错误码,响应结果用JSON格式表示。

     { "code": "InvalidSignature" }

3.3 状态码说明

HTTP状态码

错误码

描述

403

SignatureExpired

时间戳已过期

403

InvalidSignature

签名不正确

400

InvalidDuration

签名有效期过长(最长86400秒)

400

InvalidSignature

签名格式不正确

400

InvalidTimestamp

时间戳格式不正确

400

AccountNotExists

账户不存在或被禁用