如何在.NET6 C# API中集成CAS协议实现部分接口授权

1. 引入适配.NET6的CAS客户端包 #

通过NuGet安装支持.NET6的CAS客户端库，比如DotNetCasClient（确认选择支持.NET6的版本，如4.2.0及以上）：

Install-Package DotNetCasClient -Version 4.2.0

2. 配置CAS服务端参数 #

在appsettings.json中添加CAS服务端及客户端的核心配置：

"CasClient": {
  "CasServerUrlBase": "https://你的CAS服务端地址/cas/",
  "ClientUrlBase": "https://你的API域名/",
  "ValidationType": "Cas3", // 匹配CAS服务端的协议版本，如CAS3.0
  "TicketValidatorName": "Cas30",
  "CallbackPath": "/cas/callback" // 自定义回调路径，需确保CAS服务端已配置该回调地址
}

3. 注册CAS认证服务 #

在Program.cs中完成CAS认证服务的DI注册：

builder.Services.AddAuthentication(CasAuthenticationDefaults.AuthenticationScheme)
    .AddCas(options =>
    {
        builder.Configuration.Bind("CasClient", options);
    });

builder.Services.AddAuthorization();

4. 启用认证与授权中间件 #

在Program.cs的中间件管道中添加认证和授权逻辑，注意顺序要在路由之前：

app.UseAuthentication();
app.UseAuthorization();

// 后续的路由配置
app.MapControllers();

5. 为指定API接口添加CAS授权校验 #

单个接口/控制器授权 #

在需要CAS校验的Action或控制器上添加特性标记，未添加的接口默认不校验：

[ApiController]
[Route("api/[controller]")]
public class SecureDataController : ControllerBase
{
    // 该接口需要CAS授权
    [HttpGet("sensitive")]
    [Authorize(AuthenticationSchemes = CasAuthenticationDefaults.AuthenticationScheme)]
    public IActionResult GetSensitiveData()
    {
        var userName = User.Identity.Name;
        return Ok($"当前登录用户：{userName}，敏感数据已返回");
    }

    // 该接口无需授权
    [HttpGet("public")]
    [AllowAnonymous]
    public IActionResult GetPublicData()
    {
        return Ok("公开数据已返回");
    }
}

批量路由授权（可选） #

如果需要对某一路径下的所有接口统一启用CAS校验，可通过路由策略配置：

app.MapControllers()
    .RequireAuthorization(new AuthorizeAttribute
    {
        AuthenticationSchemes = CasAuthenticationDefaults.AuthenticationScheme
    })
    .AddRoutePattern("/api/secure/{**catchall}");

上述配置会让/api/secure路径下的所有接口自动触发CAS授权校验，其他路径接口不受影响。

6. 注意事项 #

• 确保CAS服务端已将API的回调路径加入白名单，避免回调失败
• 若API为无状态服务，可结合CAS客户端的会话配置，或后续将CAS身份转换为JWT令牌实现无状态认证
• 测试时先验证CAS服务端的登录流程是否正常，再联调API的授权逻辑

内容的提问来源于stack exchange，提问作者SauroDino