You need to enable JavaScript to run this app. .NET环境下如何对Discord交互Webhook的请求进行身份验证
优惠活动
大模型
产品
解决方案
定价
更多

.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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 14:33:02