JWT(Json Web Token)
란, Json 포맷을 이용하여 사용자에 대한 속성을 저장하는 Claim 기반의 Web Token 입니다. JWT
는 토큰 자체를 정보로 사용하는 Self-Contained
방식으로 정보를 안전하게 전달합니다. 주로 회원 인증이나 정보 전달에 사용되는 JWT는 아래의 로직을 따라서 처리됩니다.
애플리케이션이 실행될 때, JWT를 static 변수와 로컬 스토리지에 저장하게 됩니다. static 변수에 저장되는 이유는 HTTP
통신을 할 때마다 JWT
를 HTTP
헤더에 담아서 보내야 하는데, 이를 로컬 스토리지에서 계속 불러오면 오버헤드가 발생하기 때문입니다.
클라이언트에서 JWT
를 포함해 요청을 보내면 서버는 허가된 JWT
인지를 검사합니다. 또한 로그아웃을 할 경우 로컬 스토리지에 저장된 JWT
데이터를 제거합니다. (실제 서비스의 경우에는 로그아웃 시에 사용했던 토큰을 blacklist
라는 DB 테이블에 넣어 해당 토큰의 접근을 막는 작업을 해주어야 합니다.)
JWT
는 Header
, Payload
, Signature
의 3부분으로 이루어지며, Json
형태인 각 부분은 Base64
로 인코딩 되어 표현됩니다. 또한 각각의 부분을 이어 주기 위해, 구분자를 사용하여 구분합니다.
추가로, Base64
는 암호화된 문자열이 아니고, 같은 문자열에 대해 항상 같은 인코딩 문자열을 반환합니다.
토큰의 헤더는 typ
과 alg
두 가지 정보로 구성됩니다. alg
는, 헤더를 암호화 하는 것이 아니고, Signature
를 해싱하기 위한 알고리즘을 지정하는 것입니다.
typ
: 토큰의 타입을 지정 ex) JWTalg
: 알고리즘 방식을 지정하며, 서명(Signature) 및 토큰 검증에 사용토큰의 페이로드에는 토큰에서 사용할 정보들의 조각들인 클레임(Claim) 이 담겨 있습니다. 클레임은 총 3가지로 나누어지며 JSON
형태로 다수의 정보를 넣을 수 있습니다.
2-1. 등록된 클레임(Registered Claim)
등록된 클레임은 토큰 정보를 표현하기 위해 이미 정해진 종류의 데이터들로, 모두 선택적으로 작성이 가능하며, 사용할 것을 권장합니다. 또한 JWT
를 간결하게 하기 위해 key는 모두 길이 3의 String
입니다. 여기서 subject
로는 unique 한 값을 사용하는데, 사용자 이메일을 주로 사용합니다.
2-2. 공개 클레임(Public Claim)
공개 클레임은 사용자 정의 클레임으로, 공개용 정보를 위해 사용됩니다. 충돌 방지를 위해 URI 포맷을 사용하며, 예시는 아래와 같습니다.
{"https://yunmin.tistory.com":true}
2-3. 비공개 클레임(Private Claim)
비공개 클레임도 공개 클레임과 마찬가지로 사용자 정의 클레임입니다. 서버와 클라이언트 사이에 임의로 지정한 정보를 저장합니다. 아래 예시와 같습니다.
{"token_type":access}
Signature
는 토큰을 인코딩하거나 유효성 검증을 할 때 사용하는 고유한 암호화 코드입니다. 이는 위에서 만든 Header
와 Payload
의 값을 각각 Base64
로 인코딩하고, 인코딩한 값을 비밀 키를 이용해 Header
에서 정의한 알고리즘으로 해싱을 하고 이 값을 다시 Base64
로 인코딩하여 생성합니다.
아래는 생성된 JWT
의 예시입니다.
생성된 토큰은 HTTP
통신을 할 때 Autorization
이라는 key의 value로 사용됩니다. 일반적으로 value에는 Bearer이 앞에 붙여 집니다.
{
"Authorization": "Bearer {생성된 토큰 값}",
}