JWT를 활용해서 C# 서버에서 사용자 인증 처리하기

기본 흐름 요약

클라이언트 → Authorization: Bearer <JWT>
        ↓
JwtBearer 미들웨어
        ↓
토큰 유효성 검사 (서명, 만료, Issuer, Audience 등)
        ↓
성공 시 ClaimsPrincipal 생성 → HttpContext.User 에 주입

클라이언트 JWT 생성 예제 코드

public string GenerateJwtToken(string userId)
{
    var claims = new[]
    {
        new Claim("sub", userId)
    };

    var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("super-secret-key-here"));
    var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);

    var token = new JwtSecurityToken(
        issuer: "jet.io",
        audience: "jet-client",
        claims: claims,
        expires: DateTime.UtcNow.AddMinutes(60),
        signingCredentials: creds
    );

    return new JwtSecurityTokenHandler().WriteToken(token);
}

HTTPS 통신을 위한 자체 인증 SSL 인증서 만들기

(*secret key를 생성하기 위한 OpenSSL 설치는 해당 링크에서 확인하자.)

openssl rand -hex 64

이런식으로 openssl을 사용하여 secret key 생성이 가능하다.

클라이언트 HTTP 요청 시 토큰에 JWT를 포함

발급받은 토큰을 이제 HTTP 요청과 함께 서버로 보내면 된다.

GET /api/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...

C# HttpClient.PostAsync 사용하기

(*C#으로 빠르고 쉽게 HTTP 요청 보내는 방법에 대해서는 해당 링크를 확인하자.)

Nuget 패키지 확인

dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer

Program.cs (또는 Startup.cs) 토큰 검증 예제 코드

builder.Services.AddAuthentication("Bearer")
    .AddJwtBearer("Bearer", options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidTypes ["JWT"],
            ValidAlgorithms = ["HS256"],
        
            ValidIssuer = "jet.io",
            ValidAudience = "jet-client",

            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("super-secret-key-here")),
        };
    });

인증이 필요한 Contorller내 함수

[Authorize]
[HttpGet("me")]
public IActionResult GetProfile()
{
    var userId = _httpContextAccessor.HttpContext?.User.Claims.First(c => c.Type == "sub").Value;
    return Ok(new { UserId = userId });
}

함께 읽으면 좋은 글

토큰으로 검증하자! JWT(JSON 웹 토큰)