<p>一、功能描述</p>
<p style="padding-left: 30px;">批量操作功能可帮助用户在云防御平台进行高效的域名管理，包含批量添加域名、删除域名、导出域名、修改取源地址、修改模式、修改配置参数、修改配置开关。此功能为增值服务，如有需要可联系商务经理开通使用。</p>
<p>二、功能配置</p>
<p style="padding-left: 30px;">登录知道创宇云防御控制台，进入【增值服务】-【高级设置】，也可直接点击<a href="https://defense.yunaq.com/advanced/setting/">https://defense.yunaq.com/advanced/setting/</a>快速进入。</p>
<p><a name="return"></a>三、批量操作高级版配置说明</p>
<p style="padding-left: 30px;">此功能总共分为7个模块，分别为添加域名、删除域名、导出域名、修改取源地址、修改模式、修改配置参数、修改配置开关。</p>
<p style="padding-left: 30px;">1.添加域名</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4115" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名.png" alt="" width="1701" height="823" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名.png 1701w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名-300x145.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名-768x372.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名-1024x495.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名-60x29.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-添加域名-150x73.png 150w" sizes="(max-width: 1701px) 100vw, 1701px" /></p>
<p style="padding-left: 60px;">1）接入方式：默认选择CNAME接入方式，如需NS方式接入域名，可手动切换（CNAME接入方式是指域名解析服务商和云防御DNS的双重域名解析方式，NS接入方式是指将域名解析完全托管到知道创宇云防御平台的方式）。</p>
<p style="padding-left: 60px;">2）根域名：复制或输入需要添加的根域名，每个域名按空格或换行分开，最多可以输入100个根域名。</p>
<p style="padding-left: 60px;">3）主机名：每条记录主机名只能填写一个，最多可以添加5条记录。</p>
<p style="padding-left: 60px;">4）取源地址：此处填写源站服务器的 IP 或别名地址。</p>
<p style="padding-left: 60px;">5）模式：默认选择“云端”模式，如接入时需保持“回源”模式，可手动切换（云端模式请求流转过程：客户端-云防御节点-源站，回源模式请求流转过程：客户端-源站）。</p>
<p style="padding-left: 30px;">2.删除域名</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4116" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名.png" alt="" width="1700" height="718" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名.png 1700w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名-300x127.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名-768x324.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名-1024x432.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名-60x25.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-删除域名-150x63.png 150w" sizes="(max-width: 1700px) 100vw, 1700px" /></p>
<p style="padding-left: 60px;">1）根域名：复制/输入需要删除的域名，每个域名按空格/换行分开，最多可以输入100个根域名（<span style="color: #ff0000;">注：若只填写了根域名未填写主机名和取源地址，则会直接删除根域名及根域名下所有的子域名</span>）。</p>
<p style="padding-left: 60px;">2）主机名：每条记录主机名只能填写一个，最多可以添加5条记录（注：解析记录必须同时填写主机名和取源地址）。</p>
<p style="padding-left: 60px;">3）取源地址：此处填写源站服务器的 IP 或别名地址。</p>
<p style="padding-left: 30px;">3.导出域名</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4117" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名.png" alt="" width="1697" height="732" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名.png 1697w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名-300x129.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名-768x331.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名-1024x442.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名-60x26.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-导出域名-150x65.png 150w" sizes="(max-width: 1697px) 100vw, 1697px" /></p>
<p>&nbsp;</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4118" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果.png" alt="" width="1454" height="472" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果.png 1454w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果-300x97.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果-768x249.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果-1024x332.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果-60x19.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-到处域名-结果-150x49.png 150w" sizes="(max-width: 1454px) 100vw, 1454px" /></p>
<p style="padding-left: 60px;">1）根域名：复制/输入需要导出的域名，每个域名按空格/换行分开，最多可以输入100个根域名（注：若只填写根域名未填写主机名，则会导出根域名下所有的子域名）。</p>
<p style="padding-left: 60px;">2）主机名：最多支持输入5个主机名，按空格/换行分开。</p>
<p style="padding-left: 60px;">3）匹配别名地址：点击将出现匹配的结果，结果出现后可以文件形式导出，文件中的字段包含：子域名、别名地址、线路类型和指向（子域名：所查询的子域名，别名地址：云防御平台分配对应子域名的CNAME值，线路类型：添加对应子域名时选择的线路，指向：源站服务器 IP 或别名地址）。</p>
<p style="padding-left: 30px;">4.修改取源地址</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4119" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址.png" alt="" width="1710" height="720" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址.png 1710w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址-300x126.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址-768x323.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址-1024x431.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址-60x25.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改取源地址-150x63.png 150w" sizes="(max-width: 1710px) 100vw, 1710px" /></p>
<p style="padding-left: 60px;">1）根域名：复制/输入需要修改的域名，每个域名按空格/换行分开，最多可以输入100个根域名。</p>
<p style="padding-left: 60px;">2）主机名：每条记录主机名只能填写一个，最多可以添加5条记录。</p>
<p style="padding-left: 60px;">3）原取源地址和新取源地址：支持相同记录类型之间的地址修改，以及A记录和CNAME记录地址之间的转换（注：A记录与CNAME记录冲突，即只有一条主机记录时支持A记录与CNAME记录转换）。</p>
<p style="padding-left: 30px;">5.修改模式</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4120" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式.png" alt="" width="1703" height="725" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式.png 1703w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式-300x128.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式-768x327.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式-1024x436.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式-60x26.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改模式-150x64.png 150w" sizes="(max-width: 1703px) 100vw, 1703px" /></p>
<p style="padding-left: 60px;">1）根域名：复制/输入需要修改的根域名，每个域名按空格/换行分开，最多可以输入100个根域名。</p>
<p style="padding-left: 60px;">2）主机名：每条记录主机名只能填写一个，最多可以添加5条记录。</p>
<p style="padding-left: 60px;">3）模式：默认选中“云端”模式，如需修改为“回源”模式，可手动切换。</p>
<p style="padding-left: 30px;">6.修改配置参数</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4121" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数.png" alt="" width="1700" height="793" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数.png 1700w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数-300x140.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数-768x358.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数-1024x478.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数-60x28.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置参数-150x70.png 150w" sizes="(max-width: 1700px) 100vw, 1700px" /></p>
<p style="padding-left: 60px;">1）根域名：复制/输入需要修改的根域名，每个域名按空格/换行分开，最多可以输入100个根域名（<span style="color: #ff0000;">注：若只填写根域名未填写主机名，则根域名下所有子域名的功能都将被修改</span>）。</p>
<p style="padding-left: 60px;">2）主机名：每个功能对应的主机名最多支持输入5个，按空格分开。</p>
<p style="padding-left: 60px;">3）动作：默认选中追加，如需覆盖，可手动切换。</p>
<p style="padding-left: 60px;">4）设置：点击设置，进入相应功能的设置界面，设置配置完成后点击确认，即可下发任务。</p>
<p style="padding-left: 60px;">5）端口配置：一次操作最多支持5条端口转发策略。</p>
<p style="padding-left: 60px;">6）黑白名单设置：一次操作最多支持30条黑白名单记录。</p>
<p style="padding-left: 30px;">7.修改配置开关</p>
<p style="padding-left: 30px;"><img class="aligncenter size-full wp-image-4122" src="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关.png" alt="" width="1695" height="720" srcset="http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关.png 1695w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关-300x127.png 300w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关-768x326.png 768w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关-1024x435.png 1024w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关-60x25.png 60w, http://help.yunaq.com/wp-content/uploads/2021/08/批量操作-高级版-修改配置开关-150x64.png 150w" sizes="(max-width: 1695px) 100vw, 1695px" /></p>
<p style="padding-left: 60px;">1）根域名：复制/输入需要修改的根域名，每个域名按空格/换行分开，最多可以输入100个根域名（<span style="color: #ff0000;">注：若只填写根域名未填写主机名，则根域名下所有子域名的功能都将被修改</span>）。</p>
<p style="padding-left: 60px;">2）主机名：每个功能对应的主机名最多支持输入5个，按空格分开。</p>
<p style="padding-left: 60px;">3）动作：默认选中“开启”，如需关闭，可手动切换。</p>
<p>四、注意事项</p>
<p style="padding-left: 30px;"><span style="color: #ff0000;">1.批量操作目前暂无回退选项，请谨慎核实配置无误再执行操作，建议在进行批量操作之前将域名原有配置进行备份。</span></p>
<p style="padding-left: 30px;">2.提交批量操作后若任务下发成功，系统将弹出“提交成功”提示框，如需核实是否完全执行成功，请到【<a href="https://defense.yunaq.com/advanced/task_list/">任务列表</a>】检查操作执行结果。</p>


一、功能描述 批量操作功能可帮助用户在云防御平台进行高效的域名管理，包含批量添加域名、删除域名、导出域名、修改 [&#8230;]

批量操作高级版配置说明

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

如何查看词库释义

关注知道创宇云安全