<h3 id="httpdnsAPI文档-API参考：">一、API接口</h3>
<ul>
<li>入口：<a class="external-link" href="http://dns.kangdbao.net/" rel="nofollow">dns.kangdbao.net</a></li>
<li>协议：支持HTTP/HTTPS协议</li>
</ul>
<h3>二、URL形式</h3>
<ul>
<li><a class="external-link" href="http://dns.kangdbao.net/sign_d?host=%s&amp;account_id=%s&amp;sign=%s&amp;t=%s&amp;ip=%s" rel="nofollow">http(s)://dns.kangdbao.net/sign_d?host=%s&amp;account_id=%s&amp;sign=%s&amp;t=%s&amp;ip=%s</a></li>
<li>HTTP GET请求</li>
</ul>
<h3 id="httpdnsAPI文档-请求参数说明：">三、请求参数说明</h3>
<table class="relative-table confluenceTable tablesorter tablesorter-default stickyTableHeaders">
<thead class="tableFloatingHeaderOriginal">
<tr class="tablesorter-headerRow">
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="0">
<div class="tablesorter-header-inner">
<p>参数</p>
</div>
</th>
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="1">
<div class="tablesorter-header-inner">
<p>含义</p>
</div>
</th>
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="2">
<div class="tablesorter-header-inner">
<p>必填</p>
</div>
</th>
</tr>
</thead>
<tbody>
<tr>
<td class="confluenceTd"><strong>host</strong></td>
<td class="confluenceTd"><strong>待查询的域名</strong></td>
<td class="confluenceTd"><b>Y</b></td>
</tr>
<tr>
<td class="confluenceTd"><strong>account_id</strong></td>
<td class="confluenceTd"><strong>md5sum格式账户id，如“21de58ae91bf3ab77e32aeb8fae95291”</strong></td>
<td class="confluenceTd"><b>Y</b></td>
</tr>
<tr>
<td class="confluenceTd" colspan="1"><strong>t</strong></td>
<td class="confluenceTd" colspan="1"><strong>鉴权签名失效时间，最大为now()+600，如&#8221;1576468800&#8243;</strong></td>
<td class="confluenceTd" colspan="1"><b>Y</b></td>
</tr>
<tr>
<td class="confluenceTd" colspan="1"><strong>sign</strong></td>
<td class="confluenceTd" colspan="1"><strong>鉴权签名，sign = md5sum(&#8220;host-secret-t&#8221;)</strong></td>
<td class="confluenceTd" colspan="1"><b>Y</b></td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">out</td>
<td class="confluenceTd" colspan="1">输出格式，可选json、text，默认为json</td>
<td class="confluenceTd" colspan="1">N</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">ip</td>
<td class="confluenceTd" colspan="1">发起edns请求的ip，不填则为客户端真实ip（仅支持IPv4格式）</td>
<td class="confluenceTd" colspan="1">N</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">qtype</td>
<td class="confluenceTd" colspan="1">查询记录的类型，可选A、AAAA默认为A</td>
<td class="confluenceTd" colspan="1">N</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">ttl</td>
<td class="confluenceTd" colspan="1">输出包含ttl，可选1、0，默认为0不输出ttl</td>
<td class="confluenceTd" colspan="1">N</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">encrypt</td>
<td class="confluenceTd" colspan="1">响应包体是否加密，可选1、0，默认为0即不对响应包体加密</td>
<td class="confluenceTd" colspan="1">N</td>
</tr>
</tbody>
</table>
<ul>
<li>account_id：系统为用户随机生成的唯一id，为md5sum格式，如&#8221;21de58ae91bf3ab77e32aeb8fae95291&#8243;</li>
<li>t：鉴权签名失效时间，为1970年1月1日以来的秒数，最大值为now()+600。如t=1576468800表示签名在2019-12-16 12:00:00过期。</li>
<li>sign：鉴权签名。sign = md5sum(&#8220;host-secret-t&#8221;)。对于host=<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>，secret=oB1q6EF8rGUpd1qxBtcm，t=1576468800的情况，sign=md5sum(&#8220;<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>-oB1q6EF8rGUpd1qxBtcm-1576468800&#8243;)，则sign取值为1f8c93f4853b8a9cc179b54ea7e0e2f6。secret是系统为用户随机生成长度为20的密钥，每个用户最多存在两个密钥。</li>
<li>encrypt：encrypt为1时，响应包体以 <a class="external-link" href="https://gitlab.intra.knownsec.com/jiasule/jsl-httpdns/merge_requests/5" rel="nofollow">AES-256-ECB</a>方式进行加密，加密密钥与请求的签名密钥相同，签名密钥为20字符，加密时使用pkcs7padding的16字节方式对密钥进行补齐，即加密密钥从20个字符填充到32个字符。</li>
</ul>
<h3 id="httpdnsAPI文档-响应格式：" class="p1">四、响应格式</h3>
<ul>
<li class="p1">json格式</li>
</ul>
<ol>
<li>查询成功返回格式：{&#8220;ipsv6&#8221;:[&#8220;2408:8741:0:1:0:0:0:27&#8243;],&#8221;ttl&#8221;:144,&#8221;host&#8221;:&#8221;<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>&#8220;}</li>
<li>未查询到结果返回格式：{}</li>
<li class="p1">请求错误返回格式：{&#8220;code&#8221;:&#8221;SignatureExpired&#8221;}</li>
</ol>
<div class="table-wrap"></div>
<div class="table-wrap">
<table class="relative-table confluenceTable tablesorter tablesorter-default stickyTableHeaders">
<colgroup>
<col />
<col /></colgroup>
<thead class="tableFloatingHeaderOriginal">
<tr class="tablesorter-headerRow">
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="0">
<div class="tablesorter-header-inner">参数</div>
</th>
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="1">
<div class="tablesorter-header-inner">含义</div>
</th>
</tr>
</thead>
<tbody>
<tr>
<td class="confluenceTd">host</td>
<td class="confluenceTd">查询的域名</td>
</tr>
<tr>
<td class="confluenceTd">ttl</td>
<td class="confluenceTd">该域名解析结果的TTL缓存时间</td>
</tr>
<tr>
<td class="confluenceTd">ips/ipsv6</td>
<td class="confluenceTd">解析到的A/AAAA记录</td>
</tr>
</tbody>
</table>
</div>
<ul>
<li> text格式</li>
</ul>
<ol>
<li class="p1">查询成功返回格式：183.212.96.233,111.212.98.126;187（多个地址使用&#8221;,&#8221;分割，ttl使用&#8221;;&#8221;分割）</li>
<li class="p1">未查寻到结果返回格式：null</li>
<li class="p1">请求错误返回格式：{&#8220;code&#8221;:&#8221;SignatureExpired&#8221;}</li>
</ol>
<h3 id="httpdnsAPI文档-状态码：" class="p1">五、状态码</h3>
<div class="table-wrap">
<table class="relative-table confluenceTable tablesorter tablesorter-default stickyTableHeaders">
<colgroup>
<col />
<col />
<col /></colgroup>
<thead class="tableFloatingHeaderOriginal">
<tr class="tablesorter-headerRow">
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="0">
<div class="tablesorter-header-inner">
<p>状态码</p>
</div>
</th>
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="1">
<div class="tablesorter-header-inner">
<p>HTTP状态码</p>
</div>
</th>
<th class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" tabindex="0" scope="col" data-column="2">
<div class="tablesorter-header-inner">
<p>描述</p>
</div>
</th>
</tr>
</thead>
<tbody>
<tr>
<td class="confluenceTd">MissingArgument</td>
<td class="confluenceTd">403</td>
<td class="confluenceTd">缺少必要参数</td>
</tr>
<tr>
<td class="confluenceTd">InvalidParam</td>
<td class="confluenceTd">403</td>
<td class="confluenceTd">参数格式不合法</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">InvalidSignature</td>
<td class="confluenceTd" colspan="1">403</td>
<td class="confluenceTd" colspan="1">签名校验错误</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">SignatureExpired</td>
<td class="confluenceTd" colspan="1">403</td>
<td class="confluenceTd" colspan="1">签名时间戳过期</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">DnNotInWhitelist</td>
<td class="confluenceTd" colspan="1">403</td>
<td class="confluenceTd" colspan="1">域名不在用户白名单内</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">InvalidAccountId</td>
<td class="confluenceTd" colspan="1">403</td>
<td class="confluenceTd" colspan="1">账户id不存在</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">InvalidUrlPath</td>
<td class="confluenceTd" colspan="1">404</td>
<td class="confluenceTd" colspan="1">请求路径不存在</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">MethodNotAllowed</td>
<td class="confluenceTd" colspan="1">405</td>
<td class="confluenceTd" colspan="1">不支持的HTTP方法</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">AccessRestricted</td>
<td class="confluenceTd" colspan="1">503</td>
<td class="confluenceTd" colspan="1">请求过于频繁或并发连接数过多被拒绝</td>
</tr>
<tr>
<td class="confluenceTd" colspan="1">InternalError</td>
<td class="confluenceTd" colspan="1">500</td>
<td class="confluenceTd" colspan="1">服务端内部错误</td>
</tr>
</tbody>
</table>
</div>
<h3>六、使用示例</h3>
<ul>
<li>常规使用示例</li>
</ul>
<div class="table-wrap">
<table class="confluenceTable">
<colgroup>
<col /></colgroup>
<tbody>
<tr>
<td class="confluenceTd">
<pre># -*- coding:utf-8 -*-
import requests
import time
import hashlib

ip = "1.2.3.4"
host = "<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>"
secret = "oB1q4EF8rGUpd2qxBtcm"
expiration_time = str(int(time.time())+600)
account_id = "7cf125ce0190b2fe2bb6bbb6ab386c15"
sign_str = host + "-" + secret + "-" + expiration_time
sign = hashlib.md5(sign_str.encode(encoding='UTF-8')).hexdigest()
url_tmp = "<a class="external-link" href="http://dns.kangdbao.net/sign_d?host=%s&amp;account_id=%s&amp;sign=%s&amp;t=%s&amp;ip=%s" rel="nofollow">http://dns.kangdbao.net/sign_d?host=%s&amp;account_id=%s&amp;sign=%s&amp;t=%s&amp;ip=%s</a>"
uri = url_tmp % (host, account_id, sign, expiration_time, ip)
r = requests.get(uri)
print(r.text)
-------------------------------------------------------------------------------------------------------
output:
{"host":"<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>","ips":["111.212.98.126","122.218.238.112"]}</pre>
</td>
</tr>
</tbody>
</table>
</div>
<ul>
<li>响应加密示例</li>
</ul>
<pre>encrypt==1时，响应包体使用<a class="external-link" href="https://gitlab.intra.knownsec.com/jiasule/jsl-httpdns/merge_requests/5" rel="nofollow">AES-256-ECB</a>方式加密，同时包体也使用pkcs7padding的16字节方式对齐。由于加密后的密文不都是可打印的，所以响应包体是由密文转换而来的16进制字符串，转换过程中每个密文字节由两个十六进制字符表示，如密文为"0123456789abcdef"则转换为十六进制字符串后为"30313233343536373839414243444546"。因此解密时需要先将十六进制字符串响应包体转换为原始密文。</pre>
<div class="table-wrap">
<table class="confluenceTable">
<colgroup>
<col /></colgroup>
<tbody>
<tr>
<td class="confluenceTd">
<pre># -*- coding:utf-8 -*-
import re
import requests
import time
import hashlib
from Crypto.Cipher import AES

ip = "1.2.3.4"
host = "www.yunaq.com"
secret = "TQ3hq6bkp5gmbXNJOJ13"
expiration_time = str(int(time.time())+600)
account_id = "48c1a96381fbcad1e63c435a44d52713"
sign_str = host + "-" + secret + "-" + expiration_time
sign = hashlib.md5(sign_str.encode(encoding='UTF-8')).hexdigest()
url_tmp = "http://dns.kangdbao.net/sign_d?host=%s&amp;account_id=%s&amp;sign=%s&amp;t=%s&amp;ip=%s&amp;encrypt=1"

def hex2str(s):
    hex_list = re.findall(r'.{2}', s)  # 按两个字符切分
    return ''.join([chr(int(i, 16)) for i in hex_list])

# pkcs7填充，block_size为16
def pkcs7_padding(text):
    amount_to_pad = 16 - (len(text) % 16)

    if amount_to_pad == 0:
        amount_to_pad = 16
    pad = chr(amount_to_pad)
    return text + pad * amount_to_pad

uri = url_tmp % (host, account_id, sign, expiration_time, ip)
r = requests.get(uri)
if r.status_code != 200:
    print(r.text)
    exit()

# 将密钥填充到32个字符,即使用AES-256
key = pkcs7_padding(secret)
aes = AES.new(str.encode(key), AES.MODE_ECB)
encrypted_text = hex2str(r.text)
decrypted_text = aes.decrypt(encrypted_text)
# 去除pkcs7填充的字符
amount_to_pad = ord(decrypted_text[-1])
res = decrypted_text[0:0-amount_to_pad]
print(res)
-------------------------------------------------------------------------------------------------------、
output:
{"host":"<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>","ips":["121.212.98.126","122.218.38.112"]}</pre>
</td>
</tr>
</tbody>
</table>
</div>
<h3 id="httpdnsAPI文档-请求实例：">七、实例演示</h3>
<p>请求：<a class="external-link" href="http://127.0.0.1/sign_d?host=www.yunaq.com&amp;account_id=123456&amp;t=1576468800&amp;sign=1f8c93f4853b8a9cc179b54ea7e0e2f6&amp;ip=192.168.12.4" rel="nofollow">http://</a><a class="external-link" href="http://dns.kangdbao.net/sign_d?host=%s&amp;account_id=%s&amp;sign=%s&amp;t=%s&amp;ip=%s" rel="nofollow">dns.kangdbao.net</a><a class="external-link" href="http://127.0.0.1/sign_d?host=www.yunaq.com&amp;account_id=123456&amp;t=1576468800&amp;sign=1f8c93f4853b8a9cc179b54ea7e0e2f6&amp;ip=192.168.12.4" rel="nofollow">/sign_d?host=www.yunaq.com&amp;account_id=21de58ae91bf3ab77e32aeb8fae95291&amp;t=1576468800&amp;sign=1f8c93f4853b8a9cc179b54ea7e0e2f6&amp;ip=192.168.12.4</a></p>
<p class="p1">响应：{&#8220;host&#8221;:&#8221;<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>&#8220;,&#8221;ips&#8221;:[&#8220;122.218.238.109&#8243;,&#8221;183.212.96.249&#8221;]}</p>
<p class="p1">请求：<a class="external-link" href="http://dns.kangdbao.net/sign_d?host=www.yunaq.com&amp;account_id=7cf115ce0790b2fe2bb6bbb6ab486c45&amp;sign=6826ac4c4d9031d07607e8ea44e762ef&amp;t=1577254142&amp;qtype=AAAA&amp;ttl=1" rel="nofollow">http://dns.kangdbao.net/sign_d?host=www.yunaq.com&amp;account_id=21de58ae91bf3ab77e32aeb8fae95291&amp;sign=6826ac4c4d9031d07607e8ea44e762ef&amp;t=1577254142&amp;qtype=AAAA&amp;ttl=1</a></p>
<p class="p1">响应：{&#8220;ipsv6&#8221;:[&#8220;2308:871c:0:1:0:0:0:27&#8243;],&#8221;ttl&#8221;:144,&#8221;host&#8221;:&#8221;<a class="external-link" href="http://www.yunaq.com/" rel="nofollow">www.yunaq.com</a>&#8220;}</p>
<h3><strong>八、注意事项</strong></h3>
<ul>
<li>httpdns会缓存查询结果，当用户更新httpdns的相关配置如密钥或根域名时，最长需要等待2分钟才能生效。</li>
<li>当前仅支持IPv4客户端接入。</li>
</ul>


一、API接口 入口：dns.kangdbao.net 协议：支持HTTP/HTTPS协议 二、URL形式 h [&#8230;]

HTTPDNS API文档

<p style="text-align:start;text-indent:2em;">为保障客户业务系统安全，知道创宇云安全会实时对黑客攻击行业进行识别阻断。在实际运营中，我们发现部分第三方服务提供商由于请求频率、行为、特征不符合标准HTTP规范要求，而会被知道创宇防御引擎阻断拦截，从而影响业务，这其中可能涉及支付公司、API服务商、监控平台等。</p><p style="text-align:start;text-indent:2em;">考虑到客户实际需求，上述厂商，如果您的业务受到影响，可通过以下方式向知道创宇云安全发起全局白名单申请。</p><p style="text-align:start;text-indent:2em;">厂商请以公函形式向我们发起申请，申请内容应至少包括以下内容：</p><p style="text-align:start;text-indent:2em;">1、涉及到申请加白的IP地址列表。</p><p style="text-align:start;text-indent:2em;">2、IP地址用途说明，并附至少1例拦截样例，包括被阻断的IP地址、时间、触发拦截的URL地址、现象（403阻断、IP封禁）等。</p><p style="text-align:start;text-indent:2em;">3、预计上述IP用作上述用途的截止时间。</p><p style="text-align:start;text-indent:2em;">4、厂商应承诺遵守《网络安全法》等法律法规规定，不得利用IP白名单对知道创宇用户发起任何形式的攻击。如涉嫌危害用户安全或涉嫌违法，知道创宇有权将上述IP白名单移除，并由厂商承担因此造成的一切损失与责任。</p><p style="text-align:start;text-indent:2em;">5、联系方式（联系人、电话）</p><p style="text-align:start;text-indent:2em;">6、加盖公司公章。</p><p style="text-align:start;text-indent:2em;">请以公司身份，将申请厂商营业执照电子版及公函发送至 zxyy@knownsec.com 。如因客户安全需求，自行开通了知道创宇云安全高级防护策略，造成的拦截，知道创宇将不会给予加白。</p><p style="text-align:start;text-indent:2em;">如果涉及知道创宇用户较少，厂商可以直接联系客户，在知道创宇云安全控制面板中自行添加针对本网站的白名单即可。</p>

为保障客户业务系统安全，知道创宇云安全会实时对黑客攻击行业进行识别阻断。

知道创宇云安全全局IP白名单申请流程

<p>净网盾共包含8类词库：反动类、涉黑类、涉黄类、暴恐类、博彩类、民生类、其他类，以下为查看这八类词库释义的方法。</p>
<p>操作步骤：（截图以谷歌浏览器为例，其他浏览器操作类似）</p>
<ol>
<li>登录【知道创宇云防御平台】后，在页面顶部的导航栏中，单击【控制台】按钮，进入控制台首页。</li>
<li>在页面顶部的导航栏中，将鼠标悬停在【产品控制面板】按钮上，弹出下拉菜单。</li>
<li>在下拉菜单中单击【净网盾】，进入净网盾功能配置页面，如下图所示。<img class="alignnone  wp-image-2048" src="http://help.yunaq.com/wp-content/uploads/2020/07/1.png" alt="" width="916" height="462" srcset="http://help.yunaq.com/wp-content/uploads/2020/07/1.png 1919w, http://help.yunaq.com/wp-content/uploads/2020/07/1-300x151.png 300w, http://help.yunaq.com/wp-content/uploads/2020/07/1-768x387.png 768w, http://help.yunaq.com/wp-content/uploads/2020/07/1-1024x516.png 1024w, http://help.yunaq.com/wp-content/uploads/2020/07/1-60x30.png 60w, http://help.yunaq.com/wp-content/uploads/2020/07/1-150x76.png 150w" sizes="(max-width: 916px) 100vw, 916px" /></li>
<li>在下拉框中选择任意域名和主机名。</li>
<li>在【页面内容监测】或【上传内容监测】的设置框中单击【词库设置】后的【修改】按钮，如图所示。<img class="alignnone  wp-image-2049" src="http://help.yunaq.com/wp-content/uploads/2020/07/2.png" alt="" width="905" height="455" srcset="http://help.yunaq.com/wp-content/uploads/2020/07/2.png 1918w, http://help.yunaq.com/wp-content/uploads/2020/07/2-300x151.png 300w, http://help.yunaq.com/wp-content/uploads/2020/07/2-768x386.png 768w, http://help.yunaq.com/wp-content/uploads/2020/07/2-1024x515.png 1024w, http://help.yunaq.com/wp-content/uploads/2020/07/2-60x30.png 60w, http://help.yunaq.com/wp-content/uploads/2020/07/2-150x75.png 150w" sizes="(max-width: 905px) 100vw, 905px" /></li>
<li>进入词库设置界面后，将鼠标悬停在每类词库名称后面的“？”图标上，即可查看该类词库释义。</li>
</ol>


净网盾共包含8类词库：反动类、涉黑类、涉黄类、暴恐类、博彩类、民生类、其他类，以下为查看这八类词库释义的方法。 [&#8230;]

热门搜索词

热门文章

知道创宇云安全全局IP白名单申请流程

HTTPDNS API文档

如何查看词库释义

关注知道创宇云安全

完善信息下载白皮书

热门搜索词

热门文章

知道创宇云安全全局IP白名单申请流程

HTTPDNS API文档

如何查看词库释义

关注知道创宇云安全