Web 开发：使用 Ocelot+Nacos+WebApi 实现网关鉴权 | 极客日志

Web 开发：使用 Ocelot+Nacos+WebApi 实现网关鉴权

在 .NET WebAPI 项目中集成 Ocelot 网关与 Nacos 服务发现的配置方法，并通过自定义认证处理器实现简单的 Token 鉴权。内容涵盖 NuGet 包依赖管理、配置文件编写、Program.cs 启动项设置、自定义 Token 校验逻辑及后端获取用户信息的方式。

芝士奶盖发布于 2026/3/29更新于 2026/4/185 浏览

一、NuGet 包

注意：请根据实际 .NET 版本调整包兼容性，版本过大或过小可能导致 WebAPI 无法运行。

二、配置文件

1. appsettings.json

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "Nacos": {
    "ServerAddresses": [ "http://localhost:8848/" ],
    "Namespace": "",
    "UserName": "nacos",
    "Password": "nacos",
    "ContextPath": "/nacos",
    "LogLevel": "Debug"

相关免费在线工具

Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online
Markdown转HTML
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。在线工具，Markdown转HTML在线工具，online
HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。在线工具，HTML转Markdown在线工具，online
JSON 压缩
通过删除不必要的空白来缩小和压缩JSON。在线工具，JSON 压缩在线工具，online
JSON美化和格式化
将JSON字符串修饰为友好的可读格式。在线工具，JSON美化和格式化在线工具，online

{
  "Routes": [
    {
      "DownstreamPathTemplate": "/api/{catchAll}",
      "UpstreamPathTemplate": "/api/{catchAll}",
      "UpstreamHttpMethod": [ "GET", "POST", "PUT", "DELETE" ],
      "DownstreamScheme": "http",
      "UseServiceDiscovery": true,
      "ServiceName": "GuangDongData",
      "NacosNamespace": "public",
      "NacosGroupName": "DEFAULT_GROUP",
      "GroupName": "DEFAULT_GROUP",
      "AuthenticationOptions": {
        "AuthenticationProviderKey": "CustomGuidToken",
        "AllowedScopes": []
      },
      "LoadBalancerOptions": {
        "Type": "RoundRobin",
        "Key": "GuangDongData",
        "Expiry": 30000
      }
    }
  ],
  "GlobalConfiguration": {
    "ServiceDiscoveryProvider": {
      "Type": "Nacos"
    }
  }
}

using Auth.StaticVar;
using Microsoft.AspNetCore.Authentication;
using Microsoft.AspNetCore.OpenApi;
using Nacos.V2;
using Ocelot.DependencyInjection;
using Ocelot.Middleware;
using Ocelot.Provider.Nacos;

var builder = WebApplication.CreateBuilder(args);

// 1. 加载 Ocelot 配置
builder.Configuration.AddJsonFile("ocelot.json", optional: false, reloadOnChange: true);

// 2. 加载 Nacos 配置
builder.Services.AddOcelot().AddNacosDiscovery();

// 3. 自定义鉴权
builder.Services.AddAuthentication("CustomGuidToken")
    .AddScheme<AuthenticationSchemeOptions, CustomGuidTokenHandler>("CustomGuidToken", options => { });

builder.Services.AddControllers();
builder.Services.AddSwaggerGen(options => {
    options.SwaggerDoc("v1", new() {
        Title = "API",
        Version = "v1",
        Description = "文档示例"
    });
});

var app = builder.Build();
PubliVar.IsDevelopment = app.Environment.IsDevelopment();

if (app.Environment.IsDevelopment()) {
    app.UseSwagger();
    app.UseSwaggerUI(options => {
        options.SwaggerEndpoint("/swagger/v1/swagger.json", "你的 API v1");
        options.RoutePrefix = string.Empty;
    });
}

// 4. 认证
app.UseAuthentication();
app.UseAuthorization();

// 5. 启用 Ocelot 网关
await app.UseOcelot();
app.MapControllers();
app.Run();

using Microsoft.AspNetCore.Authentication;
using Microsoft.Extensions.Options;
using Nacos;
using System.Security.Claims;
using System.Text.Encodings.Web;
using System.Text.Json;

/// <summary>
/// 自定义认证处理器：校验请求头中的 token 是否等于写死的 GUID
/// </summary>
public class CustomGuidTokenHandler : AuthenticationHandler<AuthenticationSchemeOptions>
{
    // 写死的 GUID Token
    private const string FixedGuidToken = "f0e92635-5141-4ce2-9690-563ca18fdd3d";

    public CustomGuidTokenHandler(IOptionsMonitor<AuthenticationSchemeOptions> options, ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock)
        : base(options, logger, encoder, clock)
    {
    }

    /// <summary>
    /// 核心认证逻辑：校验 token
    /// </summary>
    protected async override Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        try
        {
            // 1. 从请求头获取 token
            var authHeader = Request.Headers["Authorization"].FirstOrDefault();

            // 无 token，认证失败
            if (string.IsNullOrEmpty(authHeader))
            {
                Response.StatusCode = StatusCodes.Status401Unauthorized;
                Response.ContentType = "application/json";
                var error = JsonSerializer.Serialize(new { code = 401, message = "认证失败：未提供有效 Token" });
                await Response.WriteAsync(error);
                return AuthenticateResult.Fail("未提供 Token");
            }

            // 2. 解析 token（兼容两种格式：带 Bearer 前缀/不带）
            string token = authHeader.StartsWith("Bearer ") ? authHeader.Substring("Bearer ".Length).Trim() : authHeader.Trim();

            // 3. 校验 token 是否等于写死的 GUID
            if (token != FixedGuidToken)
            {
                Response.StatusCode = StatusCodes.Status401Unauthorized;
                Response.ContentType = "application/json";
                var error = JsonSerializer.Serialize(new { code = 401, message = "认证失败：提供了无效的 Token" });
                await Response.WriteAsync(error);
                return AuthenticateResult.Fail("无效 Token");
            }

            // 4. 认证通过，构建用户身份
            var claims = new List<Claim> {
                new Claim(ClaimTypes.Name, "ValidUser"),
                new Claim(ClaimTypes.Role, "ApiAccess")
            };
            var identity = new ClaimsIdentity(claims, Scheme.Name);
            var principal = new ClaimsPrincipal(identity);
            var ticket = new AuthenticationTicket(principal, Scheme.Name);

            Context.Request.Headers["X-Custom-UserName"] = "ValidUser";
            Context.Request.Headers["X-Custom-UserRole"] = "ApiAccess";

            return await Task.FromResult(AuthenticateResult.Success(ticket));
        }
        catch (Exception ex)
        {
            return await Task.FromResult(AuthenticateResult.Fail($"认证异常：{ex.Message}"));
        }
    }
}

// 如果只是鉴权的，直接返回给客户端
if (Request.Path.ToString().StartsWith("/api/Auth"))
{
    // 直接向客户端返回 200+ 自定义成功 JSON
    Response.StatusCode = StatusCodes.Status200OK;
    Response.ContentType = "application/json";
    var success = JsonConvert.SerializeObject(new { code = 200, message = "Token 验证通过，登录成功！", isValid = true });
    await Response.WriteAsync(success);
    // 返回 Success 终止后续认证流程
    return AuthenticateResult.Success(new AuthenticationTicket(new ClaimsPrincipal(), Scheme.Name));
}

Web 开发：使用 Ocelot+Nacos+WebApi 实现网关鉴权

一、NuGet 包

二、配置文件

1. appsettings.json

更多推荐文章

相关免费在线工具

2. ocelot.json

3. Program.cs

三、鉴权认证代码

1. 基础代码

2. 简单登录演示（简单鉴权）

四、后端获取用户相关信息

Web 开发：使用 Ocelot+Nacos+WebApi 实现网关鉴权

一、NuGet 包

二、配置文件

1. appsettings.json

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

2. ocelot.json

3. Program.cs

三、鉴权认证代码

1. 基础代码

2. 简单登录演示（简单鉴权）

四、后端获取用户相关信息