isv-sdk

万傲瑞联官网

帮助垂直行业独立软件开发商(ISV), 快速集成熵基（出入口、身份认证、时间管理） + AIoT能力.

目前万傲瑞联SDK支持以下api接口能力：

基础服务能力
门禁服务能力
考勤服务能力
健康核验能力
视频服务能力

开发

准备

在开始开发集成万傲瑞联应用之前，需要准备如下信息:

• 获取SDK的AppSecret、AppKey、AppAESKey
  万傲瑞联应用SDK的AppSecret、AppKey、AppAESKey可在万傲瑞联控制台 的应用信息里获取，如您尚未添加应用，请到万傲瑞联控制台中添加应用。

安装

isv-sdk可以采用多种方式进行安装，我们提供以下二种方法供用户使用：

maven

要使用isv-sdk功能，需要在pom.xml中添加如下依赖：

<dependency>
  <groupId>com.zkteco</groupId>
  <artifactId>bmp-sdk-api</artifactId>
  <version>1.0.0</version>
</dependency>

其他

将JAR包直接引入到您的工程中。

文档

若您对接口存在疑问，可以查阅:

API开发指南

错误码

数据加解密

由于数据在传输过程中，消息是在公开的因特网上传输，消息内容是可被截获的，如果内容未加密，则截获者可以直接阅读消息内容，存在着数据泄漏或者数据被抓包破解的风险。

万傲瑞联提供多种数据传输方式，最基础的为使用非加密格式的数据传输，同时提供了数据可加密选项. 开发者可以根据自身的需求选择加密数据传输通信，或者是非加密数据传输通信。

数据加密

对明文字符串加密并Base64编码

String encryptData = EncryptionUtils.AES256Encode("明文字符串", "AppAESKey");

数据解密

String decryptData = EncryptionUtils.AES256Decrypt("加密字符串", "AppAESKey");

示例

准备必要参数

Certificate certificate = new Certificate();
certificate.setAppKey("rad8yZF2vP");
certificate.setAppSecret("5LtVWBDG2wLGM1lknaqW");
certificate.setAppAESKey("458ddd64-72d2-4b19-8139-ebaa9a4496f5");
BasicServiceClient basicServiceClient = new BasicServiceClient(certificate);

调用相应api接口：

QueryDeviceRequest request = new QueryDeviceRequest();
QueryDeviceResponse response = basicServiceClient.findDeviceList(request);
List<DeviceDTO> deviceDTOList = response.getDeviceDTOList();
System.out.println(deviceDTOList);

加解密工具类

public class EncryptionUtils {

    /**
     * 说明: AES256加密
     *
     * @param stringToEncode 明文
     * @param keyString      密钥 
     * @return Bses64格式密文
     */
    public static String AES256Encode(String stringToEncode, String keyString)
            throws NullPointerException {
        if (StrUtil.isEmpty(keyString)) {
            return null;
        }
        if (StrUtil.isEmpty(stringToEncode)) {
            return null;
        }
        try {
            String stringToHex = convertStringToHex(keyString);
            SecretKeySpec skeySpec = getKey(stringToHex);
            byte[] data = stringToEncode.getBytes(StandardCharsets.UTF_8);
            Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
            cipher.init(Cipher.ENCRYPT_MODE, skeySpec);
            byte[] databyte = cipher.doFinal(data);
            return Base64.getEncoder().encodeToString(databyte);
        } catch (InvalidKeyException | NoSuchAlgorithmException | BadPaddingException | NoSuchPaddingException | IllegalBlockSizeException e) {
            e.printStackTrace();
        }

        return "";
    }

    /**
     * 说明 :AES256解密
     * 处理 使用AES256加密，再转base64的数据
     *
     * @param text      Base64格式密文
     * @param keyString 密钥
     * @return String格式明文
     */
    public static String AES256Decrypt(String text, String keyString) {

        if (StrUtil.isEmpty(keyString)) {
            return null;
        }
        if (StrUtil.isEmpty(text)) {
            return null;
        }
        try {
            String stringToHex = convertStringToHex(keyString);
            SecretKey key = getKey(stringToHex);
            String temp = text.replace("\r\n", "").replace("\n", "");
            byte[] data = Base64.getDecoder().decode(temp);
            Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
            cipher.init(Cipher.DECRYPT_MODE, key);
            byte[] decryptedValueBytes = (cipher.doFinal(data));
            return new String(decryptedValueBytes, StandardCharsets.UTF_8);
        } catch (NoSuchAlgorithmException | NoSuchPaddingException | InvalidKeyException | BadPaddingException | IllegalBlockSizeException e) {
            e.printStackTrace();
        }
        return "";
    }

    /**
     * 说明 :将密钥转行成SecretKeySpec格式
     *
     * @param password 16进制密钥
     * @return SecretKeySpec格式密钥
     */
    private static SecretKeySpec getKey(String password) {
        // 如果为128将长度改为128即可
        int keyLength = 256;
        byte[] keyBytes = new byte[keyLength / 8];
        // explicitly fill with zeros
        Arrays.fill(keyBytes, (byte) 0x0);
        byte[] passwordBytes = toByte(password);
        int length = Math.min(passwordBytes.length, keyBytes.length);
        System.arraycopy(passwordBytes, 0, keyBytes, 0, length);
        return new SecretKeySpec(keyBytes, "AES");
    }

    /**
     * 将字符串转换为16进制字符串
     *
     * @param str 字符串
     * @return hexString 16进制字符串
     */
    private static String convertStringToHex(String str) {
        //把字符串转换成char数组
        char[] chars = str.toCharArray();
        //新建一个字符串缓存类
        StringBuilder hex = new StringBuilder();
        //循环每一个char
        for (char aChar : chars) {
            //把每一个char都转换成16进制的，然后添加到字符串缓存对象中
            hex.append(Integer.toHexString(aChar));
        }
        //最后返回字符串就是16进制的字符串
        return hex.toString();
    }

    /**
     * 将16进制转换为byte数组
     *
     * @param hexString 16进制字符串
     * @return byte数组
     */
    private static byte[] toByte(String hexString) {
        int len = hexString.length() / 2;
        byte[] result = new byte[len];
        for (int i = 0; i < len; i++) {
            result[i] = Integer.valueOf(hexString.substring(2 * i, 2 * i + 2), 16).byteValue();
        }

        return result;
    }
}