萬盛學電腦網

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

ASP.NET 搭配 jQuery AJAX 實作使用者登入 (含前後端完整代碼)

以傳統 ASP.NET WebForms (`.aspx`) 搭配 jQuery `$.ajax` 實作無重整登入,展示前端表單驗證、後端驗證邏輯、JSON 回應、錯誤處理與安全性考量 (防 CSRF、密碼雜湊)。本文提供可直接執行的最小化完整範例。

專案結構

/Login.aspx          前端頁面
/Login.aspx.cs       後端處理 (PageMethod / WebMethod)
/Services/AuthService.asmx  獨立 Web Service (替代方案)
/App_Code/DAL.cs     資料存取層
/App_Code/BLL.cs     業務邏輯層

前端頁面 (Login.aspx)

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Login.aspx.cs" Inherits="Demo.Login" %>
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>AJAX 登入示範</title>
    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <style>
        .field { margin: 8px 0; }
        .error { color: red; }
        .success { color: green; }
    </style>
</head>
<body>
    <h2>使用者登入</h2>
    <div class="field">
        <label>帳號:</label>
        <input type="text" id="txtUser" autocomplete="username" />
    </div>
    <div class="field">
        <label>密碼:</label>
        <input type="password" id="txtPwd" autocomplete="current-password" />
    </div>
    <button id="btnLogin" type="button">登入</button>
    <button id="btnClear" type="button">清空</button>
    <span id="msg" class="error"></span>

    <script>
        $(function() {
            $("#btnClear").click(() => { $("#txtUser, #txtPwd").val(""); $("#msg").text(""); });

            $("#btnLogin").click(function() {
                var $btn = $(this).prop("disabled", true);
                var user = $("#txtUser").val().trim();
                var pwd = $("#txtPwd").val();

                if (!user || !pwd) {
                    $("#msg").text("請輸入帳號密碼");
                    $btn.prop("disabled", false);
                    return;
                }

                $.ajax({
                    url: "Login.aspx/DoLogin", // PageMethod
                    type: "POST",
                    contentType: "application/json; charset=utf-8",
                    dataType: "json",
                    data: JSON.stringify({ username: user, password: pwd }),
                    success: function(resp) {
                        var result = resp.d; // ASP.NET PageMethod 包裝層
                        if (result.Success) {
                            $("#msg").removeClass("error").addClass("success").text(result.Message);
                            setTimeout(() => location.href = "Default.aspx", 800);
                        } else {
                            $("#msg").removeClass("success").addClass("error").text(result.Message);
                        }
                    },
                    error: function(xhr) {
                        $("#msg").text("系統錯誤:" + xhr.statusText);
                    },
                    complete: function() { $btn.prop("disabled", false); }
                });
            });
        });
    </script>
</body>
</html>

後端 PageMethod (Login.aspx.cs)

[System.Web.Services.WebMethod]
public static LoginResult DoLogin(string username, string password) {
    try {
        // 1. 輸入驗證
        if (string.IsNullOrWhiteSpace(username) || string.IsNullOrWhiteSpace(password))
            return new LoginResult { Success = false, Message = "參數不可為空" };

        // 2. 呼叫 BLL 驗證 (此處示範直接查詢)
        var bll = new BLL();
        bool valid = bll.ValidateUser(username, password);

        // 3. 登入成功:建立 FormsAuthentication Ticket
        if (valid) {
            FormsAuthentication.SetAuthCookie(username, false); // 持久化由表單決定
            return new LoginResult { Success = true, Message = "登入成功" };
        }
        return new LoginResult { Success = false, Message = "帳號或密碼錯誤" };
    } catch (Exception ex) {
        // 記錄完整堆疊至 Log,前端只回通用訊息
        Log.Error(ex, "登入異常");
        return new LoginResult { Success = false, Message = "系統忙碌中,請稍後再試" };
    }
}

public class LoginResult {
    public bool Success { get; set; }
    public string Message { get; set; }
}

資料存取與業務邏輯 (DAL / BLL)

// DAL.cs
public class UserDAL {
    readonly string _connStr = ConfigurationManager.ConnectionStrings["Default"].ConnectionString;
    public UserDto GetByUsername(string username) {
        const string sql = "SELECT UserId, Username, PasswordHash, Salt FROM Users WHERE Username=@u";
        using (var conn = new SqlConnection(_connStr))
        using (var cmd = new SqlCommand(sql, conn)) {
            cmd.Parameters.AddWithValue("@u", username);
            conn.Open();
            using (var rd = cmd.ExecuteReader()) {
                if (rd.Read()) return new UserDto {
                    UserId = rd.GetInt32(0),
                    Username = rd.GetString(1),
                    PasswordHash = rd.GetString(2),
                    Salt = rd.GetString(3)
                };
            }
        }
        return null;
    }
}

// BLL.cs
public class BLL {
    private readonly UserDAL _dal = new UserDAL();
    public bool ValidateUser(string username, string password) {
        var user = _dal.GetByUsername(username);
        if (user == null) return false;
        // 驗證密碼雜湊 (PBKDF2/BCrypt/Argon2)
        return PasswordHasher.Verify(password, user.PasswordHash, user.Salt);
    }
}

安全性強化重點

  1. 密碼雜湊:絕不儲存明文,使用 BCrypt / PBKDF2 / Argon2,含 Salt。
  2. 防 CSRF:PageMethod 需驗證 `__RequestVerificationToken`,或改用 MVC `AntiForgeryToken`。
  3. HTTPS 強制:登入傳輸必須加密,`web.config` 設 `requireSSL="true"`。
  4. 失敗鎖定:記錄失敗次數,超過閾值暫時鎖定帳號/IP。
  5. 錯誤訊息統一:不洩露「帳號不存在」vs「密碼錯誤」,統一回「帳號或密碼錯誤」。

替代方案:獨立 ASMX Web Service

若不想用 PageMethod,可建立 `AuthService.asmx`:

[WebService(Namespace = "https://tempuri.org/")]
[ScriptService] // 允許 JSON 呼叫
public class AuthService : WebService {
    [WebMethod(EnableSession = true)]
    public LoginResult Login(string username, string password) { /* 同 DoLogin 邏輯 */ }
}

前端 URL 改為 `"AuthService.asmx/Login"`,其餘相同。

此架構清晰分離關注點,易於單元測試 (BLL/DAL 可 Mock),並可平滑遷移至 ASP.NET Core / Web API。

copyright © 萬盛學電腦網 all rights reserved