برای انجام عملیات `Authentication` روش‌های متعددی وجود دارد. همچنین برای یادآوری و جلوگیری از تکرار این عملیات مکانیزم‌های مختلفی طراحی شده است. در سال‌های گذشته (و همچنین در حال حاضر) یکی از روش‌های متداول برای به خاطرسپاری عملیات تشخیص هویت استفاده از `Cookie`ها بوده است. اما با طراحی استاندارد `RFC 7519` و پیاده سازی آن در زبان‌های مختلف، این روش محبوبیت و کاربرد زیادی پیدا کرده است. در این سوال از شما می‌خواهیم که یک روال اعتبارسنجی کامل با این روش را پیاده سازی نمایید. ## ساختار پروژه + کل کدهای پروژه در یک فایل به نام `jwt.php` نوشته خواهد شد. + ساختار این فایل بسیار ساده بوده و تنها دارای ۲ تابع می باشد که بایستی با شرایطی که در قسمت بعد ذکر شده است تکمیل شوند. + فایل `users.json` حاوی یک آرایه از داده‌های آزمایشی برای کاربران می باشد که برای انجام عملیات `Authentication` از محتوای این فایل باید استفاده کنید. + پروژه اولیه را می‌توانید از [اینجا](https://quera.ir/qbox/download/UVZr1TAyFu/jwt.zip) دانلود کنید. ## توضیحات پروژه + برای تست و اجرای پروژه بهتر است با اجرای دستور `php -S 127.0.0.1:5555 -t ./` در پوشه برنامه از سرور `builtin` استفاده کنید (پورت و آدرس قابل تغییر است). + تابع `checkLogin` را به صورتی تکمیل کنید که با ارسال پارامترهای `username` و `password` از طریق متد `POST`، این دو پارامتر با اطلاعات موجود در فایل `users.json` تطبیق داده شده و در صورتی که اطلاعات صحیح باشد خروجی زیر با فرمت *JSON* چاپ شود: ```json {"type":"login_success","token":"JWT_TOKEN"} ``` و در صورتیکه پارامترهای وارد شده با هیچ یک از اطلاعات موجود در فایل مطابقت نداشته باشد خروجی زیر چاپ شود: ```json {"type":"login_failure","token":""} ``` > واضح است که به جای عبارت `JWT_TOKEN` باید توکن معتبر و صحیح جایگذاری شود. + در نظر داشته باشید که `JWT token` تولید شده دارای زمان بوده و پس از گذشت مدت زمان معینی که بر اساس واحد زمان ثانیه، در ثابت `TOKEN_LIFETIME` در بالای فایل `jwt.php` ذکر شده است بایستی منقضی شود. لازم به ذکر است که این خط را از بالای فایل نباید حذف کنید و نام ثابت را هم نباید تغییر دهید (شما می توانید عدد زمان را تغییر دهید، این عدد در زمان ارزیابی پاسخ هم تغییر خواهد کرد). + با فراخوانی تابع `getData` باید حالت‌های زیر در نظر گرفته شود : - اگر `token` اعتبار سنجی در `header` درخواست وجود نداشته باشد یا طول آن `0` باشد پاسخ اسکریپت `403 Forbidden` بوده و `body` باید تهی باشد. یعنی هیچ متن یا کاراکتری در خروجی نداشته باشیم و فقط این موضوع از طریق `header` به کلاینت اطلاع داده می شود. - اگر `token` نا معتبری به سمت اسکریپت ارسال شود بایستی `header` به صورت `401 Unauthorized` بوده و در `body` عبارت `INVALID_TOKEN` به عنوان خروجی نمایش داده شود. - اگر `token` منقضی شده‌ای به سمت اسکریپت ارسال شود بایستی `header` به صورت `401 Unauthorized` بوده و در `body` عبارت `EXPIRED_TOKEN` به عنوان خروجی نمایش داده شود. - اگر `token` صحیحی به سمت اسکریپت ارسال شود بایستی المان `keys` مربوط به کاربر صاحب `token` به صورت `json encoded` در خروجی چاپ شود (نیازی به تغییر `header` پاسخ نیست). توجه داشته باشید که در موارد بالا `HTTP Response Code` و`HTTP Response Verb` بررسی خواهد شد. برای پاسخ به این سوال می تواند از پکیج های `composer` هم استفاده کنید (هرچند که الزامی نیست و بدون نیاز به پکیج ها هم سوال قابل حل است) اما در صورت تمایل فایل `composer.json` را همراه با فایل `jwt.php` فشرده کنید و به عنوان جواب ارسال کنید. ## آن چه باید آپلود کنید فایل پاسخ خود را با نام `jwt.php` ذخیره کرده و به صورت فایل *ZIP* آپلود کنید.