.NET环境下如何对Discord交互Webhook的请求进行身份验证
.NET 5.0 实现Discord Webhook请求签名验证方案
第一步:安装依赖包
.NET 5没有内置Ed25519签名验证实现,我们可以使用官方Node.js示例同款的TweetNaCl库的.NET端口,直接通过NuGet安装:
Install-Package TweetNaCl
如果要使用更符合.NET生态的高性能库,也可以选择NSec.Cryptography。
第二步:核心验证逻辑实现
验证逻辑和官方示例完全对齐,代码如下:
using System; using System.Text; using Microsoft.AspNetCore.Http; using TweetNaCl; public static class DiscordSignatureVerifier { // 替换为你在Discord开发者后台拿到的公钥 private const string PublicKey = "你的APPLICATION_PUBLIC_KEY"; public static bool VerifyRequest(HttpRequest req) { // 1. 读取请求头必填参数 if (!req.Headers.TryGetValue("X-Signature-Ed25519", out var signatureHeader) || !req.Headers.TryGetValue("X-Signature-Timestamp", out var timestampHeader)) { return false; } string signature = signatureHeader.ToString(); string timestamp = timestampHeader.ToString(); // 2. 读取原始请求体(注意需要先开启请求体缓冲,否则只能读取一次) req.EnableBuffering(); using var reader = new System.IO.StreamReader(req.Body, Encoding.UTF8, leaveOpen: true); string rawBody = reader.ReadToEndAsync().Result; req.Body.Position = 0; // 重置Body位置,后续中间件/Action可以正常读取 // 3. 格式转换 byte[] message = Encoding.UTF8.GetBytes(timestamp + rawBody); byte[] signatureBytes = Convert.FromHexString(signature); byte[] publicKeyBytes = Convert.FromHexString(PublicKey); // 4. Ed25519分离签名验证 return Crypto.SignDetachedVerify(message, signatureBytes, publicKeyBytes); } }
第三步:接口中使用示例
在你的Webhook接口逻辑里调用验证方法即可:
[ApiController] [Route("api/discord/webhook")] public class DiscordWebhookController : ControllerBase { [HttpPost] public IActionResult Process() { if (!DiscordSignatureVerifier.VerifyRequest(Request)) { return StatusCode(401, "invalid request signature"); } // 验证通过,后续业务逻辑 return Ok(); } }
注意事项
- 公钥请从Discord开发者后台你的应用详情页获取,不要硬编码到代码里,推荐用配置中心或者环境变量存储
- 如果是用
NSec.Cryptography实现,替换验证部分的代码即可,逻辑完全一致 - .NET 5的
Convert.FromHexString对十六进制字符串的大小写不敏感,不需要额外做格式转换
内容的提问来源于stack exchange,提问作者JKasper11
相关产品推荐
相关产品推荐

