<p>一、CNAME接入方式介绍</p>
<p style="padding-left: 30px;">CNAME接入是一种同时通过域名解析服务商和云防御DNS的双重域名解析方式，生效速度快，一般10-20分钟生效（具体生效时间由域名DNS解析商处配置的原TTL时间决定），此方式接入操作简单。特别是正在被攻击需要紧急接入的网站，推荐使用此方式接入。</p>
<p>二、添加域名入口</p>
<p style="padding-left: 30px;">登陆后进入【域名管理】-【域名列表】-【添加域名】，也可通过 <a class="external-link" href="https://defense.yunaq.com/site/list/?f=s" rel="nofollow">https://defense.yunaq.com/site/list/?f=s</a>直接进入。</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3642" src="http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名.png" alt="" width="1918" height="255" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名.png 1918w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名-300x40.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名-768x102.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名-1024x136.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名-60x8.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-添加域名-150x20.png 150w" sizes="(max-width: 1918px) 100vw, 1918px" /></p>
<p>三、接入操作步骤</p>
<p style="padding-left: 30px;">1、输入根域名，选择“CNAME方式接入”，点击【添加域名】。</p>
<p style="padding-left: 30px;"><img class="wp-image-2660 size-full aligncenter" src="http://help.yunaq.com/wp-content/uploads/2021/03/1.png" alt="" width="1659" height="696" srcset="http://help.yunaq.com/wp-content/uploads/2021/03/1.png 1659w, http://help.yunaq.com/wp-content/uploads/2021/03/1-300x126.png 300w, http://help.yunaq.com/wp-content/uploads/2021/03/1-768x322.png 768w, http://help.yunaq.com/wp-content/uploads/2021/03/1-1024x430.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/03/1-60x25.png 60w, http://help.yunaq.com/wp-content/uploads/2021/03/1-150x63.png 150w" sizes="(max-width: 1659px) 100vw, 1659px" /></p>
<p style="padding-left: 30px;">⚠️  未备案的域名只能使用NS方式接入。</p>
<p style="padding-left: 30px;">2、点击【完成向导】，进入子域名列表。点击【添加子域名】进行配置，可按需选择单个添加或批量添加方式。</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3643" src="http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导.png" alt="" width="1701" height="289" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导.png 1701w, http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导-300x51.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导-768x130.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导-1024x174.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导-60x10.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/cnamr接入-完成向导-150x25.png 150w" sizes="(max-width: 1701px) 100vw, 1701px" /></p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3644" src="http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名.png" alt="" width="1711" height="384" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名.png 1711w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名-300x67.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名-768x172.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名-1024x230.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名-60x13.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/cname接入-完成向导-添加子域名-150x34.png 150w" sizes="(max-width: 1711px) 100vw, 1711px" /></p>
<p style="padding-left: 30px;">2.1.单个添加。</p>
<p style="padding-left: 30px;">在添加子域名弹窗中，填写所需信息，若对所要填写的内容有疑问，可点击”？”查看相关帮助，添加完成后可以在列表右侧的【修改】中修改填写信息。</p>
<p style="padding-left: 30px;">注：a.云防御平台支持泛域名接入，即在主机名处填写*；</p>
<p style="padding-left: 64px;">b.若要添加根域名，主机名需填写@。</p>
<p style="padding-left: 30px;"><img class="size-full wp-image-2662 aligncenter" src="http://help.yunaq.com/wp-content/uploads/2021/03/3.jpg" alt="" width="658" height="560" srcset="http://help.yunaq.com/wp-content/uploads/2021/03/3.jpg 658w, http://help.yunaq.com/wp-content/uploads/2021/03/3-300x255.jpg 300w, http://help.yunaq.com/wp-content/uploads/2021/03/3-60x51.jpg 60w, http://help.yunaq.com/wp-content/uploads/2021/03/3-150x128.jpg 150w" sizes="(max-width: 658px) 100vw, 658px" /></p>
<p style="padding-left: 30px;">2.2. 批量添加。</p>
<p style="padding-left: 30px;">点击【批量添加】按钮进入批量添加页面，点击【选择文件】导入（若已存在子域名配置，可将现有配置导出至本地进行补充后再上传），添加完成后点击【继续导入】，则回到第一步选择文件上传，点击【域名列表】则回到域名列表页面。</p>
<p style="padding-left: 30px;"><img class="size-large wp-image-2664 aligncenter" src="http://help.yunaq.com/wp-content/uploads/2021/03/1-1024x249.jpg" alt="" width="980" height="238" srcset="http://help.yunaq.com/wp-content/uploads/2021/03/1-1024x249.jpg 1024w, http://help.yunaq.com/wp-content/uploads/2021/03/1-300x73.jpg 300w, http://help.yunaq.com/wp-content/uploads/2021/03/1-768x187.jpg 768w, http://help.yunaq.com/wp-content/uploads/2021/03/1-60x15.jpg 60w, http://help.yunaq.com/wp-content/uploads/2021/03/1-150x36.jpg 150w" sizes="(max-width: 980px) 100vw, 980px" /></p>
<p style="padding-left: 30px;">3、域名验证。</p>
<p style="padding-left: 30px;">域名添加完成后，点击【下一步，域名验证】。</p>
<p style="padding-left: 30px;"><img class="size-large wp-image-2665 aligncenter" src="http://help.yunaq.com/wp-content/uploads/2021/03/2-1-1024x334.png" alt="" width="980" height="320" srcset="http://help.yunaq.com/wp-content/uploads/2021/03/2-1-1024x334.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/03/2-1-300x98.png 300w, http://help.yunaq.com/wp-content/uploads/2021/03/2-1-768x250.png 768w, http://help.yunaq.com/wp-content/uploads/2021/03/2-1-60x20.png 60w, http://help.yunaq.com/wp-content/uploads/2021/03/2-1-150x49.png 150w" sizes="(max-width: 980px) 100vw, 980px" /></p>
<p style="padding-left: 30px;">域名归属验证有两种方法，分别是【挂标验证】和【TXT验证】，任选一种方式进行验证即可。知道创宇提供了两种挂标样式，可复制代码至目标网站，挂标完成后可激活域名。</p>
<p style="padding-left: 30px;">添加挂标代码后，如因网络原因超时无法获取挂标验证，请选择TXT验证方式，可以在第二排文字中【查看修改图解】。</p>
<p style="padding-left: 30px;"><img class="size-large wp-image-2666 aligncenter" src="http://help.yunaq.com/wp-content/uploads/2021/03/1-1-1024x408.png" alt="" width="980" height="390" srcset="http://help.yunaq.com/wp-content/uploads/2021/03/1-1-1024x408.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/03/1-1-300x119.png 300w, http://help.yunaq.com/wp-content/uploads/2021/03/1-1-768x306.png 768w, http://help.yunaq.com/wp-content/uploads/2021/03/1-1-60x24.png 60w, http://help.yunaq.com/wp-content/uploads/2021/03/1-1-150x60.png 150w" sizes="(max-width: 980px) 100vw, 980px" /></p>
<p style="padding-left: 30px;"><img class="size-large wp-image-2667 aligncenter" src="http://help.yunaq.com/wp-content/uploads/2021/03/1-2-1024x343.png" alt="" width="980" height="328" srcset="http://help.yunaq.com/wp-content/uploads/2021/03/1-2-1024x343.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/03/1-2-300x101.png 300w, http://help.yunaq.com/wp-content/uploads/2021/03/1-2-768x258.png 768w, http://help.yunaq.com/wp-content/uploads/2021/03/1-2-60x20.png 60w, http://help.yunaq.com/wp-content/uploads/2021/03/1-2-150x50.png 150w" sizes="(max-width: 980px) 100vw, 980px" /></p>
<p style="padding-left: 30px;">4、修改DNS解析。</p>
<p style="padding-left: 30px;">域名验证完成后点击【立即接入】完成域名接入，子域名列表中将显示CNAME别名地址用于修改解析记录。此时需登陆域名解析服务商管理页面将对应子域名通过CNAME方式解析到生成的别名地址。</p>
<p style="padding-left: 30px;">腾讯云修改DNS解析可参考：<a href="http://help.yunaq.com/faq/2755/index.html">http://help.yunaq.com/faq/2755/</a><a href="http://help.yunaq.com/faq/2761/index.html">index.html</a></p>
<p style="padding-left: 30px;">阿里云修改DNS解析可参考： <a href="http://help.yunaq.com/faq/2744/index.html">http://help.yunaq.com/faq/2744/</a><a href="http://help.yunaq.com/faq/2761/index.html">index.html</a></p>
<p style="padding-left: 30px;">其他厂商建议参考官方指导配置：【<a href="http://www.xinnet.com/service/cjwt/domain/guanli/1164.html">新华xinnet</a>】、【<a href="https://sg.godaddy.com/zh/help/domains-1000003#nav-7">Godaddy</a>】、【<a href="https://help.now.cn/domain/">时代互联</a>】、【<a href="https://www.22.cn/service_20.html">爱名网</a>】、【<a href="http://www.com.top/productfaq/post/90.html">中国数据</a>】、【<a href="https://help.zzy.cn/">中资源</a>】、【<a href="https://www.west.cn/customercenter/">西部数码</a>】、【<a href="https://www.bizcn.com/show/faq/index.do">商务中国</a>】、【<a href="https://help.ename.cn/">易名</a>】。</p>
<p style="padding-left: 30px;">5、验证域名是否接入成功可参考： <a href="http://help.yunaq.com/faq/2780/index.html">http://help.yunaq.com/faq/2780/</a></p>


一、CNAME接入方式介绍 CNAME接入是一种同时通过域名解析服务商和云防御DNS的双重域名解析方式，生效速 [&#8230;]

知道创宇云防御CNAME方式接入操作指导

<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白名单申请流程

<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>净网盾共包含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文档

如何查看词库释义

关注知道创宇云安全