diff --git a/src/YhCore.WebApi/Auth/Cas/CasAuthenticationHandler.cs b/src/YhCore.WebApi/Auth/Cas/CasAuthenticationHandler.cs
index 94c11a4..4bac20d 100644
--- a/src/YhCore.WebApi/Auth/Cas/CasAuthenticationHandler.cs
+++ b/src/YhCore.WebApi/Auth/Cas/CasAuthenticationHandler.cs
@@ -19,14 +19,16 @@ namespace YhCore.WebApi.Auth
/// - Challenge:302 到 CAS 登录页,service = {AppBaseUrl}{当前 path}[?除 ticket 外 query],即原访问 URL,
/// 与 Java notice 的 service 形态一致(service=http://host/module/api/xxx);AppBaseUrl 含模块前缀
/// (如 /docprint)时拼接结果天然带模块名。显式回跳语境(前端 yschreferer/Referer 携带页面地址)时
- /// 在该 service 上追加 query 参数 redirectToReferer=<hex(回跳地址)> 携带「登录后回页面」信息——
- /// 不再以 {SignInCallbackPath} 回调端点作 service(signin-cas 形态已弃用);hex 按 char 维度编码
- /// (对齐前端 strToHexCharCode / Java HexUtils),避免 query 内嵌完整 URL 需多层 urlencode。
- /// ASP.NET Core 无 Java 路径矩阵参数机制,回跳目标只能放 query。
+ /// 把回跳地址以 Java notice 同款分号矩阵段插入 path 与 query 之间:
+ /// {path};redirectToReferer=<hex(回跳地址)>[?{原 query}]——不再以 {SignInCallbackPath} 回调端点作
+ /// service(signin-cas 形态已弃用);hex 按 char 维度编码(对齐前端 strToHexCharCode / Java HexUtils),
+ /// 分号段不参与 query 结构,含中文/特殊字符的页面地址也可无歧义承载。ASP.NET Core 对回调中分号段
+ /// 的处理:带 ticket 校验成功后由中间件短路(不落 MVC 路由),路径分号段仅用于解析回跳目标。
/// - Authenticate:任意受保护路径带 ticket 的回调均按「path + 除 ticket 外的 query」重建 service
- /// 调 /serviceValidate 校验(service 即登录时的原访问 URL,CAS 在末尾追加 ?ticket=/&ticket= 回跳)。
- /// 成功后写入 Cookie 登录态并 302 到 redirectToReferer(hex 解码,当前形态)/ returnUrl(旧中继形态
- /// 兼容)/ 原 URL 去 ticket 版(无回跳目标),兼容更早的 ;redirectToReferer=<hex> 路径段形态。
+ /// 调 /serviceValidate 校验(service 即登录时的原访问 URL,含分号段则一并重建,CAS 在末尾追加
+ /// ?ticket=/&ticket= 回跳)。成功后写入 Cookie 登录态并 302 到分号段 redirectToReferer(hex 解码,
+ /// 当前形态)/ query redirectToReferer(旧 query 形态兼容)/ returnUrl(更早中继形态兼容)/
+ /// 原 URL 去 ticket 版(无回跳目标)。
///
///
public class CasAuthenticationHandler : AuthenticationHandler
@@ -36,7 +38,8 @@ namespace YhCore.WebApi.Auth
/// 旧中继形态(service={回调端点}?returnUrl=…)的回跳参数——已弃用,仅兼容历史 URL/缓存。
private const string ReturnUrlParam = "returnUrl";
- /// 当前形态回跳参数:service=原访问 URL 时追加 ?redirectToReferer=<hex(回跳地址)>,登录后 CAS 原样回带。
+ /// 旧 query 形态(service=原访问 URL?redirectToReferer=<hex>,986b241 曾用)的回跳参数——
+ /// 已改分号矩阵段承载,此处仅兼容读取历史 URL/缓存。
private const string RedirectToRefererQueryParam = "redirectToReferer";
private readonly CasServiceTicketValidator _validator;
@@ -128,13 +131,18 @@ namespace YhCore.WebApi.Auth
else
{
// 显式回跳语境(前端 yschreferer 携带页面地址等):service 仍 = 原访问 URL(notice 形态,
- // 不再以 {SignInCallbackPath} 回调端点作 service),仅追加 query 参数
- // redirectToReferer= 携带「登录后回页面」信息——CAS 会把它作为 service 一部分
- // 在回调时原样带回,本 handler 校验成功后 hex 解码即得回跳目标。hex 按 char 维度编码,避免
- // query 内嵌完整 URL 需多层 urlencode(对齐前端 strToHexCharCode / Java HexUtils)。
+ // 不再以 {SignInCallbackPath} 回调端点作 service),把回跳地址以 Java notice 同款的分号矩阵段
+ // 形式插入 path 与 query 之间:{path};redirectToReferer=[?{原 query}]——CAS 会把它作为
+ // service 一部分在回调时原样带回,本 handler 校验成功后由 ParseRedirectToReferer 从路径段
+ // hex 解码即得回跳目标(query 形态 ?redirectToReferer= 的旧 URL/缓存仍兼容读取)。
+ // hex 按 char 维度编码(对齐前端 strToHexCharCode / Java HexUtils);分号段内不参与 query 结构,
+ // 含中文/特殊字符的页面地址也可无歧义承载。
service = BuildServiceUrlFromRequest();
- service += (service.IndexOf('?') < 0 ? "?" : "&")
- + RedirectToRefererQueryParam + "=" + HexEncode(target);
+ var q = service.IndexOf('?');
+ var segment = RedirectToRefererMarker + HexEncode(target);
+ service = q < 0
+ ? service + segment
+ : service.Substring(0, q) + segment + service.Substring(q);
}
// Uri.EscapeDataString 会把 ; / : = 全部编码(%3B/%2F/%3A/%3D),与平台旧版系统生成的
// CAS 登录 URL 逐字节一致(UrlEncoder.Encode 会保留 ; 字面量)
diff --git a/src/YhCore.WebApi/Middleware/SsoProtectionMiddleware.cs b/src/YhCore.WebApi/Middleware/SsoProtectionMiddleware.cs
index 2e853d1..3192158 100644
--- a/src/YhCore.WebApi/Middleware/SsoProtectionMiddleware.cs
+++ b/src/YhCore.WebApi/Middleware/SsoProtectionMiddleware.cs
@@ -111,8 +111,9 @@ namespace YhCore.WebApi.Middleware
///
/// 触发 Challenge 生成 CAS 登录地址(service 构造由本地化 CasAuthenticationHandler 完成:
- /// service 恒为原访问 URL(notice 形态);显式回跳(yschreferer/Referer)时仅在其上追加
- /// redirectToReferer=<hex> query,不再以 SignInCallbackPath 回调端点作 service)。
+ /// service 恒为原访问 URL(notice 形态);显式回跳(yschreferer/Referer)时以 Java notice 同款
+ /// 分号矩阵段 ;redirectToReferer=<hex> 插入 path 与 query 之间,不再以 SignInCallbackPath
+ /// 回调端点作 service)。
/// 受保护 API 的 AJAX/XHR 请求:拦截框架写入的 302 + Location,改写为 200 + JSON,避免 XHR
/// 跟随跨域 302 跳转 CAS 登录页时被 CORS 拦截;文档导航 / 根路径 / 回调仍保持 302。
///
@@ -127,9 +128,9 @@ namespace YhCore.WebApi.Middleware
// (null)→ handler 以纯净"原访问 URL"作 service(notice 形态 service=http://host/module/api/xxx),
// 登录后 CAS 回跳原 URL+ticket,由 handler 校验并 302 去掉 ticket 落回原地址;
// - 显式回跳语境(前端 yschreferer 打标携带页面地址 / Referer):回跳目标 = 页面地址,
- // handler 仍以原访问 URL 作 service 主体并追加 ?redirectToReferer=<hex(目标)> 携带回页面
- // 信息(ASP.NET Core 无 Java 路径矩阵参数机制,只能放 query)——前端登录后回到所在页面
- // 而非接口本身;
+ // handler 仍以原访问 URL 作 service 主体,并把目标以分号矩阵段 ;redirectToReferer=<hex>
+ // 插入 path 与 query 之间(与 Java notice 同款;分号段不参与 query 结构,目标含中文/特殊
+ // 字符也无歧义)——前端登录后回到所在页面而非接口本身;
// - 回调路径直访防呆(访问的恰是回调端点自身且无 ticket 未认证、无打标):回 "/",
// 避免登录后回跳回调自身再触发 Challenge(前端打标场景仍回前端页——回调路径本身常是前端
// 登录检测接口 /api/base/GetUserInfo,必须回到用户所在页面)。