第三方接口对接之鉴权

本文介绍了与第三方接口对接时的鉴权过程,涉及加密验证,包括DES加密、HMACSHA1和Base64编码。对接要求包括使用特定参数生成Signature签名,确保数据安全性和身份验证。文章详细阐述了加密步骤及各加密方法的作用,如HMACSHA1用于防止数据篡改,Base64用于文本编码,DES用于特定参数加密。并展示了部分关键代码。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

第三方接口对接

鉴权

记录一次和第三方接口对接的过程。

对接要求

对方的接口做了加密验证,需要将参数进行加密生成一个Signature签名。然后对方也会根据参数做一样的步骤来比对签名是否相等来判断参数是否被篡改或者判断身份是否一致。

对方提供了以下几个参数:

  • accessKey : 和参数进行混合的key
  • accessSecret: 进行base64编码的时候的密码
  • dateTime : 密钥生成的时间,对方文档会标注根据该时间来判断接口的有效时间。比如5分钟内该参数是有效的,超过5分钟对方就认为这个请求已经过期了。
  • randomNumbers : 随机数
  • password : DES加密的密码

加密的类型:

明文参数:

  • 手机号码 : 需要通过DES进行加密,加密的密码为上面提供的password。

密文参数:

  • 首先拿到明文参数

  • 参数的顺序必须一致:例如一段json字符串数据,里面的key必须按照a-z不区分大小写的顺序进行排列。

  • 除了业务参数,还有通用参数:accessKeydateTimerandomNumbers等等加入到参数字符串中。

  • 所有的key对应的value必须要经过URLEncoder进行编码,避免出现中文乱码的情况。

  • 将所有参数通过字符串拼接成一个整的字符串,类似于URL中GET请求参数的样子。然后将得到的这个参数值进行HMACSHA1加密,加密的密钥为accessSecret

  • 最后通过Base64生成密钥。

  • 将这个密钥加入到请求的header头中。

  • header头也需要带上通用参数。

以上加密的方式主要是为了保证,参数不能被篡改,调用方的身份验证。两边加密和解密的步骤是一致的。否则就会鉴权失败。

另外简单描述一下各个加密的用处:

HMACSHA1 : 是从 SHA1 哈希函数构造的一种键控哈希算法,被用作 HMAC(基于哈希的消息验证代码)。 此 HMAC 进程将密钥与消息数据混合,使用哈希函数对混合结果进行哈希计算,将所得哈希值与该密钥混合,然后再次应用哈希函数。 输出的哈希值长度为 160 位。

在发送方和接收方共享机密密钥的前提下,HMAC 可用于确定通过不安全信道发送的消息是否已被篡改。 发送方计算原始数据的哈希值,并将原始数据和哈希值放在一个消息中同时传送。 接收方重新计算所接收消息的哈希值,并检查计算所得的 HMAC 是否与传送的 HMAC 匹配。

Base64 : 是一种任意二进制到文本字符串的编码方法,常用于在URL、Cookie、网页中传输少量二进制数据。

DES加密 : 双方约定一致的key进行加密,生成64位的明码形式进行传输,各方可以通过key进行解密

关键代码展示:

HMACSHA1 :

import javax.crypto.Mac;
import javax.crypto.SecretKey;
import javax.crypto.spec.SecretKeySpec;
public class HMACSHA1 {
   
   
 
	private static final String MAC_NAME = "HmacSHA1";  
    private static final String ENCODING = "UTF-8";  
    
	/*
	 * 展示了一个生成指定算法密钥的过程 初始化HMAC密钥 
	 * @return 
	 * @throws Exception
	 * 
	  public static String initMacKey() throws Exception {
	  //得到一个 指定算法密钥的密钥生成器
	  KeyGenerator KeyGenerator keyGenerator =KeyGenerator.getInstance(MAC_NAME); 
	  //生成一个密钥
	  SecretKey secretKey =keyGenerator.generateKey();
	  return null;
	  }
	 */
    
    /** 
     * 使用 HMAC-SHA1 签名方法对对encryptText进行签名 
     * @param encryptText 被签名的字符串 
     * @param encryptKey  密钥 
     * @return 
     * @throws Exception 
     */  
    public static byte[] HmacSHA1Encrypt(String encryptText, String encryptKey) throws Exception   
    {
   
            
    	byte[] data=encryptKey.getBytes(ENCODING);
    	//根据给定的字节数组构造一个密钥,第二参数指定一个密钥算法的名称
        SecretKey secretKey = new SecretKeySpec(data, MAC_NAME); 
        //生成一个指定 Mac 算法 的 Mac 对象
        Mac mac = Mac.getInstance(MAC_NAME); 
        //用给定密钥初始化 Mac 对象
        mac.init(secretKey);  
        
        byte[] text = encryptText.getBytes(ENCODING);  
        //完成 Mac 操作 
        return mac.doFinal(text);  
    }
}

DESUtils:

import sun.misc.BASE64Encoder;

import javax.crypto.Cipher;
import javax.crypto.SecretKey;
import javax.crypto.SecretKeyFactory;
import javax.crypto.spec.DESKeySpec;
import java.security.SecureRandom;

public class DESUtils {
   
   

    /**
     * @param data
     * @return
     * @throws Exception
     * @Method: encrypt
     * @Description: 加密数据
     * @date 2016年7月26日
     */
    public static String encrypt(String data, String password) {
   
     //对string进行BASE64Encoder转换
        byte[] bt = encryptByKey
### 海康威视门禁系统ISAPI接口对接 为了实现第三方系统与海康威视门禁系统的ISAPI接口对接,需遵循特定的协议标准和流程。首先,了解ISAPI(Internet Services API)是用于访问设备功能的一种HTTP RESTful风格的应用编程接口。 #### 设备准备与环境配置 确保目标海康威视门禁控制器已正确安装并联网运行正常。获取管理员限账号以便后续操作,并确认该设备支持ISAPI服务开启状态[^1]。 #### 获取开发者文档和支持材料 前往官方技术支持网站下载最新的SDK包以及详细的《ISAPI集成开发指南》,其中包含了完整的URL路径定义、请求参数说明及响应码解释等内容[^2]。 #### 接口调用前准备工作 - **认证**:大多数情况下需要先完成身份验证过程才能继续其他业务逻辑交互;通常采用Basic Auth方式,在每次发起HTTP(S)请求时附带用户名密码信息作为Authorization头部字段传递给服务器端校验。 - **设置Content-Type**:对于POST/PUT类型的请求而言,应当指定`application/json;charset=UTF-8`来表明发送的数据格式为JSON字符串编码形式[^3]. ```json { "userName": "admin", "password": "your_password" } ``` #### 实现具体功能模块对接实例 假设现在要读取当前在线人员列表,则可以按照如下步骤执行: 构建GET方法请求至`http://<device_ip>/ISAPI/AccessControl/onlinePersonList?format=json`地址处,注意替换实际IP地址部分。成功返回后会得到类似下面结构化的数据体: ```json [ { "personID":"000001", "name":"张三", "cardNo":"AABBCCDD", "time":"2023-09-15T14:48:32Z" }, ... ] ``` 以上即完成了简单的查询动作展示[^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值