博客

asp.net core 中的Jwt(Json Web Token)的使用详解

  • Post category:C#

以下是“ASP.NET Core中的JWT(JsonWebToken)的使用详解”的完整攻略：

什么是JWT

JWT（JsonWebToken）是一种开放标准（RFC 7519），它定义了一种紧凑且自包含的方式，用于在各方之间作为JSON对象安全地传输信息。JWT通常用于身份验证和授权。

ASP.NET Core中的JWT的使用

以下是ASP.NET Core中使用JWT的详细过程：

步骤1：安装NuGet包

首先，我们需要安装Microsoft.AspNetCore.Authentication.JwtBearer NuGet包。可以使用以下命令安装NuGet包：

Install-Package Microsoft.AspNetCore.Authentication.JwtBearer

步骤2：配置JWT

接下来，我们需要在Startup.cs文件中配置JWT。以下是一个示例：

public void ConfigureServices(IServiceCollection services)
{
    services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddJwtBearer(options =>
        {
            options.TokenValidationParameters = new TokenValidationParameters
            {
                ValidateIssuer = true,
                ValidateAudience = true,
                ValidateLifetime = true,
                ValidateIssuerSigningKey = true,
                ValidIssuer = "yourdomain.com",
                ValidAudience = "yourdomain.com",
                IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("your_secret_key_here"))
            };
        });
}

在上面的代码中，我们使用AddAuthentication方法添加JWT身份验证服务，并使用AddJwtBearer方法配置JWT选项。我们还使用TokenValidationParameters类设置JWT验证参数，包括验证颁发者、接收者、生存期和签名密钥。

步骤3：生成JWT

现在，我们需要生成JWT。以下是一个示例：

public string GenerateToken(User user)
{
    var tokenHandler = new JwtSecurityTokenHandler();
    var key = Encoding.ASCII.GetBytes("your_secret_key_here");
    var tokenDescriptor = new SecurityTokenDescriptor
    {
        Subject = new ClaimsIdentity(new Claim[]
        {
            new Claim(ClaimTypes.Name, user.Username),
            new Claim(ClaimTypes.Email, user.Email)
        }),
        Expires = DateTime.UtcNow.AddDays(7),
        SigningCredentials = new SigningCredentials(new SymmetricSecurityKey(key), SecurityAlgorithms.HmacSha256Signature)
    };
    var token = tokenHandler.CreateToken(tokenDescriptor);
    return tokenHandler.WriteToken(token);
}

在上面的代码中，我们使用JwtSecurityTokenHandler类生成JWT。我们还使用SecurityTokenDescriptor类设置JWT的主题、过期时间和签名凭据。

示例1：使用JWT进行身份验证

以下是一个示例，演示如何使用JWT进行身份验证：

[Authorize]
[ApiController]
[Route("[controller]")]
public class UserController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        var user = HttpContext.User.Identity.Name;
        return Ok(user);
    }
}

在上面的代码中，我们使用Authorize属性标记Get方法，以确保只有经过身份验证的用户才能访问该方法。我们还使用HttpContext.User.Identity.Name获取当前用户的用户名。

示例2：使用JWT进行授权

以下是一个示例，演示如何使用JWT进行授权：

[Authorize(Roles = "Admin")]
[ApiController]
[Route("[controller]")]
public class AdminController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        return Ok("Hello Admin!");
    }
}

在上面的代码中，我们使用Authorize属性标记AdminController类，并指定只有具有“Admin”角色的用户才能访问该类。我们还使用Ok方法返回“Hello Admin!”消息。

结论

通过以上步骤，我们可以在ASP.NET Core中使用JWT进行身份验证和授权。我们可以使用AddJwtBearer方法配置JWT选项，并使用JwtSecurityTokenHandler类生成JWT。我们还可以使用Authorize属性标记方法和类，以确保只有经过身份验证和授权的用户才能访问它们。

Tags: