JWT 디코더를 만들면서 토큰을 풀어 보여 주는 것 말고도 경고 세 가지를 넣었습니다. 각 경고가 무엇을 알려 주는지, 왜 넣었는지 정리합니다.
JWT 디코더가 하는 일과 하지 않는 일
JWT는 점(.)으로 나뉜 세 조각으로 되어 있습니다. 헤더, 페이로드(담긴 정보), 서명입니다. 이 도구가 하는 일은 아래와 같습니다.
- 헤더와 페이로드를 풀어서 보기 좋게 보여 줍니다.
- 만료 시각(exp), 발급 시각(iat), 유효 시작 시각(nbf)을 한국 시간으로 바꾸고, 지금 유효한지 표시합니다.
- 토큰은 브라우저 안에서만 풀고, 서버로 보내지 않습니다.
하지 않는 일도 분명히 있습니다. 서명은 검증하지 않습니다. 서명을 검증하려면 토큰을 만든 쪽의 키가 필요하기 때문입니다. 그래서 경고가 하나도 없다고 해서 안전한 토큰이라는 뜻은 아닙니다. 아래 경고는 “이 토큰은 한 번 더 살펴봐야 한다”는 신호입니다.
보안쪽 업무를 하게 되면 토큰은 필수적으로 보게되는데 JWT 토큰을 기반으로 암호화된 구문을 복호화 하거나 암호화하여 테스트 해볼 수 있습니다.
경고 1: alg가 none
헤더의 alg는 서명에 쓴 방식을 알려 주는 항목입니다. 이 값이 none이면 서명이 없는 토큰입니다. 서명이 없으면 누구나 페이로드를 바꿔도 티가 나지 않습니다. 그래서 서버는 이런 토큰을 받아들이면 안 됩니다.
도구는 none을 대문자로 쓰든 소문자로 쓰든 똑같이 경고합니다.
경고 2: 헤더의 jku·x5u·jwk
이 세 항목은 서명을 확인할 키를 어디서 가져올지 토큰이 직접 알려 주는 항목입니다.
jku: 키 목록이 있는 주소x5u: 인증서가 있는 주소jwk: 토큰 안에 키를 직접 넣은 것
문제는 토큰을 만든 사람이 이 값을 마음대로 정할 수 있다는 점입니다. 서버가 토큰이 알려 준 키를 그대로 믿으면, 다른 사람이 만든 위조 토큰도 통과될 수 있습니다. 서버는 미리 정해 둔 키만 써야 합니다. 이 경고는 처음 계획에는 없었고, 만드는 도중에 추가로 넣었습니다.
경고 3: 페이로드의 민감 정보
페이로드의 키 이름에 password, passwd, pwd, secret이 들어 있으면 경고합니다. 대소문자는 구분하지 않고, 안쪽에 들어 있는 키까지 모두 확인합니다.
JWT의 페이로드는 Base64URL이라는 방식으로 글자를 바꿔 놓은 것일 뿐, 암호화된 것이 아닙니다. 이 도구처럼 누구나 바로 풀어서 읽을 수 있습니다. 그래서 비밀번호나 비밀키 같은 정보를 넣으면 안 됩니다. 이 경고도 만드는 도중에 추가로 넣었습니다.
최근 대량으로 발생하는 개인정보유출 해킹 사고를 보게 된다면 경각심을 갖게 되고 그로 인해 고려할 부분을 예민하게 적용했던 것 같습니다.
경고가 아닌 안내들
위험하다기보다 알아 두면 좋은 내용은 ‘안내’로 따로 보여 줍니다.
- 아주 큰 정수(약 9천조 초과)가 있으면 화면에 보이는 끝자리가 원래 값과 다를 수 있다고 알려 줍니다.
- 페이로드가 JSON이 아니면 글자 그대로, 글자도 아니면 16진수로 보여 줍니다.
- 서명 부분의 형식이 맞지 않으면 알려 줍니다.
- 암호화된 JWT(다섯 조각으로 된 JWE)는 내용을 풀 수 없어서 헤더만 보여 줍니다.
마치며
이런 기능을 AI를 통한다면 간단하고 신속하게 툴을 만들고 적용할 수 있다는걸 느꼈고 내가 안쓰는 툴이나 간단한 웹 사이트 게임을 만들어서 모든 직장인들이 힘들지 않고 편리한 직장 생활을 했으면 좋겠습니다.