using System.Text; using Microsoft.Extensions.Options; using OshimaBot.Models; using OshimaBot.Security; using Rebex.Security.Cryptography; using Xunit; namespace OshimaBot.Tests; /// /// 测试数据取自 QQ 机器人官方文档: /// 安全和授权 https://bot.qq.com/wiki/develop/api-v2/dev-prepare/interface-framework/sign.html /// Webhook 方式 https://bot.qq.com/wiki/develop/api-v2/dev-prepare/event-emit/webhook.html /// /// 注意:sign.html DEMO 中的 sig(865ad13a…)与其展示的 secret/body 并不自洽, /// 用同一 secret 对 "timestamp + body" 实签得到的是 2eb9983e…。 /// 因此验签正例改用「自签往返」,另有 DocumentedDemoSignature_IsNotReproducible 记录该差异。 /// 密钥派生、op=13 验证签名仍以官方 DEMO 为准(均可精确复现)。 /// public sealed class WebhookSignatureVerifierTests { private const string Secret = "naOC0ocQE3shWLAfffVLB1rhYPG7"; private const string OfficialSeed = "naOC0ocQE3shWLAfffVLB1rhYPG7naOC"; private const string Body = "{ \"op\": 0,\"d\": {}, \"t\": \"GATEWAY_EVENT_NAME\"}"; private const string Timestamp = "1725442341"; private const string DocumentedDemoSignature = "865ad13a61752ca65e26bde6676459cd36cf1be609375b37bd62af366e1dc25a8dc789ba7f14e017ada3d554c671a911bfdf075ba54835b23391d509579ed002"; private const string AppId = "11111111"; private static readonly byte[] OfficialPublicKey = [ 215, 195, 98, 254, 120, 174, 248, 31, 242, 50, 135, 180, 147, 98, 139, 93, 176, 42, 60, 79, 227, 11, 33, 94, 77, 25, 96, 155, 93, 118, 103, 58 ]; private static readonly DateTimeOffset EventTime = DateTimeOffset.FromUnixTimeSeconds(1725442341); private static WebhookSignatureVerifier Create(string secret = Secret, string appId = AppId, int maxAge = 300) => new(Options.Create(new QQBotOptions { Secret = secret, AppId = appId, SignatureMaxAgeSeconds = maxAge })); /// 用官方 DEMO 的 secret 对 "timestamp + body" 生成合法签名,供往返测试使用。 private static string SignBody(string body = Body) { Ed25519 ed25519 = new(); ed25519.FromSeed(WebhookSignatureVerifier.DeriveSeed(Secret)); byte[] signature = ed25519.SignMessage(Encoding.UTF8.GetBytes(Timestamp + body)); return Convert.ToHexString(signature).ToLowerInvariant(); } [Fact] public void DeriveSeed_MatchesOfficialDemo() { byte[] seed = WebhookSignatureVerifier.DeriveSeed(Secret); Assert.Equal(32, seed.Length); Assert.Equal(OfficialSeed, Encoding.UTF8.GetString(seed)); } [Fact] public void DerivePublicKey_MatchesOfficialDemo() => Assert.Equal(OfficialPublicKey, WebhookSignatureVerifier.DerivePublicKey(Secret)); [Fact] public void DocumentedDemoSignature_IsNotReproducible() => Assert.NotEqual(DocumentedDemoSignature, SignBody()); [Fact] public void RoundTrip_SignatureIsAccepted() { WebhookVerificationResult result = Create().Verify( SignBody(), Timestamp, AppId, Encoding.UTF8.GetBytes(Body), EventTime); Assert.True(result.IsValid, $"{result.Failure}: {result.Reason}"); } [Fact] public void TamperedBody_IsRejected() { byte[] body = Encoding.UTF8.GetBytes(Body.Replace("GATEWAY_EVENT_NAME", "GATEWAY_EVENT_OTHER")); WebhookVerificationResult result = Create().Verify(SignBody(), Timestamp, AppId, body, EventTime); Assert.False(result.IsValid); Assert.Equal(WebhookVerificationFailure.InvalidSignature, result.Failure); } [Fact] public void TamperedSignature_IsRejected() { string signature = SignBody(); string tampered = (signature[0] == '8' ? "7" : "8") + signature[1..]; WebhookVerificationResult result = Create().Verify( tampered, Timestamp, AppId, Encoding.UTF8.GetBytes(Body), EventTime); Assert.False(result.IsValid); Assert.Equal(WebhookVerificationFailure.InvalidSignature, result.Failure); } [Fact] public void MissingHeaders_AreRejected() { WebhookVerificationResult result = Create().Verify( null, null, AppId, Encoding.UTF8.GetBytes(Body), EventTime); Assert.Equal(WebhookVerificationFailure.MissingHeaders, result.Failure); } [Fact] public void MalformedSignature_IsRejected() { WebhookVerificationResult result = Create().Verify( "not-hex", Timestamp, AppId, Encoding.UTF8.GetBytes(Body), EventTime); Assert.Equal(WebhookVerificationFailure.MalformedSignature, result.Failure); } [Fact] public void ExpiredTimestamp_IsRejected() { WebhookVerificationResult result = Create().Verify( SignBody(), Timestamp, AppId, Encoding.UTF8.GetBytes(Body), EventTime.AddMinutes(30)); Assert.Equal(WebhookVerificationFailure.TimestampExpired, result.Failure); } [Fact] public void AppIdMismatch_IsRejected() { WebhookVerificationResult result = Create().Verify( SignBody(), Timestamp, "99999999", Encoding.UTF8.GetBytes(Body), EventTime); Assert.Equal(WebhookVerificationFailure.AppIdMismatch, result.Failure); } [Fact] public void MissingSecret_IsRejected() { WebhookVerificationResult result = Create(secret: "").Verify( SignBody(), Timestamp, AppId, Encoding.UTF8.GetBytes(Body), EventTime); Assert.Equal(WebhookVerificationFailure.MissingSecret, result.Failure); } [Fact] public void ValidationSignature_MatchesOfficialWebhookDemo() { // 官方 webhook.html:appid 11111111 / secret DG5g3B4j9X2KOErG const string secret = "DG5g3B4j9X2KOErG"; const string plainToken = "Arq0D5A61EgUu4OxUvOp"; const string eventTs = "1725442341"; const string expected = "87befc99c42c651b3aac0278e71ada338433ae26fcb24307bdc5ad38c1adc2d01bcfcadc0842edac85e85205028a1132afe09280305f13aa6909ffc2d652c706"; byte[] signature = WebhookSignatureVerifier.SignValidation(secret, eventTs, plainToken); Assert.Equal(expected, Convert.ToHexString(signature).ToLowerInvariant()); } } public sealed class QQBotOptionsTests { [Fact] public void Defaults_UseWebSocketSingleMode() { QQBotOptions options = new(); Assert.Equal(QQBotMode.WebSocket, options.Mode); Assert.False(options.EnableWebhook); Assert.Equal(100663296, options.Intents); } [Fact] public void ApiBaseAddress_ResolvesByEnvironment() { Assert.Equal("https://sandbox.api.sgroup.qq.com", new QQBotOptions().ResolvedApiBaseAddress); Assert.Equal("https://api.sgroup.qq.com", new QQBotOptions { Environment = QQBotEnvironment.Production }.ResolvedApiBaseAddress); Assert.Equal("https://example.test", new QQBotOptions { ApiBaseAddress = "https://example.test/" }.ResolvedApiBaseAddress); } }