안전한 JWT 구현 모범 사례

JWT의 보안 수준은 구현 수준에 의해서만 결정됩니다. 사양은 유연하지만, 이러한 유연성은 취약점을 만듭니다. 운영 시스템에서 인증 우회로 이어져 온 일반적인 문제를 피하려면 다음 모범 사례를 따르십시오.

예상 알고리즘을 항상 명시적으로 지정하십시오: jwt.decode(token, key, algorithms=["RS256"]). 검증 키나 코드 경로를 선택하기 위해 토큰 헤더에서 알고리즘을 읽지 마십시오. 이렇게 하면 alg=none 및 키 혼동 공격을 방지할 수 있습니다.

액세스 토큰: 15~60분입니다. 갱신 토큰: 7~30일이며 httpOnly 쿠키에 저장합니다(localStorage에는 저장하지 않음). 만료되면 클라이언트는 갱신 토큰을 사용해 다시 인증하지 않고 인증 서버에서 새 액세스 토큰을 받습니다.

토큰이 다른 서비스가 아니라 자신의 서비스를 대상으로 발급되었는지 확인하려면 aud(대상)를 검증하십시오. 자신의 인증 서버 URL을 기준으로 iss(발급자)를 검증하십시오. 이러한 검사가 없으면 동일한 키로 서명된 다른 애플리케이션의 토큰도 허용됩니다.

메모리의 액세스 토큰(JS 변수) — 탭을 닫으면 삭제됩니다. httpOnly, Secure, SameSite=Strict 쿠키의 갱신 토큰 — JavaScript에서 접근할 수 없습니다. JWT를 localStorage에 절대 저장하지 마십시오. XSS가 이를 탈취할 수 있습니다.

JWT는 무상태이므로 기본 제공되는 폐기 기능이 없습니다. 선택지는 다음과 같습니다. 각 요청에서 확인하는 폐기 목록(거부 목록)을 유지하거나, 매우 짧은 만료 시간을 사용하거나, 높은 보안이 필요한 상황에서 중앙 조회를 사용하는 불투명 토큰을 사용합니다.

서명 키를 정기적으로 교체하십시오. 서로 다른 kid 값을 가진 여러 키를 JWKS에 게시하십시오. 교체하는 동안에는 새 kid로 새 토큰을 발급하고, 기존 토큰이 만료될 때까지 기존 키를 활성 상태로 유지한 다음 JWKS에서 기존 키를 제거하십시오.

민감한 데이터(비밀번호, 사회보장번호, 신용카드 정보)를 JWT 페이로드에 절대 넣지 마십시오. JWT는 암호화된 것이 아니라 base64url로 인코딩되어 있습니다. 암호화된 클레임이 필요하다면 JWE(JSON Web Encryption)를 사용하거나 민감한 데이터를 서버 측에 보관하십시오.

JWT는 HTTPS를 통해서만 전송하십시오. HTTP를 통해 JWT를 가로채면 인증을 완전히 우회할 수 있습니다. 쿠키에 Secure 플래그를 설정하십시오. 프로토콜 다운그레이드를 방지하려면 HSTS를 사용하십시오. 서버 로그에 전체 JWT 문자열을 절대 기록하지 마십시오.

잘 유지 관리되는 라이브러리를 사용하십시오: PyJWT 2+, python-jose, auth0/node-jsonwebtoken 9+, Nimbus JOSE + JWT(Java). JWT 검증을 처음부터 직접 구현하지 마십시오. 라이브러리 취약점이 있는지 CVE 데이터베이스를 정기적으로 확인하십시오.

모든 공격 벡터를 테스트하십시오. alg=none 토큰, RS256→HS256 혼동 토큰, 만료된 토큰, 잘못된 대상 토큰, 변조된 페이로드를 제출해 보십시오. jwt.io를 사용해 테스트 토큰을 구성하십시오. 이러한 토큰이 401로 거부되는지 확인하는 통합 테스트를 추가하십시오.

웹 애플리케이션에서 갱신 토큰은 어디에 저장해야 합니까?

안전한 JWT 사용에는 알고리즘 고정, 짧은 액세스 토큰 만료 시간, 갱신 토큰의 httpOnly 쿠키 저장, 대상 및 발급자 검증, 키 교체가 필요합니다. 다음 주제: 암호학적 비밀 공유 방식입니다.