using System;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Authentication;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using Yh.Platform.Auth;
namespace YhCore.WebApi.Middleware
{
///
/// SSO 路径保护中间件(对应 Java yh-auth-spring-boot-starter 的 /api/* 保护行为)。
/// 规则(对齐 yh:sso 配置节):
/// - yh:sso:enabled=false(默认):所有路径匿名放行,不影响开发联调;
/// - yh:sso:enabled=true:匹配 /api/* / /mobiapi/* / 根路径(/, 浏览器 SSO 入口) 且未认证的请求
/// → Challenge → Yh.Platform.Auth CasAuthenticationHandler 302 重定向到 CAS 登录页;
/// - CAS 回调路径(yh:sso:signInCallbackPath,默认 /signin-cas)未认证时同样 Challenge:
/// 直接访问回调(无 ticket)进入登录流程;携带失效/已消费 ticket 的回调则返回 401 错误页,
/// 不再次 Challenge——避免“回调→登录→新票据→再失败”无限重定向循环(自动登录型 CAS 下必现);
/// 回调校验成功(已认证 + 302)则短路管道,防止 MVC 端点匹配 404 覆盖 handler 的回跳 302;
/// - Swagger 路径始终放行,方便本地接口调试;
/// - /oapi 开放渠道始终放行:其准入由 AppAuthMiddleware 签名验签负责(X-App-Key / X-Timestamp /
/// X-Signature 票据),无需用户登录态,SSO 登录保护永不覆盖该渠道(即使 yh:sso:urlPattern 误配
/// /oapi/* 也不拦截),保证应用间调用不受浏览器登录流程影响。
/// 调用方:Startup.Configure 中 UseAuthentication + UseYhUserContext 之后、UseAuthorization 之前。
///
public class SsoProtectionMiddleware
{
private readonly RequestDelegate _next;
private readonly IConfiguration _configuration;
public SsoProtectionMiddleware(RequestDelegate next, IConfiguration configuration)
{
_next = next;
_configuration = configuration;
}
public async Task InvokeAsync(HttpContext context)
{
var sso = _configuration.GetSection("yh:sso");
var isSwaggerPath = context.Request.Path.StartsWithSegments("/swagger");
var isOapiPath = context.Request.Path.StartsWithSegments("/oapi");
var isRootEntry = context.Request.Path == "/";
var isCasCallback = context.Request.Path.StartsWithSegments(sso["signInCallbackPath"] ?? "/signin-cas");
// 已认证(含 Cookie 恢复登录态)直接放行
if (context.User?.Identity?.IsAuthenticated == true)
{
// 回调路径刚完成票据校验:CasAuthenticationHandler 已写入 Cookie 并 Response.Redirect(302 + Location),
// 但 handler 返回 NoResult 不短路管道——若继续 _next 走 MVC 端点匹配,/signin-cas 无对应 action,
// 会返回 404 覆盖 302,浏览器看到"登录成功却 404"。此处已认证 + 已 302 即短路,保住回跳响应。
if (isCasCallback && context.Response.StatusCode == 302 &&
!string.IsNullOrEmpty(context.Response.Headers["Location"]))
{
return;
}
await _next(context);
return;
}
// oapi 开放渠道:无需用户登录,准入由 AppAuthMiddleware 签名验签负责(票据 = 签名头),
// 未带票据的请求由 AppAuthMiddleware 返回 401(而非 SSO 302),保证直接访问语义。
if (isOapiPath)
{
await _next(context);
return;
}
var enabled = sso["enabled"] != null
? bool.TryParse(sso["enabled"], out var en) && en
: _configuration.GetValue("Yh:Sso:Enabled", false);
if (enabled && !isSwaggerPath &&
(isRootEntry || isCasCallback || IsProtectedPath(context.Request.Path.Value, sso)))
{
// 请求携带 ticket 却仍未认证 → 说明 CAS 票据校验失败(一次性票据已被消费/过期,
// 或 service 与服务端登记不一致)。此时若再次 Challenge,自动登录型 CAS 会立刻签发
// 新票据跳回 → 再次失败 → 无限重定向循环。直接返回 401 错误页(带重新登录入口)打破循环。
if (context.Request.Query.ContainsKey("ticket"))
{
context.Response.StatusCode = 401;
context.Response.ContentType = "text/html; charset=utf-8";
await context.Response.WriteAsync(
"
登录失效" +
"" +
"登录票据校验失败或已过期
" +
"CAS 登录票据为一次性凭证,刷新或重复使用同一地址会导致校验失败。
" +
"重新登录
");
return;
}
// 未认证 → Challenge → 302 重定向 CAS 登录页(ticket 校验与回跳由新框架 CasAuthenticationHandler 处理)
await context.ChallengeAsync(YhAuthDefaults.CasScheme);
return;
}
await _next(context);
}
/// 路径是否命中保护模式(yh:sso:urlPattern / yh:sso:mobiApiPattern,默认 /api/*、/mobiapi/*,通配后缀匹配,忽略大小写)
private static bool IsProtectedPath(string path, IConfigurationSection sso)
{
if (string.IsNullOrEmpty(path))
{
return false;
}
var urlPattern = sso["urlPattern"] ?? "/api/*";
var mobiPattern = sso["mobiApiPattern"] ?? "/mobiapi/*";
return MatchesPattern(path, urlPattern) || MatchesPattern(path, mobiPattern);
}
private static bool MatchesPattern(string path, string pattern)
{
if (string.IsNullOrEmpty(pattern) || string.IsNullOrEmpty(path))
{
return false;
}
// 形如 /api/* → 前缀匹配;否则精确匹配(忽略大小写)
if (pattern.EndsWith("/*", StringComparison.Ordinal))
{
var prefix = pattern.Substring(0, pattern.Length - 1); // 去掉 *
return path.StartsWith(prefix, StringComparison.OrdinalIgnoreCase);
}
return path.Equals(pattern, StringComparison.OrdinalIgnoreCase);
}
}
}