토큰 발급
로그인 시 서명된 토큰을 생성합니다.
토큰 발급은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
발급과 검증
지금까지 token을 검증했습니다. 이제 token을 발급합니다. 사용자가 성공적으로 로그인하면 API가 서명된 JWT를 생성해 반환합니다.
이를 위한 핵심 형식은 System.IdentityModel.Tokens.Jwt의 JwtSecurityTokenHandler입니다.
dotnet add package System.IdentityModel.Tokens.Jwt서명 key
token에 서명하려면 key가 필요합니다. HS256에서는 검증기가 사용하는 동일한 대칭 비밀을 재사용합니다.
이 비밀을 소스 제어에 포함하지 말고 구성이나 비밀 저장소에서 로드하십시오.
var key = new SymmetricSecurityKey(
Encoding.UTF8.GetBytes(configuration["Jwt:Key"]!));SigningCredentials
SigningCredentials는 key와 알고리즘을 짝짓습니다. 대칭 key에는 SecurityAlgorithms.HmacSha256을 사용합니다.
var creds = new SigningCredentials(
key,
SecurityAlgorithms.HmacSha256);claims 구성
token에 무엇을 담을지 결정합니다. 항상 주체(사용자 ID)와 API에 필요한 역할 또는 데이터를 포함하십시오.
각 token을 식별할 수 있도록 고유한 jti를 추가하십시오.
var claims = new List<Claim>
{
new Claim(JwtRegisteredClaimNames.Sub, user.Id.ToString()),
new Claim(JwtRegisteredClaimNames.Jti, Guid.NewGuid().ToString()),
new Claim(ClaimTypes.Name, user.UserName),
new Claim(ClaimTypes.Role, user.Role)
};JwtSecurityToken 생성
JwtSecurityToken은 발급자, 대상, claims, 만료 및 서명 자격 증명을 하나의 token 개체로 묶습니다.
var token = new JwtSecurityToken(
issuer: configuration["Jwt:Issuer"],
audience: configuration["Jwt:Audience"],
claims: claims,
notBefore: DateTime.UtcNow,
expires: DateTime.UtcNow.AddMinutes(15),
signingCredentials: creds);문자열로 직렬화
token 개체는 클라이언트에 보내기 전에 간결한 header.payload.signature 문자열 형식으로 작성해야 합니다.
var handler = new JwtSecurityTokenHandler();
string jwt = handler.WriteToken(token);
// jwt now looks like eyJhbGciOiJI...재사용 가능한 token 서비스
로직을 서비스로 감싸 컨트롤러를 깔끔하게 유지하고 구성을 한 곳에 두십시오.
public class TokenService(IConfiguration config)
{
public string CreateAccessToken(AppUser user)
{
var key = new SymmetricSecurityKey(
Encoding.UTF8.GetBytes(config["Jwt:Key"]!));
var creds = new SigningCredentials(
key, SecurityAlgorithms.HmacSha256);
var claims = new[]
{
new Claim(JwtRegisteredClaimNames.Sub, user.Id.ToString()),
new Claim(ClaimTypes.Role, user.Role)
};
var token = new JwtSecurityToken(
config["Jwt:Issuer"], config["Jwt:Audience"],
claims, expires: DateTime.UtcNow.AddMinutes(15),
signingCredentials: creds);
return new JwtSecurityTokenHandler().WriteToken(token);
}
}로그인 엔드포인트 연결
로그인 엔드포인트는 인증 정보를 확인한 다음 서비스를 호출하고 token을 클라이언트에 반환합니다.
app.MapPost("/login", (LoginDto dto, TokenService tokens) =>
{
var user = Authenticate(dto.Username, dto.Password);
if (user is null) return Results.Unauthorized();
return Results.Ok(new { accessToken = tokens.CreateAccessToken(user) });
});대칭 방식과 비대칭 방식 비교
HS256은 서명과 검증 모두에 하나의 공유 비밀을 사용합니다. RS256은 서명에 private key를 사용하고 검증에는 public key를 사용합니다.
비대칭 서명을 사용하면 public key를 공개할 수 있으므로 다른 서비스가 서명 비밀을 보유하지 않고도 token을 검증할 수 있습니다.
var creds = new SigningCredentials(
new RsaSecurityKey(rsaPrivateKey),
SecurityAlgorithms.RsaSha256);서비스 등록
token 서비스를 종속성 주입에 추가하여 엔드포인트와 컨트롤러에 주입할 수 있도록 합니다.
builder.Services.AddScoped<TokenService>();token을 간결하고 짧게 유지하기
token을 발급할 때의 두 가지 모범 사례는 다음과 같습니다.
- 간결하게: API에 필요한 claims만 포함하십시오. token은 모든 요청에 함께 전송됩니다.
- 수명이 짧게: 5~15분의 access token은 하나가 유출되었을 때 피해를 제한합니다.
expires: DateTime.UtcNow.AddMinutes(15)빠른 확인
token 발급에 대해 배운 내용을 확인해 보십시오.
복습
서명된 JWT를 발급했습니다.
SigningCredentials는 key와 알고리즘을 짝짓습니다.Claim목록을 만든 다음 발급자, 대상 및 만료가 포함된JwtSecurityToken을 구성합니다.JwtSecurityTokenHandler.WriteToken은 이를 간결한 문자열로 직렬화합니다.- token을 간결하고 수명이 짧게 유지하십시오.
다음으로 refresh token과 만료 전략을 알아봅니다.
자주 묻는 질문
“토큰 발급” 강의는 무료인가요?
네 — “토큰 발급” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“토큰 발급”에서 뭘 배우나요?
로그인 시 서명된 토큰을 생성합니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
C# Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“토큰 발급” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.