AES 加密 URL 安全传输:避免 + / 等特殊字符引发的路径解析错误

阿敏君_5971

阿敏君_5971

2026-10-29

287人浏览

原创

AES 加密 URL 安全传输:避免 + / 等特殊字符引发的路径解析错误

使用 AES 加密后的 Base64 密文(如 WKqxB/qNPQUz6wRbHZrpBQ==)含 /、+、= 等 URL 非安全字符,直接拼入 GET 路径会导致路由解析失败或被网关(如 Kubernetes Ingress)截断;正确解法是采用 URL 安全的 Base64 编码(Base64.getUrlEncoder()),它用 - 替代 +、_ 替代 /、省略填充 =,生成完全兼容 URL 的密文字符串。

使用 aes 加密后的 base64 密文(如 wkqxb/qnpquz6wrbhzrpbq==)含 /、+、= 等 url 非安全字符,直接拼入 get 路径会导致路由解析失败或被网关(如 kubernetes ingress)截断;正确解法是采用 url 安全的 base64 编码(java.util.base64.geturlencoder()),它用 - 替代 +、_ 替代 /、省略填充 =,生成完全兼容 url 的密文字符串。

在 Web API(尤其是 Quarkus 或 Spring Boot 等微服务框架)中,将 AES 加密结果通过 URL 传递时,必须确保密文字符串符合 URI 编码规范。标准 Base64 编码(Base64.getEncoder())生成的字符串包含 +、/ 和 = —— 这些字符在 HTTP URL 中具有特殊语义:

  • / 被视为路径分隔符(如 .../users/WKqxB/qNPQUz... 中的第二个 / 会触发错误路由);
  • + 在查询参数中被默认解析为空格;
  • = 常用于键值对分隔,出现在值中易引发解析歧义。

✅ 正确方案:改用 URL 安全 Base64(RFC 4648 §5)
Java 8+ 原生支持 Base64.getUrlEncoder() 和 Base64.getUrlDecoder(),其编码规则严格适配 URI 场景:

字符 标准 Base64 URL 安全 Base64
+ + -
/ / _
= =(填充) 省略(无填充)

? 修改你的 EncryptUtil 类,将所有 Base64.getEncoder().encodeToString(...) 替换为 Base64.getUrlEncoder().encodeToString(...),并将解密端对应使用 Base64.getUrlDecoder().decode(...)。

以下是关键代码优化示例(仅展示核心加密/解密逻辑,已移除冗余方法并修复安全隐患):

public class EncryptUtil {
    private static final byte[] IV = new byte[16]; // ⚠️ 生产环境务必使用随机 IV!见下文说明
    private static final String CIPHER_ALGORITHM = "AES/CBC/PKCS5Padding";

    public String encrypt(String input, String key) 
            throws Exception {
        byte[] keyBytes = key.getBytes(StandardCharsets.UTF_8);
        SecretKeySpec secretKey = new SecretKeySpec(
            Arrays.copyOf(keyBytes, 16), "AES"); // 自动截取16字节(AES-128)

        Cipher cipher = Cipher.getInstance(CIPHER_ALGORITHM);
        IvParameterSpec ivSpec = new IvParameterSpec(IV); // 临时演示;生产请随机生成
        cipher.init(Cipher.ENCRYPT_MODE, secretKey, ivSpec);

        byte[] encrypted = cipher.doFinal(input.getBytes(StandardCharsets.UTF_8));
        return Base64.getUrlEncoder().encodeToString(encrypted); // ✅ URL 安全编码
    }

    public String decrypt(String encodedCipherText, String key) 
            throws Exception {
        byte[] keyBytes = key.getBytes(StandardCharsets.UTF_8);
        SecretKeySpec secretKey = new SecretKeySpec(
            Arrays.copyOf(keyBytes, 16), "AES");

        Cipher cipher = Cipher.getInstance(CIPHER_ALGORITHM);
        IvParameterSpec ivSpec = new IvParameterSpec(IV);
        cipher.init(Cipher.DECRYPT_MODE, secretKey, ivSpec);

        byte[] decoded = Base64.getUrlDecoder().decode(encodedCipherText); // ✅ URL 安全解码
        byte[] decrypted = cipher.doFinal(decoded);
        return new String(decrypted, StandardCharsets.UTF_8);
    }
}

? 使用示例(Quarkus REST 端点):

智流GEO
智流GEO

一款AI办公效率工具,主要用于专注AI搜索生态优化(GEO)的SaaS服务平台,适合需要提升相关任务效率的用户。

下载
@GET
@Path("/users/{encryptedId}")
public Response getUser(@PathParam("encryptedId") String encryptedId) {
    try {
        String userId = encryptUtil.decrypt(encryptedId, "my-super-secret-key-123");
        return Response.ok(userService.findById(userId)).build();
    } catch (Exception e) {
        return Response.status(400).entity("Invalid token").build();
    }
}

✅ 请求 URL 将变为:
https://10.162.128.94:30000/userProfile/v3.6/users/WKqxB_qNPQUz6wRbHZrpBQ
(注意:末尾 == 消失,/ → _,+ → -,无任何非法字符)

⚠️ 关键安全与工程提醒:

  • IV 必须随机且唯一:你当前代码中硬编码 IV = {0,0,...} 是严重安全漏洞(导致相同明文永远生成相同密文,违反 CBC 设计初衷)。✅ 正确做法:加密时生成随机 SecureRandom IV,前置拼接到密文前(如 IV + ciphertext),解密时先拆分再使用。URL 安全 Base64 同样适用于该组合字节数组。
  • 密钥长度需严格校验:AES-128 要求 16 字节密钥。建议使用 PBKDF2WithHmacSHA256 对用户口令派生密钥(参考你类中 getKeyFromPassword 方法),而非直接 getBytes()。
  • 禁用 ECB 模式:你代码中存在 AES/ECB/PKCS5Padding 的调用(如 encryptAESText2),ECB 会暴露明文模式,绝对禁止用于生产(如加密用户 ID、姓名等有规律数据)。
  • GCM 模式更优(推荐升级):若需防篡改(如 API Token),应切换至 AES/GCM/NoPadding,它提供认证加密(AEAD),无需额外 HMAC,且 Java 8u191+ 原生支持。

? 总结:AES 本身不产生特殊字符——问题根源在于 Base64 编码方式。Base64.getUrlEncoder() 是轻量、标准、零依赖的终极解法,兼顾安全性与 URL 兼容性。只需两行代码替换,即可彻底规避 Ingress/Nginx/Quarkus Router 的路径解析异常,同时保持加密强度不变。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

安全传输

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11457

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8582

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7372

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1476

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3009

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20271

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习