🔐 JWT Decoder

🔑 JWT (JSON Web Token)

JWT는 당사자 간에 정보를 JSON 객체로 안전하게 전송하기 위한 개방형 표준(RFC 7519)입니다. 디지털 서명되어 있어 정보의 무결성을 검증할 수 있으며, 주로 인증(Authentication)과 권한 부여(Authorization)에 사용됩니다. 세 부분으로 구성되어 있으며, 점(.)으로 구분된 Base64 URL 인코딩 문자열입니다.

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

💡 JWT 사용 사례

• 사용자 인증: 로그인 후 JWT를 발급하여 후속 요청에서 사용자 식별
• 단일 로그인 (SSO): 여러 시스템 간 사용자 인증 정보 공유
• 정보 교환: 공개키/개인키를 사용하여 서명된 데이터 전송
• API 인증: REST API 요청 시 Authorization 헤더에 포함하여 인증
• 권한 부여: 사용자의 역할 및 권한 정보를 토큰에 포함
• 세션 대체: Stateless 인증으로 서버 부담 감소

🧩 JWT 구조

{
  "alg": "HS256",
  "typ": "JWT"
}

{
  "sub": "1234567890",
  "name": "John Doe",
  "admin": true,
  "iat": 1516239022,
  "exp": 1516242622
}

HMACSHA256(
  base64UrlEncode(header) + "." +
  base64UrlEncode(payload),
  secret
)

📋 표준 클레임 (Standard Claims)

🔐 서명 알고리즘

🔄 JWT 사용 흐름

❓ 자주 묻는 질문 (FAQ)

💻 프로그래밍 언어별 JWT 구현

const jwt = require('jsonwebtoken');

// 토큰 생성
const payload = { sub: 'user123', name: 'John' };
const secret = process.env.JWT_SECRET;
const token = jwt.sign(payload, secret, { expiresIn: '1h' });

// 토큰 검증
try {
  const decoded = jwt.verify(token, secret);
  console.log(decoded); // { sub: 'user123', name: 'John', iat: ..., exp: ... }
} catch (err) {
  console.error('Invalid token');
}

// 토큰 디코딩 (검증 없이)
const decoded = jwt.decode(token);
console.log(decoded.header); // { alg: 'HS256', typ: 'JWT' }

import jwt
from datetime import datetime, timedelta

# 토큰 생성
payload = {
    'sub': 'user123',
    'name': 'John',
    'exp': datetime.utcnow() + timedelta(hours=1)
}
secret = 'your-secret-key'
token = jwt.encode(payload, secret, algorithm='HS256')

# 토큰 검증
try:
    decoded = jwt.decode(token, secret, algorithms=['HS256'])
    print(decoded)  # {'sub': 'user123', 'name': 'John', 'exp': ...}
except jwt.ExpiredSignatureError:
    print('Token expired')
except jwt.InvalidTokenError:
    print('Invalid token')

import io.jsonwebtoken.*;

// 토큰 생성
String secret = "your-secret-key";
String token = Jwts.builder()
    .setSubject("user123")
    .claim("name", "John")
    .setExpiration(new Date(System.currentTimeMillis() + 3600000))
    .signWith(SignatureAlgorithm.HS256, secret)
    .compact();

// 토큰 검증
try {
    Claims claims = Jwts.parser()
        .setSigningKey(secret)
        .parseClaimsJws(token)
        .getBody();
    String userId = claims.getSubject();
} catch (ExpiredJwtException e) {
    // 만료된 토큰
} catch (JwtException e) {
    // 유효하지 않은 토큰
}

use Firebase\JWT\JWT;
use Firebase\JWT\Key;

// 토큰 생성
$payload = [
    'sub' => 'user123',
    'name' => 'John',
    'exp' => time() + 3600
];
$secret = 'your-secret-key';
$token = JWT::encode($payload, $secret, 'HS256');

// 토큰 검증
try {
    $decoded = JWT::decode($token, new Key($secret, 'HS256'));
    echo $decoded->sub; // user123
} catch (Exception $e) {
    echo 'Invalid token: ' . $e->getMessage();
}

import "github.com/golang-jwt/jwt/v5"

// 토큰 생성
token := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.MapClaims{
    "sub":  "user123",
    "name": "John",
    "exp":  time.Now().Add(time.Hour * 1).Unix(),
})
secret := []byte("your-secret-key")
tokenString, err := token.SignedString(secret)

// 토큰 검증
token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
    return secret, nil
})

if claims, ok := token.Claims.(jwt.MapClaims); ok && token.Valid {
    fmt.Println(claims["sub"]) // user123
} else {
    fmt.Println("Invalid token")
}

🆚 JWT vs Session vs OAuth

🔗 관련 도구 및 리소스