全部产品
云市场

JAVA服务端SDK集成

更新时间:2019-06-20 21:42:56

前提条件

  • 已为您的阿里云账号创建AccessKey。
  • 已从云盾人机验证控制台下载JAVA服务端SDK包。
  • 服务端开发环境为J2SE Development Kit (JDK) 1.5或以上版本。

安装SDK

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

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

    例如,在Eclipse中,右键单击工程,选择Properties>Java Build Path>Libraries>Add External JARs,选择并添加这两个jar包。

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

注意事项

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

初始化IClientProfile

IClientProfile是与人机验证服务端API交互的接口,所有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");

调用人机验证服务端API

IClientProfile完成后,即可调用人机验证服务端提供的API,根据业务需要开发前端页面请求的处理类和对运行结果的处理方式。

关于人机验证服务API的具体说明,请参见人机验证Web/HTML5应用类型服务API

  1. public void test(){
  2. AuthenticateSigRequest request = new AuthenticateSigRequest();
  3. request.setSessionId("xxx");// 会话ID。必填参数,从前端获取,不可更改。
  4. request.setSig("xxx");// 签名串。必填参数,从前端获取,不可更改。
  5. request.setToken("xxx");// 请求唯一标识。必填参数,从前端获取,不可更改。
  6. request.setScene("xxx");// 场景标识。必填参数,从前端获取,不可更改。
  7. request.setAppKey("xxx");// 应用类型标识。必填参数,后端填写。
  8. request.setRemoteIp("xxx");// 客户端IP。必填参数,后端填写。
  9. try {
  10. //response的code枚举:100验签通过,900验签失败
  11. AuthenticateSigResponse response = client.getAcsResponse(request);
  12. if(response.getCode == 100) {
  13. System.out.println("验签通过");
  14. } else {
  15. System.out.println("验签失败");
  16. // TODO
  17. } catch (Exception e) {
  18. e.printStackTrace();
  19. }
  20. }