NHu Analysis

应用部署

部署流程

  • 登录用户中心,新建验证域名
  • 域名列表中点击选择新创建的域名,并进行代码部署
  • 独立控件形式不需要此步骤如何部署中的元素的ID键入表单的相应button/其他的ID值,并将自动生成的HTML代码复制到该元素ID代码的后面

绑定按钮 HTML代码 示例推荐

您可以点击 查看演示

<button id="login_btn" />提交</button>
<script src="//cdn.shenqiniao.com/sqn.js?id=网站ID&btn=login_btn" type="text/javascript"></script>

独立控件 HTML代码 示例

您可以点击 查看演示

  • sqn-height 可配置按钮高度
  • 提醒 请按照示例代码进行部署,否则将影响实际体验
<div id="SQNView">
    <div id="SQNContainer" sqn-height="40">
        <div id="SQN-load-bg"></div>
        <div class="SQN-init">
            <a href="https://www.shenqiniao.com/" target="_blank"><img src="//cdn.shenqiniao.com/loading.gif"/></a>
            <span class="vaptcha-text">加载中...</span>
        </div>
    </div>
    <a class="SQN-tips" href="https://www.shenqiniao.com/help.html" title="Help" target="_blank"><img src="//cdn.shenqiniao.com/t.png"/></a>
</div>
<script src="//cdn.shenqiniao.com/sqn.js?id=网站ID&btn=此处留空" type="text/javascript"></script>

线路细化,请按需选择

  • 全球线路:cdn.shenqiniao.com推荐
  • 海外线路:static.shenqiniao.net推荐
  • 备用线路:static.shenqiniao.com
  • 美国线路:cdn1.shenqiniao.com

高级设定

模型设置

用户的身份定位可根据网站自身业务来定位,下文仅作为互联网通用身份权重进行基本区分

  • 绿色通道 优质用户 无需进行身份验证,全程无验证流程
  • 滑条验证-1 良好用户 将进行常规的滑条拖拽验证
  • 滑条验证-2 一般用户 将进行升级版滑条拖拽验证
  • 弹球验证 风险用户 通过较为复杂的验证机制进行身份验证

白名单

用于服务器间的二次验证的授权IP列表,多个IP请使用英文版的逗号(“,”)进行分割,如无需IP限制则留空。

广告设置

提示:该广告模式仅在弹球验证模式中生效,且允许执行JS等代码。强烈建议网站持有人不投放他人代码,如投放非正规代码,可能造成以下几种安全风险

  • 可能存在冒用官方身份进行相关欺诈行为
  • 可能存在XSS、网站劫持、CSRF、401恶意授权等未知风险
  • 可能被用于违法内容的宣传投放
  • 可能被第三方收集访客的身份、行为轨迹、个人隐私等风险行为

广告投放提醒 本应用仅作为用户身份验证而存在,如您使用本模型进行广告联盟的广告投放。本平台不承担任何关于广告联盟与贵网站间产生的纠纷。

示例代码

验证函数文件内含示例代码: PHP版

您可以选择以下任意一种方法进行服务端代码部署,该函数不会对现有环境产生任何影响

  • 添加函数 请将验证函数文件中的代码复制到网站系统相应的公共函数库里面,以便于调用
  • 引入文件 您可以在进行函数验证前引入该函数文件

生成令牌

  • 客户端页面将会在验证成功后自动在Dom中生成以下结构的内容
    <input type="hidden" name="sqn_captcha" id="sqn_captcha" value="令牌" />

获取令牌

  • 原生JS获取令牌
    var captcha = document.querySelector("#sqn_captcha").value;

    var captcha = document.getElementById('sqn_captcha').value;
  • JQuery获取令牌
    var captcha = $('#sqn_captcha').val();

提交令牌

  • Ajax、JQuery提交需完成上一步,获取令牌
    • POST
      请在data属性中补充以下对象{sqn_captcha:captcha}
    • GET
      请在请求的URL中追加或补充以下参数&sqn_captcha=令牌(请自行替换成相应变量)
      例如
      $.get('http://www.shenqiniao.com/login?sqn_captcha=' + sqn_captcha);
  • 表单提交 POST
    服务端将会自动捕获到$_POST['sqn_captcha']令牌内容
  • 表单提交 GET
    服务端将会自动捕获到$_GET['sqn_captcha']令牌内容

触发事件

验证成功后,系统将执行已绑定的button/其他的click事件以触发按钮本身绑定的相关事务。

  • 您还可以使用以下方法进行验证代码是否完毕
    <script>
    var SQN_Ready = function()
    {
         console.log('SQN 部署完成');
    }
    </script>
    <script src="//cdn.shenqiniao.com/sqn.js?id=网站ID&btn=元素ID" type="text/javascript"></script>

在线验证推荐

  • 在条件/业务环境允许的情况下,业务服务器可与验证网端进行二次验证。
    • 验证方法(示例语言:PHP)

      if(sqn_validate('需验证的令牌','应用Key','应用ID'))
      {
          //验证通过,相关的业务操作
      }
      else
      {
         //验证失败
      }
    • 由于产品的不断优化,验证网端可能会发生地址变更,最新验证网端如下(请修改验证函数中对应的$url变量)。建议开启应用的IP白名单
      http://ms.shenqiniao.com/?v=1.0

单机验证不推荐

  • 在条件/业务环境不允许的情况下,业务服务器可仅使用应用提供的Key和ID进行基本的身份校验。
    • 验证方法(示例语言:PHP)

      if($prevalidate=sqn_validate('需验证的令牌','应用Key','应用ID',true))
      {
      
          /*
           * 可对两次验证的间隔时长进行二次判断,在线模式不返回该间隔时长
           * $prevalidate 默认:100000000(秒)
           * 短期内多次提交时 $prevalidate 才生效
           * 计算:上次验证成功与本次验证成功的间隔时长
           */
      
           //验证通过,相关的业务操作
      }
      else
      {
         //验证失败
      }

更多使用

  • 如有其他开发问题,请进入用户中心 提交工单 咨询。