QQ机器人webhook签名验签Java版

QQ机器人WebHook签名验签JAVA版

1. 官方文档中仅提供了GO，PYTHON和NODE的SDK，并且提供的示例也仅有GO版本的，特此为JAVA做一版。

复制代码

前期准备

1. QQ开放平台已创建机器人获取对应的机器人ID和密钥等资料信息。

复制代码

maven引用：

1. <dependency>
2.         <groupId>org.bouncycastle</groupId>
3.         bcprov-jdk15on</artifactId>
4.         <version>1.70</version>
5. </dependency>

复制代码

签名工具类

签名类：

1. import lombok.extern.slf4j.Slf4j;
2. import org.bouncycastle.crypto.params.Ed25519PrivateKeyParameters;
3. import org.bouncycastle.crypto.params.Ed25519PublicKeyParameters;
4. import org.bouncycastle.crypto.signers.Ed25519Signer;
5. import java.io.ByteArrayOutputStream;
6. import java.io.IOException;
7. import java.nio.charset.StandardCharsets;
8. import java.util.Arrays;
10. /**
11. * @author chen
12. * @version 1.0
13. * @description: TODO 回调签名加解密帮助类
14. * @date 14 4月 2025 14:14
15. */
17. @Slf4j
18. public class CallBackSignUtil {
20.     private static final int ED25519_SEED_SIZE = 32;
22.     /**
23.      * @description: TODO 验证签名是否对应
24.      * @author chen
25.      * @date: 15 4月 2025 14:03
26.      */
27.     public static boolean verifySignature(String appSecret, String xSignatureEd25519, String xSignatureTimestamp, String reqBody) throws IOException {
28.         byte[] seed = expandSeed(appSecret.getBytes(StandardCharsets.UTF_8));
30.         // 用 seed 构造 Ed25519 私钥
31.         Ed25519PrivateKeyParameters privateKey = new Ed25519PrivateKeyParameters(seed, 0);
33.         // 从私钥推导出公钥
34.         Ed25519PublicKeyParameters publicKey = privateKey.generatePublicKey();
35.         byte[] signature = hexStringToByteArray(xSignatureEd25519);
37.         if (signature.length != 64 || (signature[63] & 0xE0) != 0) {
38.             return false;
39.         }
41.         ByteArrayOutputStream msg = new ByteArrayOutputStream();
42.         msg.write(xSignatureTimestamp.getBytes());
43.         msg.write(reqBody.getBytes());
44.         byte[] msgBytes = msg.toByteArray();
46.         Ed25519Signer signer = new Ed25519Signer();
47.         signer.init(false, publicKey);
48.         signer.update(msgBytes, 0, msgBytes.length);
49.         return signer.verifySignature(signature);
50.     }
52.     /**
53.      * @description: TODO  生成秘钥
54.      * @author chen
55.      * @date: 15 4月 2025 13:50
56.      */
57.     public static String generateResponse(String botSecret, String eventTs, String plainToken) throws Exception {
58.   
59.         byte[] seed = expandSeed(botSecret.getBytes(StandardCharsets.UTF_8));
60.         Ed25519PrivateKeyParameters privateKey = new Ed25519PrivateKeyParameters(seed, 0);
62.         // 生成Ed25519密钥对
63.         ByteArrayOutputStream msg = new ByteArrayOutputStream();
64.         msg.write(eventTs.getBytes());
65.         msg.write(plainToken.getBytes());
66.         byte[] msgBytes = msg.toByteArray();
68.         Ed25519Signer signer = new Ed25519Signer();
69.         signer.init(true, privateKey);
70.         signer.update(msgBytes, 0, msgBytes.length);
71.         byte[] signature = signer.generateSignature();
73.         return bytesToHex(signature);
74.     }
76.     /**
77.      * @description: TODO 字节转换
78.      * @author chen
79.      * @date: 15 4月 2025 13:49
80.      */
81.     private static String bytesToHex(byte[] bytes) {
82.         if (bytes == null) {
83.             throw new IllegalArgumentException("bytes cannot be null");
84.         }
85.         StringBuilder result = new StringBuilder();
86.         for (byte b : bytes) {
87.             result.append(Integer.toString((b & 0xff) + 0x100, 16).substring(1));
88.         }
89.         return result.toString();
90.     }
92.     /**
93.      * @description: TODO 秘钥补齐
94.      * @author chen
95.      * @date: 15 4月 2025 13:50
96.      */
97.     private static byte[] expandSeed(byte[] input) {
98.         if (input == null) {
99.             throw new IllegalArgumentException("Input cannot be null");
100.         }
101.         ByteArrayOutputStream output = new ByteArrayOutputStream();
102.         while (output.size() < ED25519_SEED_SIZE) {
103.             output.writeBytes(input);
104.         }
105.         return Arrays.copyOf(output.toByteArray(), ED25519_SEED_SIZE);
106.     }
108.     /**
109.      * @description: TODO 哈希16字符串转字节
110.      * @author chen
111.      * @date: 18 4月 2025 11:04
112.      */
113.     private static byte[] hexStringToByteArray(String s) {
114.         int len = s.length();
115.         if ((len & 1) != 0) {
116.             throw new IllegalArgumentException("Hex string must have even length");
117.         }
118.         byte[] data = new byte[len / 2];
119.         for (int i = 0; i < len; i += 2) {
120.             data[i / 2] = (byte) (
121.                     (Character.digit(s.charAt(i), 16) << 4)
122.                             + Character.digit(s.charAt(i + 1), 16)
123.             );
124.         }
125.         return data;
126.     }
127. }

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！