1단계: 비밀번호 해시와 JWT 로그인

// 저장 형식  pbkdf2$반복횟수$salt(base64)$hash(base64)
public String hash(char[] password) {
    byte[] salt = new byte[16];
    SecureRandom.nextBytes(salt);                                   // 사용자마다 다른 난수. 같은 비밀번호도 다른 해시
    byte[] dk = pbkdf2(password, salt, iterations);                 // PBKDF2WithHmacSHA256, 256비트
    return "pbkdf2$" + iterations + "$" + b64(salt) + "$" + b64(dk);
}

public static boolean verify(char[] password, String stored) {
    String[] p = stored.split("\\$");                               // 저장된 문자열에서 반복 횟수와 salt 를 꺼내
    byte[] actual = pbkdf2(password, Base64.decode(p[2]), Integer.parseInt(p[1]));
    return MessageDigest.isEqual(Base64.decode(p[3]), actual);      // 상수 시간 비교
}

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 . eyJpc3MiOiJhdXRoLWxlc3NvbiIsInN1YiI6ImtpbSIsImlhdCI6MTc4ODkyNzM0OSwiZXhwIjoxNzg4OTMwOTQ5fQ . MTZ5ElrVIdW1fQu1oMdPlym6YRHKKEuIizgLwzUu4kU
└──────── header ────────┘   └──────────────────────── payload ────────────────────────┘   └────────── signature ──────────┘
{"alg":"HS256","typ":"JWT"}   {"iss":"auth-lesson","sub":"kim","iat":1788927349,"exp":1788930949}   HMAC-SHA256(secret, header.payload)

// HS256
String signingInput = base64url(header) + "." + base64url(payload);
byte[] sig = HMAC-SHA256(secret, signingInput);                    // Mac.getInstance("HmacSHA256")

// RS256
Signature sig = Signature.getInstance("SHA256withRSA");
sig.initSign(privateKey); sig.update(signingInput.getBytes(US_ASCII));
byte[] signature = sig.sign();

public static Map<String, Object> verifyHs256(String token, byte[] secret) {
    Parsed t = parse(token);                                                   // 3부분 분리, 디코딩
    requireAlg(t, "HS256");                                                    // ① 헤더 alg 가 기대값인가 (none, RS256 거부)
    if (!MessageDigest.isEqual(hmac(t.signingInput(), secret), t.signature()))
        throw new JwtException("서명 불일치");                                   // ② 서명 재계산 후 상수 시간 비교
    checkTime(t.payload());                                                    // ③ exp 지났나, nbf 아직인가 (leeway 30초)
    return t.payload();
}

요청:  Authorization: Bearer eyJhbGciOi…
응답:  401 Unauthorized  + WWW-Authenticate: Bearer realm="…"                   토큰 없음
       401 Unauthorized  + WWW-Authenticate: Bearer error="invalid_token"        토큰 있으나 무효(서명·만료)
       403 Forbidden                                                              토큰 유효하나 권한 부족

Optional<User> found = users.find(username);
if (found.isEmpty()) {
    PasswordHasher.verify(password, DUMMY_HASH);       // ① 없는 사용자도 해시 계산 → 응답 시간 동일
    json(ex, 401, "아이디 또는 비밀번호가 올바르지 않습니다");   // ② 같은 메시지
    return;
}
if (u.locked()) { json(ex, 423, "계정이 잠겼습니다"); return; }    // ③ 5회 실패 → 잠금
if (!verify(password, u.passwordHash())) { users.save(u.failed()); json(ex, 401, 같은 메시지); return; }
if (hasher.needsRehash(u.passwordHash())) u = u.withHash(hasher.hash(password));   // ④ 점진적 재해시
users.save(u.succeeded());                                                          // ⑤ 실패 카운터 리셋

// jjwt 0.12 — 이 레슨의 Jwt.hs256 / verifyHs256
SecretKey key = Keys.hmacShaKeyFor(secretBytes);                                    // 256비트 미만이면 예외를 던져 준다
String token = Jwts.builder().issuer("auth-lesson").subject(user.getUsername())
        .claim("roles", roles).issuedAt(now).expiration(exp).signWith(key).compact();
Claims claims = Jwts.parser().verifyWith(key).clockSkewSeconds(30).build()          // 키 타입으로 alg 고정, leeway
        .parseSignedClaims(token).getPayload();                                     // 서명·만료 검증 실패 시 JwtException

// Spring Security — 이 레슨의 AuthServer.authenticated
public class JwtAuthenticationFilter extends OncePerRequestFilter {
    protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res, FilterChain chain) {
        String auth = req.getHeader("Authorization");
        if (auth != null && auth.startsWith("Bearer ")) {
            try {
                Claims c = jwtParser.parseSignedClaims(auth.substring(7)).getPayload();
                var authorities = ((List<String>) c.get("roles")).stream().map(SimpleGrantedAuthority::new).toList();
                SecurityContextHolder.getContext().setAuthentication(new UsernamePasswordAuthenticationToken(c.getSubject(), null, authorities));
            } catch (JwtException e) { /* 인증 없이 통과 → 뒤에서 401 */ }
        }
        chain.doFilter(req, res);
    }
}

// SecurityFilterChain: 이 레슨의 requiredRole 검사
http.authorizeHttpRequests(a -> a.requestMatchers("/admin/**").hasRole("ADMIN").requestMatchers("/me").authenticated().anyRequest().permitAll())
    .sessionManagement(s -> s.sessionCreationPolicy(STATELESS))                    // 세션 쿠키 안 씀 = JWT 무상태
    .addFilterBefore(jwtFilter, UsernamePasswordAuthenticationFilter.class)
    .csrf(c -> c.disable());                                                        // 쿠키 인증이 아니므로 CSRF 불필요 (2단계에서 다시 검토)