JSON Web TokenJWT

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkFsaWNlIiwiaWF0IjoxNzE2MDAwMDAwfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
│───────────────────────────────────────│───────────────────────────────────────────────────────────│──────────────────────────────────────────────────────────│
          Header (Base64URL)                          Payload (Base64URL)                              Signature

{
  "alg": "HS256",   // 서명 알고리즘 (HMAC-SHA256)
  "typ": "JWT"
}

{
  "sub": "1234567890",      // Subject: 사용자 ID
  "name": "Alice",
  "role": "admin",
  "iat": 1716000000,        // Issued At: 발급 시각
  "exp": 1716003600         // Expiration: 만료 시각 (+1시간)
}

HMAC-SHA256(
  base64url(header) + "." + base64url(payload),
  secret_key
)

클라이언트                          서버
    │                                │
    │── POST /login {id, password} ──>│
    │                                │ 자격증명 확인
    │<── JWT 발급 ────────────────────│
    │                                │
    │── GET /api/profile             │
    │   Authorization: Bearer <JWT> ─>│
    │                                │ JWT 서명 검증
    │<── 200 OK {user data} ──────────│

import jwt  # PyJWT

SECRET = "my-secret-key"

# JWT 발급
token = jwt.encode(
    {"sub": "user123", "exp": 1716003600},
    SECRET,
    algorithm="HS256"
)

# JWT 검증 및 디코드
try:
    payload = jwt.decode(token, SECRET, algorithms=["HS256"])
    print(payload["sub"])  # "user123"
except jwt.ExpiredSignatureError:
    print("토큰 만료")
except jwt.InvalidTokenError:
    print("유효하지 않은 토큰")

✗ 잘못된 알고리즘 설정:
  alg: "none" → 서명 없이 허용하는 취약점 (항상 알고리즘 고정)

✗ 민감 정보를 Payload에 넣기:
  JWT Payload는 Base64 인코딩 → 누구나 디코딩 가능 (암호화 X)

✓ 짧은 만료 시간:
  access token: 15분~1시간
  refresh token: 7~30일 (별도 관리)

# 8자리 이하 비밀키는 GPU로 수 분~수 시간 내 크래킹 가능
hashcat -a 3 -m 16500 [JWT] -i --increment-min=5 --increment-max=8

액세스 토큰 만료 시:
1. 클라이언트가 /auth/refresh 요청 (refresh_token 전송)
2. 서버: refresh_token 검증 → 새 access_token 발급
3. 클라이언트: 새 access_token으로 재요청

OAuth 2.0 흐름 (Authorization Code + PKCE):
사용자 → 앱 → Authorization Server (로그인)
                      ↓
             Authorization Code 발급
                      ↓
앱 → Authorization Server (코드 교환)
                      ↓
              access_token (JWT)
              id_token (OIDC JWT)
              refresh_token

# OIDC ID 토큰 페이로드 예시
{
    "iss": "https://accounts.google.com",  # 발급자
    "sub": "1234567890",                   # 사용자 고유 ID
    "aud": "my-client-id",                 # 대상 앱
    "exp": 1716003600,                     # 만료
    "iat": 1716000000,                     # 발급 시각
    "email": "user@example.com",
    "name": "Alice"
}

JWS (JWT 기본): Header.Payload.Signature  → Payload는 Base64만 (누구나 읽기 가능)
JWE:            Header.EncryptedKey.IV.CipherText.AuthTag  → Payload 암호화