skill 参数加密实战：从原理到安全传输的最佳实践

2次阅读

没有评论

共计 2890 个字符，预计需要花费 8 分钟才能阅读完成。

在现代 API 开发中，skill 参数往往携带了用户的敏感信息或系统关键标识。然而，许多开发者容易忽视其传输安全，导致以下风险：

明文传输风险：未加密的 skill 参数在 HTTP 请求中可被直接读取，攻击者可利用 Charles 等抓包工具轻易获取
中间人攻击：公共 WiFi 等不安全网络环境下，参数可能被篡改或窃取
业务逻辑漏洞：伪造 skill 参数可能导致越权访问，如普通用户冒充管理员

优点：加解密速度快(适合高并发)、相同密钥下性能稳定
缺点：密钥分发困难，需要安全通道传输密钥
适用场景：内部系统通信、批量数据处理

优点：公私钥分离，无需担心密钥传输问题
缺点：性能较差(比 AES 慢 100-1000 倍)、存在填充预言攻击风险
适用场景：初始密钥交换、数字签名

推荐方案：采用 AES-256-GCM 进行参数加密，配合 RSA 传输 AES 密钥的混合加密体系

import javax.crypto.*;
import javax.crypto.spec.GCMParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.security.SecureRandom;
import java.util.Base64;

public class AESUtil {
    private static final String ALGORITHM = "AES/GCM/NoPadding";
    private static final int TAG_LENGTH = 128; // 认证标签长度
    private static final int IV_LENGTH = 12;   // 初始向量长度

    // 加密方法
    public static String encrypt(String plaintext, String secretKey) throws Exception {
        // 密钥检查（实际项目应从安全存储获取）if(secretKey == null || secretKey.length() != 32) {throw new IllegalArgumentException("密钥必须是 32 位长度");
        }

        // 生成随机 IV
        byte[] iv = new byte[IV_LENGTH];
        new SecureRandom().nextBytes(iv);

        // 配置加密参数
        GCMParameterSpec parameterSpec = new GCMParameterSpec(TAG_LENGTH, iv);
        SecretKey key = new SecretKeySpec(secretKey.getBytes(), "AES");
        Cipher cipher = Cipher.getInstance(ALGORITHM);
        cipher.init(Cipher.ENCRYPT_MODE, key, parameterSpec);

        // 执行加密
        byte[] encrypted = cipher.doFinal(plaintext.getBytes(StandardCharsets.UTF_8));

        // 合并 IV 和密文
        byte[] combined = new byte[iv.length + encrypted.length];
        System.arraycopy(iv, 0, combined, 0, iv.length);
        System.arraycopy(encrypted, 0, combined, iv.length, encrypted.length);

        return Base64.getEncoder().encodeToString(combined);
    }

    // 解密方法（省略异常处理细节）public static String decrypt(String ciphertext, String secretKey) throws Exception {
        // 解码 Base64
        byte[] combined = Base64.getDecoder().decode(ciphertext);

        // 分离 IV 和密文
        byte[] iv = new byte[IV_LENGTH];
        byte[] encrypted = new byte[combined.length - IV_LENGTH];
        System.arraycopy(combined, 0, iv, 0, IV_LENGTH);
        System.arraycopy(combined, IV_LENGTH, encrypted, 0, encrypted.length);

        // 配置解密参数
        GCMParameterSpec parameterSpec = new GCMParameterSpec(TAG_LENGTH, iv);
        SecretKey key = new SecretKeySpec(secretKey.getBytes(), "AES");
        Cipher cipher = Cipher.getInstance(ALGORITHM);
        cipher.init(Cipher.DECRYPT_MODE, key, parameterSpec);

        // 执行解密
        byte[] decrypted = cipher.doFinal(encrypted);
        return new String(decrypted, StandardCharsets.UTF_8);
    }
}

安全要点注释：
1. 使用 GCM 模式提供认证加密，同时保证机密性和完整性
2. 每次加密生成随机 IV，防止确定性加密带来的模式识别风险
3. 密钥长度强制校验，防止弱密钥问题
4. 使用 Base64 编码便于网络传输