<p>一、NS接入方式介绍</p>
<p style="padding-left: 30px;">NS接入方式是指将域名解析完全托管到知道创宇云防御平台的方式，知道创宇除了提供安全加速服务外，还提供完整的DNS智能解析、DNS抗DDoS服务，接入后，需要用户将该域名的所有子域名均迁移到云防御平台进行解析，需要防御的站点使用云端模式，不需要防御的站点使用回源模式。</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>三、接入操作步骤</p>
<p style="padding-left: 30px;">1、输入根域名（如：要接入的域名为：www.example.com，则根域名为：example.com），选择“NS方式接入”，点击【添加域名】。</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3323" src="http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式.png" alt="" width="1355" height="659" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式.png 1355w, http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式-300x146.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式-768x374.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式-1024x498.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式-60x29.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/NS接入方式-150x73.png 150w" sizes="(max-width: 1355px) 100vw, 1355px" /></p>
<p style="padding-left: 30px;">2、点击【完成向导】，进入子域名列表。点击【添加子域名】，支持单个添加和批量添加两种方式。</p>
<p style="padding-left: 30px;">注：a.云防御平台支持泛域名接入，即在主机名处填写<span style="color: #ff0000;"> *</span> ；</p>
<p style="padding-left: 30px;">        b.若要添加根域名（如：example.com），主机名需填写 <span style="color: #ff0000;">@ </span>。</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3324" src="http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24.png" alt="" width="2402" height="474" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24.png 2402w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24-300x59.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24-768x152.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24-1024x202.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24-60x12.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-29-24-150x30.png 150w" sizes="(max-width: 2402px) 100vw, 2402px" /></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.云防御平台支持泛域名接入，即在主机名处填写 <span style="color: #ff0000;">*</span> 。</p>
<p style="padding-left: 64px;">b.若要添加根域名，主机名填写 <span style="color: #ff0000;">@</span> 。</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、添加完成后，点击【下一步，DNS切换】，按照提示修改DNS服务器地址，修改完成点击【立即接入】。</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3325" src="http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40.png" alt="" width="2440" height="1070" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40.png 2440w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40-300x132.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40-768x337.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40-1024x449.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40-60x26.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-30-40-150x66.png 150w" sizes="(max-width: 2440px) 100vw, 2440px" /></p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-3326" src="http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51.png" alt="" width="2286" height="1148" srcset="http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51.png 2286w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51-300x151.png 300w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51-768x386.png 768w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51-1024x514.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51-60x30.png 60w, http://help.yunaq.com/wp-content/uploads/2021/07/image2021-3-22_16-31-51-150x75.png 150w" sizes="(max-width: 2286px) 100vw, 2286px" /></p>
<p style="padding-left: 30px;">4、登陆域名解析服务商管理页修改NS记录为知道创宇的NS服务器地址。</p>
<p style="padding-left: 30px;">腾讯云修改DNS解析可参考：<a href="http://help.yunaq.com/faq/2761/index.html">http://help.yunaq.com/faq/2761/index.html</a>；</p>
<p style="padding-left: 30px;">阿里云修改DNS解析可参考： <a href="http://help.yunaq.com/faq/2751/index.html">http://help.yunaq.com/faq/2751/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/index.html</a>。</p>


一、NS接入方式介绍 NS接入方式是指将域名解析完全托管到知道创宇云防御平台的方式，知道创宇除了提供安全加速服 [&#8230;]

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

<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文档

如何查看词库释义

关注知道创宇云安全