全部产品
云市场

.NET服务端SDK集成

更新时间:2019-06-17 15:32:58

前提条件

  • 已为您的阿里云账号创建AccessKey。
  • 已从云盾人机验证控制台下载.NET服务端SDK包。
  • 服务端开发环境为.NET Framework 4.0或以上版本。

安装SDK

  1. 在解压的SDK包中,找到aliyun-net-sdk-afs.dll和aliyun-net-sdk-core.dll文件。

  2. 将这两个文件导入您的服务端工程中。

    例如,在Visual Studio中,右键单击项目,选择添加引用>浏览,选择并添加这两个dll文件。

  3. 添加成功后,您就可以在您的服务端工程中使用阿里云人机验证的.NET SDK。

注意事项

  • 与人机验证服务端SDK相关的类都在com.aliyuncs.IAcsClient包中。
  • SDK调用接口的默认连接超时时间是3秒,读取超时时间是80秒。您可以调用带有connectTimeout和readTimeout的构造方法来自定义设置SDK调用接口的连接超时时间和读取超时时间。

初始化IClientProfile

IClientProfile是与人机验证服务端交互的接口,所有SDK的操作都需要通过IClientProfile完成。

说明:IClientProfile可以复用,建议将其设置成应用程序全局唯一。

  1. String regionid = "cn-hangzhou";
  2. String accessKeyId = "*** Provide your AccessKeyId ***";
  3. String accessKeySecret = "*** Provide your AccessKeySecret ***";
  4. // Create a new IClientProfile instance
  5. IClientProfile profile= DefaultProfile.getProfile(regionid, accessKeyId, accessKeySecret);
  6. IAcsClient client = new DefaultAcsClient(profile);
  7. DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", "afs", "afs.aliyuncs.com");

调用人机验证服务端接口

IClientProfile完成后,即可调用AnalyzeNvcRequest接口,根据业务需要开发前端页面请求的处理类和对运行结果的处理方式。

  1. public void Test()
  2. {
  3. AnalyzeNvcRequest request = new AnalyzeNvcRequest();
  4. request.Data = "xxx";//必填参数,由前端获取getNVCVal方法获得的值。
  5. //通过setScoreJsonStr方法声明"服务端调用人机验证服务接口得到的返回结果"与"前端执行操作"间的映射关系,并通知验证码服务端进行二次验证授权。
  6. //注意:前端页面必须严格按照该映射关系执行相应操作,否则将导致调用异常。
  7. //例如,在setScoreJsonStr方法中声明"400":"SC",则当服务端返回400时,您的前端必须唤醒刮刮卡验证(SC),如果唤醒滑块验证(NC)则将导致失败。
  8. request.ScoreJsonStr("{\"200\":\"PASS\",\"400\":\"NC\",\"600\":\"SC\",\"800\":\"BLOCK\"}");// 根据业务需求设置各返回结果对应的客户端处置方式。
  9. try
  10. {
  11. AnalyzeNvcResponse response = client.GetAcsResponse(request);
  12. // TODO
  13. }
  14. catch (Exception e)
  15. {
  16. Console.WriteLine(e.ToString());
  17. }
  18. }