JWS Compact Serialization(RFC 7515 섹션 3.1) 표준을 준수하는 JWT를 생성하려면 JOSE 헤더, JSON 클레임 세트 및 대칭 시크릿 키를 <header>.<payload>.<signature> 형식의 세 부분으로 구성된 문자열로 변환해야 합니다.
1. JOSE 헤더 및 API 클레임 페이로드 구성
먼저 HS256 보호 헤더와 RFC 7519 등록된 클레임(iss, sub, aud, iat, exp) 및 커스텀 애플리케이션 클레임(role)을 결합한 JSON 페이로드를 작성합니다.
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
여기서 1767225600은 2026-01-01T00:00:00Z를 나타내며, 1767229200은 2026-01-01T01:00:00Z(1시간의 토큰 유효 기간)를 나타냅니다.
2. 패딩 없는 Base64URL 서명 입력값 생성
각 JSON 객체는 불필요한 공백 없이 UTF-8 바이트로 압축(minify)된 후, Base64URL(- 및 _ 알파벳 사용, = 패딩 제거)로 인코딩되어 ASCII 마침표(.)로 연결됩니다.
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. 재현 가능한 HMAC-SHA256 서명 테스트 벡터
Web Crypto는 crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"])을 통해 시크릿 바이트를 가져와 정확한 ASCII <base64url-header>.<base64url-payload> 바이트에 서명합니다. UTF-8 시크릿 your-256-bit-secret을 사용하는 표준 HS256 테스트 벡터를 통해 OpenSSL, Node.js crypto, Python PyJWT 및 이 생성기 간의 결정론적 일관성을 검증할 수 있습니다.
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
{"alg":"HS256","typ":"JWT"} 헤더와 위 페이로드를 your-256-bit-secret으로 서명하면 항상 정확히 아래의 147자 토큰이 생성됩니다. 이 토큰은 HTTP Authorization: Bearer <token> 헤더에 바로 사용하거나 JWT 디코더 및 인스펙터에서 왕복 검증을 수행하는 데 사용할 수 있습니다.
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c