Giới thiệu & Mục đích sử dụng
JWT (JSON Web Token — RFC 7519) là tiêu chuẩn phổ biến nhất cho xác thực phiên đăng nhập API, OAuth 2.0 và Single Sign-On (SSO). Trong quá trình debug lỗi 401 Unauthorized hoặc kiểm tra quyền phân rã (roles/scopes) trả về từ backend, lập trình viên thường xuyên phải đọc nhanh xem token đã hết hạn chưa, chứa mã người dùng nào và chữ ký HMAC có khớp với khóa cấu hình không.
Tuy nhiên, dán Access Token thật của hệ thống vào các trang web có gửi dữ liệu về máy chủ rất nguy hiểm vì dễ làm lộ phiên đăng nhập của người dùng. Công cụ Giải Mã & Xác Thực JWT Token trên N1A chạy hoàn toàn trong bộ nhớ trình duyệt (không gọi API gửi token ra ngoài và không lưu token vào lịch sử URL), hỗ trợ đọc chuẩn tiếng Việt UTF-8, tự đổi mọi mốc thời gian sang giờ Việt Nam GMT+7 và cho phép xác thực chữ ký HS256 / HS384 / HS512 ngay tại chỗ.
Cách dùng từng bước
-
Dán chuỗi JWT vào ô nhập liệu (hoặc bấm Tạo JWT mẫu)Hỗ trợ dán cả chuỗi có sẵn tiền tố Authorization Bearer ở đầu — công cụ tự lọc sạch khoảng trắng và tách màu 3 thành phần Header, Payload, Signature.
-
Xem trạng thái còn hạn / hết hạn và bảng Claims chi tiếtMốc exp, iat, nbf được tự động quy đổi sang ngày giờ Asia/Ho_Chi_Minh (GMT+7) và báo rõ còn bao nhiêu giờ/phút hiệu lực.
-
Kiểm tra cảnh báo bảo mật (alg="none", thiếu exp)Nếu token dùng thuật toán trống hoặc không đặt hạn sử dụng, bảng trạng thái sẽ cảnh báo rõ rủi ro bảo mật.
-
Nhập Secret Key để xác thực chữ ký HMAC (tùy chọn)Với token ký bằng HS256, HS384 hoặc HS512, nhập Secret Key dùng trong biến môi trường backend để Web Crypto kiểm chứng tính toàn vẹn tức thì.
Công thức & Phương pháp tính
Một chuỗi JWS (Signed JWT) theo chuẩn IETF RFC 7519 luôn bao gồm ba đoạn văn bản Base64URL ngăn cách nhau bởi hai dấu chấm (.):
- Header (Phần màu đỏ): Khai báo siêu dữ liệu loại token (
typ: "JWT") và thuật toán ký số (algnhưHS256đối xứng HMAC hoặcRS256/ES256bất đối xứng RSA/ECDSA). - Payload (Phần màu xanh dương): Chứa các tuyên bố (Claims) định danh người dùng và ngữ cảnh bảo mật. Các trường chuẩn gồm
iss(nhà phát hành),sub(ID người dùng),aud(ứng dụng nhận),exp(hạn sử dụng),nbf(thời điểm bắt đầu hiệu lực),iat(lúc phát hành) vàjti(mã định danh chống dùng lại). - Signature (Phần màu xanh lá): Mã băm hoặc chữ ký điện tử tạo ra bằng cách lấy
Header.Payloadký với khóa bí mật hoặc Private Key, đảm bảo không ai sửa đổi được nội dung Payload trên đường truyền.
| Claim chuẩn | Ý nghĩa RFC 7519 | Kiểu dữ liệu & Kiểm tra |
|---|---|---|
exp | Expiration Time — Thời điểm hết hạn | Unix timestamp (giây); backend BẮT BUỘC từ chối khi hiện tại ≥ exp |
iat | Issued At — Thời điểm phát hành token | Unix timestamp (giây); dùng tính tuổi thọ token |
nbf | Not Before — Chỉ hợp lệ kể từ thời điểm này | Unix timestamp (giây) |
iss & aud | Issuer & Audience | Xác định đúng hệ thống phát hành và đúng API đích nhận token |
Ví dụ minh họa
Ví dụ 1 — Kiểm tra tên tiếng Việt có dấu trong JWT Claims: Khi backend đóng gói họ tên "Đặng Minh Anh" vào JWT, nhiều công cụ giải mã dùng hàm atob() đơn giản sẽ biến tên thành các ký tự lỗi phông kiểu Ä áº·ng Minh Anh. Nhờ sử dụng TextDecoder("utf-8"), công cụ N1A đọc chính xác tuyệt đối mọi tên riêng tiếng Việt.
Ví dụ 2 — Bắt lỗi lỗ hổng kinh điển alg="none": Một số thư viện cũ nếu lập trình viên không khóa cứng danh sách thuật toán cho phép (algorithms: ["HS256"]) có thể bị tin tặc sửa Header thành {"alg":"none"} và xóa bỏ phần chữ ký để mạo danh quyền Admin. Công cụ N1A cảnh báo đỏ ngay khi phát hiện header chứa alg="none".
Lưu ý quan trọng
Quy tắc vàng về JWT: Phần Payload của JWT tiêu chuẩn (JWS) KHÔNG ĐƯỢC MÃ HÓA BÍ MẬT mà chỉ được chuyển sang chuỗi Base64URL để dễ vận chuyển. Bất kỳ trình duyệt hoặc người trung gian nào cầm token đều đọc được mọi thông tin nằm trong Payload! Do đó, TUYỆT ĐỐI không lưu mật khẩu, số CCCD, mã PIN hoặc thông tin thẻ ngân hàng vào JWT Payload. Chỉ nên đặt User ID, vai trò và thời hạn ngắn (5–15 phút cho Access Token).
Câu hỏi thường gặp
Vì sao giải mã JWT lại không cần nhập mật khẩu hay Secret Key vẫn đọc được nội dung bên trong?
Bởi vì chuẩn JWS (JWT ký số phổ biến nhất) chỉ mã hóa Base64URL cho Header và Payload chứ không mã hóa đối xứng che giấu nội dung. Secret Key hoặc khóa công khai chỉ dùng để kiểm chứng xem phần Signature có bị giả mạo hay chỉnh sửa không.
Dán Access Token thật của ứng dụng công ty vào công cụ N1A có an toàn không?
An toàn về mặt truyền tải: toàn bộ logic tách chuỗi, giải mã UTF-8 và kiểm chứng HMAC chạy hoàn toàn bằng Web Crypto API trong trình duyệt của bạn, không gửi token qua internet và cũng không lưu vào URL hay localStorage. Tuy vậy với hệ thống tài chính cực nhạy cảm, bạn luôn nên xóa trắng hoặc dùng dữ liệu môi trường staging/dev.
Tại sao không xác thực được chữ ký token dùng thuật toán RS256 chỉ bằng một Secret Key ngắn?
HS256 là thuật toán đối xứng dùng chung một chuỗi Secret Key để vừa ký vừa xác thực. Ngược lại, RS256 và ES256 là chữ ký bất đối xứng (ký bằng Private Key ở máy chủ xác thực Auth0/Firebase/Keycloak và xác thực bằng Public Key / chứng chỉ X.509 JWK).
Mốc thời gian exp và iat bên trong JWT được lưu theo đơn vị giây hay mili-giây?
Theo RFC 7519 mục 2 (NumericDate), toàn bộ các trường thời gian chuẩn exp, iat và nbf trong JWT luôn tính bằng SỐ GIÂY (10 chữ số, không phải 13 chữ số mili-giây như Date.now() của JavaScript). Nhập nhầm mili-giây vào exp sẽ khiến token tưởng còn hạn tới tận hàng chục nghìn năm sau.
Lỗ hổng bảo mật JWT alg='none' là gì?
Đặc tả RFC 7519 từng quy định giá trị alg='none' cho JWT không cần chữ ký. Kẻ tấn công có thể đổi payload của mình thành role=admin, đặt header alg='none' và cắt bỏ chữ ký; nếu máy chủ backend quên chỉ định cố định thuật toán kỳ vọng, máy chủ sẽ tin luôn token giả mạo đó.
Có nên lưu thông tin nhạy cảm như mật khẩu hay số dư tài khoản vào JWT Payload không?
Tuyệt đối không. Mọi dữ liệu trong JWT thông thường đều đọc được bằng cách giải mã Base64URL đơn giản. Nếu buộc phải che giấu nội dung payload trước người đọc, cần dùng chuẩn JWE (JSON Web Encryption) chứ không phải JWS.
Căn cứ pháp lý & Nguồn tham khảo
- IETF RFC 7519 — JSON Web Token (JWT) (Đặc tả chính thức về cấu trúc 3 phần, NumericDate (exp/iat/nbf) và các registered claims.)
- OWASP JSON Web Token Cheat Sheet for Java / Node / Go (Khuyến nghị phòng chống tấn công alg=none, nhầm thuật toán và lộ dữ liệu trong Payload.)