رمزگشایی JWT

JWT در RFC 7519 (مه 2015) تعریف شده است و پیشنهاد آن این است که مانند واژهٔ انگلیسی «jot» تلفظ شود. شکل امضاشدهٔ رایج آن سه رشتهٔ Base64url است که با نقطه به هم وصل شده‌اند: header.payload.signature. بخش header الگوریتم امضا را در alg مشخص می‌کند، مثل HS256 یا RS256، و اغلب شناسهٔ کلید را در kid می‌آورد. بخش payload شامل claimها است، یعنی فیلدهای JSON مانند sub (کاربر)، iss (صادرکننده)، aud (مخاطب مورد نظر) و exp و nbf و iat که زمان‌هایی بر حسب ثانیه از 1 ژانویهٔ 1970 به وقت UTC هستند. رمزگشا این سه مقدار را به وقت محلی شما و ISO 8601 تبدیل می‌کند و نشان می‌دهد توکن منقضی شده است، هنوز معتبر نشده است یا در بازهٔ اعتبار خود قرار دارد.

Base64url یک رمزگذاری ساده (encoding) است، نه رمزنگاری، پس هر کسی که توکن را داشته باشد می‌تواند payload را دقیقاً مثل همین صفحه بخواند. هرگز رمز عبور، شمارهٔ کارت یا اطلاعات محرمانهٔ دیگر را در claimها قرار ندهید. توکنی که پنج بخش جداشده با نقطه دارد، یک JWE یعنی توکن رمزنگاری‌شده است؛ محتوای آن بدون کلید خوانده نمی‌شود و رمزگشا همین را اعلام می‌کند. عبارت «Bearer » ابتدای متن که از هدر Authorization کپی شده باشد، خودکار حذف می‌شود.

امضا ثابت می‌کند که header و payload را کسی که کلید را دارد ساخته و از آن زمان تغییر نکرده‌اند. بررسی آن به همان کلید نیاز دارد: راز مشترک برای الگوریتم‌های HMAC مانند HS256، یا کلید عمومی صادرکننده برای RS256 و ES256 و EdDSA. قرار دادن راز امضای محیط واقعی در هر صفحهٔ وب کار درستی نیست، و رمزگشایی که بدون کلید وانمود کند توکن را تأیید می‌کند اطمینان کاذب می‌دهد؛ برای همین این ابزار امضا را نشان می‌دهد اما تأیید نمی‌کند. آنچه می‌بینید را ادعای خود توکن بدانید، نه واقعیت قطعی.

تأیید امضا باید روی سرور شما و با یک کتابخانهٔ به‌روز انجام شود و الگوریتم مورد انتظار ثابت شده باشد. دو اشتباه تاریخی دلیل آن را روشن می‌کنند: پذیرفتن alg با مقدار «none» که به هر کس اجازه می‌دهد توکن بدون امضا جعل کند، و اشتباه گرفتن الگوریتم که در آن سروری که RS256 انتظار دارد فریب می‌خورد و امضای HS256 را با کلید عمومی به‌جای راز HMAC بررسی می‌کند. رمزگشا برای اشکال‌یابی است: دیدن اینکه ارائه‌دهنده چه claimهایی صادر می‌کند، پیدا کردن aud نادرست، یا فهمیدن اینکه نشست به این دلیل شکست خورده که exp یک دقیقه پیش گذشته است. برای خواندن خام بخش‌های Base64url از رمزگشای Base64 استفاده کنید.