在構建現代Web套用時，許可權控制是確保系統安全性的關鍵一環。ASP.NET Core框架提供了強大的工具集，其中基於JWT（Json Web Token）的認證機制是實作許可權控制的常用方法。本文將詳細解析如何在ASP.NET Core中使用JWT Token進行許可權控制，並透過程式碼範例展示實作過程。
一、JWT Token簡介
JWT是一種開放標準（RFC 7519），它定義了一種緊湊的、自包含的方式，用於在各方之間安全地傳輸資訊。這些資訊可以被驗證和信任，因為它們是數位簽名的。一個JWT通常包含三部份：頭部（Header）、載荷（Payload）和簽名（Signature）。
二、配置JWT Token認證
在ASP.NET Core中，我們需要透過配置Startup.cs來啟用JWT Token認證。以下是一個基本的配置範例：
public classStartup
{
publicvoidConfigureServices(IServiceCollection services)
{
services.AddAuthentication(options =>
{
options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
})
.AddJwtBearer(options =>
{
options.TokenValidationParameters = new TokenValidationParameters
{
ValidateIssuer = true,
ValidateAudience = true,
ValidateLifetime = true,
ValidateIssuerSigningKey = true,
ValidIssuer = "your_issuer", // 設定你的發行人
ValidAudience = "your_audience", // 設定你的受眾
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("your_secret_key")) // 設定你的金鑰
};
});
services.AddAuthorization(); // 添加授權服務
}
publicvoidConfigure(IApplicationBuilder app, IWebHostEnvironment env)
{
// 其他配置...
app.UseAuthentication(); // 啟用認證中介軟體
app.UseAuthorization(); // 啟用授權中介軟體
// 其他中介軟體配置...
}
}
三、生成JWT Token
在使用者登入成功後，伺服器會生成一個JWT Token並返回給客戶端。以下是一個簡單的Token生成範例：
public classTokenService
{
privatereadonly SymmetricSecurityKey _key;
publicTokenService(string secretKey)
{
_key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(secretKey));
}
publicstringGenerateToken(string userId, string role)
{
var claims = new List<Claim>
{
new Claim(ClaimTypes.NameIdentifier, userId),
new Claim(ClaimTypes.Role, role)
};
var tokenHandler = new JwtSecurityTokenHandler();
var tokenDescriptor = new SecurityTokenDescriptor
{
Subject = new ClaimsIdentity(claims),
Expires = DateTime.UtcNow.AddDays(7),
SigningCredentials = new SigningCredentials(_key, SecurityAlgorithms.HmacSha256Signature)
};
var token = tokenHandler.CreateToken(tokenDescriptor);
return tokenHandler.WriteToken(token);
}
}
四、使用JWT Token進行認證
在控制器或操作方法上添加
[Authorize]
內容，以指定需要許可權控制的存取。例如：
[ApiController]
[Route("[controller]")]
[Authorize] // 整個控制器需要認證
public classMyController : ControllerBase
{
// ... 其他操作方法 ...
[HttpGet("secure")]
[Authorize(Roles = "Admin")] // 只有Admin角色可以存取此方法
public IActionResult GetSecureData()
{
// ... 處理安全數據 ...
return Ok("Secure data accessed.");
}
}
五、客戶端使用JWT Token
客戶端在每次請求時，需要將JWT Token放在HTTP請求的Authorization頭部中，格式為
Bearer <token>
。
六、總結
JWT Token為ASP.NET Core套用提供了靈活且安全的許可權控制機制。透過配置認證選項、生成Token和使用Token進行認證，我們可以輕松實作使用者身份驗證和存取控制。在實際開發中，還需要考慮Token的安全性、儲存和重新整理機制等問題，以確保系統的完整性和安全性。
透過本文的程式碼範例，讀者可以更加直觀地了解JWT Token在ASP.NET Core中的套用和實作過程。希望這能幫助讀者在實際計畫中更好地運用JWT Token進行許可權控制。
