萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET MVC 整合 SSO (Single Sign-On) 登入驗證實作

將原本本地登入頁面替換為企業級單一登入 (SSO) 驗證,核心邏輯為:Controller 呼叫 SSO 客戶端元件驗證身分,成功則取得身分識別碼 (工號) 並建立本地 Session,失敗則導向 SSO 登入頁。

實作步驟

1. 引入 SSO 客戶端程式庫

  • 取得廠商提供的 SingleSignOn.dll 或 NuGet 套件
  • 設定 SSO 伺服器端點 (SSOHost) 至 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>

2. Controller 實作登入動作

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);
    }
}

3. SSO 客戶端核心邏輯 (概念說明)

SingleSignOn.SignIn() 典型流程:

  1. 檢查 Request 中是否帶有 SSO Token (QueryString / Cookie / Header)
  2. 若有 Token → 驗證簽名、過期時間、AppId → 解析出 EmployeeId 回傳
  3. 若無 Token → 回傳 null,呼叫端負責導向 SSO 登入頁
  4. SSO 登入頁認證成功後,重導向回應用程式 Login Action 並附上 Token

Web.config 關鍵設定

<system.web>
  <authentication mode="Forms">
    <forms loginUrl="~/Account/Login" timeout="30" slidingExpiration="true" />
  </authentication>
  <authorization>
    <deny users="?" /> <!-- 拒絕匿名存取,強制登入 -->
  </authorization>
</system.web>

進階主題

  • 單一登出 (SLO): 登出時需呼叫 SSO 登出端點,清除所有子系統 Session。
  • Token 續期: 實作 IHttpModule 或 Middleware 自動刷新 Token。
  • 角色/權限同步: 登入後從 SSO 取得角色清單,映射至本地 Principal。
  • 現代替代方案: 採用 OpenID Connect / OAuth 2.0 標準協定 (IdentityServer4, Azure AD, Okta, Auth0),使用 Microsoft.AspNetCore.Authentication.OpenIdConnect 中介軟體,棄用私有 SSO 客戶端 DLL。

常見問題排查

現象可能原因解決
無限重導向SSO 回呼 URL 與註冊不符、Cookie 域名設定錯誤檢查 SSO 管理後台設定的 Callback URL、CookieDomain
SignIn() 永遠回傳 nullToken 參數名稱錯誤、SSL 憑證不信任導致驗證失敗抓包分析 Request 參數、確認伺服器信任根憑證
登出後仍可存取本地 FormsAuthentication Cookie 未清除、SLO 未觸發確認 FormsAuthentication.SignOut() 執行、瀏覽器清除 Cookie

整合 SSO 核心在於信任外部身分提供者,本地系統僅負責消費身分識別並建立應用層 Session,減少密碼管理風險,實現真正的單一登入體驗。

copyright © 萬盛學電腦網 all rights reserved