將原本本地登入頁面替換為企業級單一登入 (SSO) 驗證,核心邏輯為:Controller 呼叫 SSO 客戶端元件驗證身分,成功則取得身分識別碼 (工號) 並建立本地 Session,失敗則導向 SSO 登入頁。
SingleSignOn.dll 或 NuGet 套件web.config:<appSettings>
<add key="SSO_Host" value="https://sso.company.com" />
<add key="SSO_AppId" value="YOUR_APP_ID" />
<add key="SSO_AppSecret" value="YOUR_APP_SECRET" />
</appSettings>
using SSOClient; // 假設命名空間
public class AccountController : Controller
{
private readonly SingleSignOn _sso = new SingleSignOn
{
SSOHost = ConfigurationManager.AppSettings["SSO_Host"],
AppId = ConfigurationManager.AppSettings["SSO_AppId"],
AppSecret = ConfigurationManager.AppSettings["SSO_AppSecret"]
};
public ActionResult Login()
{
// 1. 嘗試自動登入 (檢查 SSO Token、Cookie 等)
string identity = _sso.SignIn();
if (!string.IsNullOrEmpty(identity))
{
// 2. 登入成功:建立本地 FormsAuthentication Ticket
FormsAuthentication.SetAuthCookie(identity, false); // false = 不持久 Cookie
// 3. 可選:同步使用者資訊至本地 DB/Session
SyncUserProfile(identity);
return RedirectToAction("Index", "Home");
}
else
{
// 4. 登入失敗/未登入:導向 SSO 統一登入頁
// SignIn() 內部通常已處理重導向,這行理論上不會執行到
return Redirect(_sso.GetLoginUrl(Url.Action("Login", "Account", null, Request.Url.Scheme)));
}
}
public ActionResult Logout()
{
FormsAuthentication.SignOut();
// 同時登出 SSO (單一登出 SLO)
string ssoLogoutUrl = _sso.GetLogoutUrl(Url.Action("Login", "Account", null, Request.Url.Scheme));
return Redirect(ssoLogoutUrl);
}
private void SyncUserProfile(string employeeId)
{
// 呼叫 SSO API 或本地服務取得使用者詳細資料,存入 Session/DB
Session["UserName"] = GetUserNameFromSSO(employeeId);
Session["DeptId"] = GetDeptIdFromSSO(employeeId);
}
}
SingleSignOn.SignIn() 典型流程:
Login Action 並附上 Token<system.web>
<authentication mode="Forms">
<forms loginUrl="~/Account/Login" timeout="30" slidingExpiration="true" />
</authentication>
<authorization>
<deny users="?" /> <!-- 拒絕匿名存取,強制登入 -->
</authorization>
</system.web>
IHttpModule 或 Middleware 自動刷新 Token。Principal。Microsoft.AspNetCore.Authentication.OpenIdConnect 中介軟體,棄用私有 SSO 客戶端 DLL。| 現象 | 可能原因 | 解決 |
|---|---|---|
| 無限重導向 | SSO 回呼 URL 與註冊不符、Cookie 域名設定錯誤 | 檢查 SSO 管理後台設定的 Callback URL、CookieDomain |
| SignIn() 永遠回傳 null | Token 參數名稱錯誤、SSL 憑證不信任導致驗證失敗 | 抓包分析 Request 參數、確認伺服器信任根憑證 |
| 登出後仍可存取 | 本地 FormsAuthentication Cookie 未清除、SLO 未觸發 | 確認 FormsAuthentication.SignOut() 執行、瀏覽器清除 Cookie |
整合 SSO 核心在於信任外部身分提供者,本地系統僅負責消費身分識別並建立應用層 Session,減少密碼管理風險,實現真正的單一登入體驗。