پرش به محتوای اصلی

راهنمای JWT: خواندن، امضا و بررسی

زمان مطالعه: ۳ دقیقه

این ابزار چیست؟

JWT رشته‌ای سه‌بخشی است که بسیاری از سایت‌ها و APIها برای نگه‌داشتن ورود کاربر به کار می‌برند: سرآیند (header)، محتوا (payload) و امضا. دو بخش اول فقط با base64url کدگذاری شده‌اند و هر کسی می‌تواند آن‌ها را بخواند؛ آنچه توکن را قابل اعتماد می‌کند امضای بخش سوم است. این ابزار محتوای توکن را باز می‌کند، زمان‌های صدور و انقضا را به تاریخ شمسی نشان می‌دهد، امضا را با رمز مشترک، کلید عمومی یا JWKS بررسی می‌کند و برای آزمایش، توکن تازه می‌سازد.

توکن، رمز و کلیدها از مرورگر شما خارج نمی‌شوند و در تاریخچه ذخیره نمی‌شوند. با این حال رمز یا کلید خصوصی واقعی محیط عملیاتی را هیچ‌جا نچسبانید.

گام‌به‌گام

  1. توکن را بچسبانید

    در بخش «خواندن و بررسی»، توکن را در کادر «توکن JWT» بگذارید. header و payload بلافاصله به شکل JSON خوانا نمایش داده می‌شوند.

  2. زمان‌ها را بررسی کنید

    زمان صدور (iat)، معتبر از (nbf) و انقضا (exp) به تاریخ شمسی و نسبی نشان داده می‌شوند و اگر توکن منقضی یا هنوز معتبر نشده باشد، برچسب هشدار می‌گیرد.

  3. کلید بررسی را بدهید

    برای HS256 و خانواده‌اش رمز مشترک را با قالب درست بنویسید؛ برای RS، PS، ES و EdDSA کلید عمومی PEM، گواهی X.509، JWK یا مجموعه‌ی JWKS را بچسبانید. در JWKS کلید درست با kid انتخاب می‌شود.

  4. امضا را بررسی کنید

    نتیجه یکی از این‌هاست: امضا معتبر، امضا معتبر ولی زمان توکن نه، امضا نامعتبر، الگوریتم با کلید نمی‌خواند، یا توکن بدون امضا.

  5. برای آزمایش توکن بسازید

    در بخش «امضا» الگوریتم، header و payload را تنظیم کنید و با رمز یا کلید آزمایشی که همین‌جا ساخته می‌شود توکن بگیرید.

نمونه‌های کاربردی

  • امضای درست، توکن منقضی

    این توکن آزمایشی با رمز secret-for-test امضا شده و زمان انقضایش در دی ۱۴۰۳ گذشته است؛ رمز همراه نمونه بارگذاری می‌شود.

    eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0IiwibmFtZSI6IkFsaSIsImlhdCI6MTczNTY4OTYwMCwiZXhwIjoxNzM1NjkzMjAwfQ.5e9ln7xvAcXCcrDMOO3KhV0Y9N9TqqLXChRH8j8zfkA

    نتیجه: امضا درست است، ولی توکن منقضی شده است.

  • همان توکن با رمز نادرست

    اگر رمز یک نویسه هم فرق کند، امضا نمی‌خواند.

    eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0IiwibmFtZSI6IkFsaSIsImlhdCI6MTczNTY4OTYwMCwiZXhwIjoxNzM1NjkzMjAwfQ.5e9ln7xvAcXCcrDMOO3KhV0Y9N9TqqLXChRH8j8zfkA

    نتیجه: امضا نامعتبر است: توکن با این کلید امضا نشده یا محتوایش تغییر کرده است.

  • توکن بدون امضا

    توکنی با الگوریتم none که هر کسی می‌تواند بسازد؛ ابزار آن را هرگز معتبر نمی‌داند.

    eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJzdWIiOiIxMjM0IiwiYWRtaW4iOnRydWV9.

    نتیجه: الگوریتم «none» یعنی توکن امضا ندارد و هر کسی می‌تواند آن را بسازد؛ این ابزار چنین توکنی را هرگز معتبر نمی‌داند.

اشتباه‌های رایج

  • یکی دانستن خواندن و معتبر بودن: هر کسی می‌تواند payload را بخواند یا عوض کند. تا امضا بررسی نشده، به محتوای توکن اعتماد نکنید.
  • گذاشتن اطلاعات محرمانه در payload: JWT رمزگذاری نمی‌شود، فقط امضا می‌شود. شماره‌ی کارت، گذرواژه یا اطلاعات شخصی را در آن نگذارید.
  • پذیرفتن الگوریتم از خود توکن در کد سرور: سرور باید الگوریتم مجاز را خودش تعیین کند، وگرنه توکن none یا الگوریتم دیگری ممکن است پذیرفته شود.
  • قالب اشتباه رمز: اگر رمز HMAC در سرور به شکل base64 تعریف شده، باید همان قالب را انتخاب کنید؛ وگرنه امضا نامعتبر به نظر می‌رسد.
  • رمز کوتاه برای HS256: رمز مشترک باید دست‌کم ۳۲ بایت تصادفی باشد. برای ساختنش از سازنده‌ی گذرواژه و کلید استفاده کنید.

امضای متقارن و نامتقارن

در HS256 و خانواده‌اش، سازنده و بررسی‌کننده یک رمز مشترک دارند؛ هر کس رمز را داشته باشد می‌تواند توکن معتبر بسازد. در RS256، ES256 و EdDSA، توکن با کلید خصوصی امضا و با کلید عمومی بررسی می‌شود، پس سرویس‌های دیگر می‌توانند توکن را بررسی کنند بی‌آنکه بتوانند توکن جعلی بسازند.

سرویس‌های ورود معمولاً کلیدهای عمومی‌شان را در یک نشانی JWKS منتشر می‌کنند و در header هر توکن با kid می‌گویند کدام کلید را به کار برده‌اند.

پرسش‌های متداول

کلید یا رمز من به سرور فرستاده می‌شود؟
خیر؛ رمزگشایی، بررسی و امضا با Web Crypto در همین مرورگر انجام می‌شود و کلیدها نه در نشانی صفحه می‌روند و نه ذخیره می‌شوند. با این حال رمز و کلید واقعی محیط عملیاتی را هیچ‌جا نچسبانید.
چرا توکن با الگوریتم «none» همیشه رد می‌شود؟
توکن none امضا ندارد و هر کسی می‌تواند محتوایش را عوض کند؛ پذیرفتن آن یکی از رایج‌ترین آسیب‌پذیری‌های JWT است، پس این ابزار هرگز آن را معتبر نمی‌داند.
پیام «الگوریتم با کلید نمی‌خواند» یعنی چه؟
نوع کلید با الگوریتم توکن جور نیست؛ مثلاً توکن HS256 است ولی کلید عمومی RSA داده‌اید. این ابزار کلید عمومی را هرگز به‌جای رمز HMAC به کار نمی‌برد تا حمله‌ی جابه‌جایی الگوریتم ممکن نباشد.
کلید آزمایشی کجا نگه داشته می‌شود؟
فقط در حافظه‌ی همین صفحه؛ با بستن یا تازه‌کردن صفحه از بین می‌رود. از آن فقط برای آزمایش استفاده کنید.

ابزارهای مرتبط