全部产品
阿里云办公

.NET教程

更新时间:2018-05-28 15:50:58

NET-SDK使用说明

创建Access Key

1.登陆阿里云账号;
2.打开“我的Access Key”页面,页面地址:http://i.aliyun.com/access_key/;
3.创建Access Key。

安装SDK

  • 开发环境
    阿里云.Net SDK支持framework 4.0或以上版本。
  • 安装步骤
    1、在解压的文件中可以找到aliyun-net-sdk-afs.dll和aliyun-net-sdk-core.dll这两个文件;
    说明:您可以在云盾数据风控管理控制台>人机验证>配置管理页面,选择已添加的配置记录,单击系统代码集成,在服务端API集成步骤中下载对应语言的SDK包。
    2、在你的Visual Studio项目上右键点击,添加引用->浏览(如果你用的是MonoDevelop,请自行按照相应导入dll的方法导入这个dll文件);
    3、选择上述的dll文件,点击“确定”按钮,经过以上步骤,你就可以在工程中使用阿里云.Net SDK了。

快速入门

初始化一个IClientProfile
1、与阿里云SDK相关的类都在包com.aliyuncs.IAcsClient下;
2、IClientProfile是与API交互的接口,SDK的操作都是通过IClientProfile完成的;
3、IClientProfile可以复用,建议设置成应用程序全局唯一的;
4、用户可以调用带有connectTimeout和readTimeout的构造方法来设置SDK调用接口的连接超时时间和读取超时时间,SDK默认的连接超时时间是3秒,读取超时时间是80秒。

  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");

示例代码

  • 人机验证API

    1. public void Test()
    2. {
    3. AuthenticateSigRequest request = new AuthenticateSigRequest();
    4. request.SessionId = "xxx";// 必填参数,从前端获取,不可更改
    5. request.Sig = "xxx";// 必填参数,从前端获取,不可更改
    6. request.Token = "xxx";// 必填参数,从前端获取,不可更改
    7. request.Scene = "xxx";// 必填参数,从前端获取,不可更改
    8. request.AppKey = "xxx";// 必填参数,后端填写
    9. request.RemoteIp = "xxx";// 必填参数,后端填写
    10. try
    11. {
    12. //response的code枚举:100验签通过,900验签失败
    13. AuthenticateSigResponse response = client.GetAcsResponse(request);
    14. // TODO
    15. }
    16. catch (Exception e)
    17. {
    18. Console.WriteLine(e.ToString());
    19. }
    20. }

无痕接入代码

  • 人机验证API

    1. public void Test()
    2. {
    3. AnalyzeNvcRequest request = new AnalyzeNvcRequest();
    4. request.Data = "xxx";// 必填参数,从前端获取,不可更改
    5. //注意:setScoreJsonStr方法声明"后端调用风控返回结果"与"客户端执行操作"之间的映射关系,并通知验证码服务端做二次验证授权,客户端请严格按照风控后端response+映射关系执行相应操作,否则会导致调用异常
    6. //例如,setScoreJsonStr声明了"400":"SC",则后端返回400时,您客户端必须唤醒SC,若唤醒NC则会导致失败。
    7. request.ScoreJsonStr("{\"200\":\"PASS\",\"400\":\"NC\",\"600\":\"SC\",\"800\":\"BLOCK\"}");
    8. try
    9. {
    10. AnalyzeNvcResponse response = client.GetAcsResponse(request);
    11. // TODO
    12. }
    13. catch (Exception e)
    14. {
    15. Console.WriteLine(e.ToString());
    16. }
    17. }