بتل کد Battle Codeدارد باز می‌شود…

ورود و اجازه

سایت از کجا می‌داند تو کی هستی و چه کارهایی اجازه داری؟ کلمه‌های ورود، ثبت‌نام، نشست، کوکی و توکن جواب همین سؤال‌اند.

log in یا login؟

وقتی فعل است جدا نوشته می‌شود و وقتی اسم یا صفت است سرهم: Please log in (فعل)، the login page (صفت)، Your login failed (اسم). همین قاعده برای log out و logout، sign up و signup، و set up و setup هم هست. راه امتحانش: اگر می‌شود قبلش to گذاشت (to log in)، فعل است و جدا.

هشت کلمه‌ی این درس

authentication (آثِنتیکِیشِن): احراز هویت؛ ثابت کردن این که کی هستی

authentic در انگلیسی یعنی اصل و واقعی. authentication یعنی بررسی این که تو واقعاً همانی هستی که می‌گویی. ساده‌ترین شکلش اسم کاربری و رمز عبور است؛ شکل‌های دیگرش کد پیامکی، اثر انگشت و توکن است. مثل نشان دادن کارت شناسایی دم در. سؤالش این است: «تو کی هستی؟» و با authorization فرق دارد که می‌پرسد «چه کارهایی اجازه داری؟».

This endpoint requires authentication, so send your token.

این اندپوینت احراز هویت می‌خواهد، پس توکنت را بفرست.

authorization (آثِرایزِیشِن): مجوز؛ این که اجازه‌ی چه کارهایی را داری

authorize یعنی اجازه دادن و authority یعنی اختیار. authorization بعد از شناختن تو شروع می‌شود و می‌گوید اجازه‌ی چه کارهایی را داری. همه‌ی کسانی که وارد یک سایت شده‌اند می‌توانند نوشته‌ها را بخوانند، ولی فقط مدیر می‌تواند پاکشان کند. مثل هتل: کارت شناسایی‌ات می‌گوید کی هستی (authentication)، ولی کلید فقط در اتاق خودت را باز می‌کند (authorization).

You need admin authorization to delete other users.

برای پاک کردن کاربرهای دیگر، مجوز مدیر لازم داری.

login (لاگین): ورود به حساب کاربری

log در قدیم دفتری بود که ناخدا رفت‌وآمدهای کشتی را در آن می‌نوشت. log in یعنی «اسمت را در دفتر بنویس و وارد شو». امروز login یعنی وارد شدن به حساب با اسم کاربری و رمز عبور، تا سایت بداند تو کی هستی و چیزهای خودت را نشانت بدهد. به صفحه‌ای که این کار در آن انجام می‌شود login page و به اسم و رمزت login details می‌گویند.

Login failed: wrong username or password.

ورود ناموفق بود: نام کاربری یا رمز عبور اشتباه است.

logout (لاگ‌اوت): خروج از حساب کاربری

logout برعکس login است: out یعنی بیرون. وقتی log out می‌کنی، سایت نشست تو را می‌بندد و دیگر تو را نمی‌شناسد تا دوباره وارد شوی. روی کامپیوتر مشترک (مدرسه، کتابخانه، کافی‌نت) این کار خیلی مهم است؛ اگر خارج نشوی، نفر بعدی با حساب تو روبه‌رو می‌شود. از دید برنامه‌نویس، logout یعنی پاک کردن session یا باطل کردن توکن.

Click your name, then choose Logout from the menu.

روی اسمت بزن و بعد از منو Logout را انتخاب کن.

sign up (ساین آپ): ثبت‌نام کردن؛ ساختن حساب تازه

sign یعنی امضا کردن. sign up یعنی «اسمت را در فهرست بنویس»، یعنی ثبت‌نام کن. در سایت‌ها sign up یعنی ساختن یک حساب تازه برای اولین بار: اسم، ایمیل و رمز می‌دهی و از آن به بعد با همان‌ها وارد می‌شوی. فرقش با ورود این است: sign up یک بار و برای ساختن حساب است، sign in یا log in هر بار و برای وارد شدن به آن.

Sign up for a free account to save your progress.

برای ذخیره شدن پیشرفتت، یک حساب رایگان بساز.

session (سِشِن): نشست؛ مدتی که سرور تو را به یاد دارد

session در انگلیسی یعنی یک جلسه یا نوبت: از وقتی شروع می‌کنی تا وقتی تمام می‌کنی. HTTP فراموش‌کار است و هر درخواست را جدا می‌بیند، انگار بار اول است که تو را دیده. session راه‌حل این مشکل است: وقتی وارد می‌شوی، سرور یک پرونده برایت باز می‌کند و شماره‌اش (session ID) را به مرورگرت می‌دهد. مرورگر با هر درخواست این شماره را نشان می‌دهد و سرور می‌فهمد که هنوز خودت هستی. مثل شماره‌ای که در رستوران روی میزت می‌گذارند. با logout یا بعد از مدتی بی‌کاری، session تمام می‌شود.

Your session has expired, please log in again.

نشست تو تمام شده است، لطفاً دوباره وارد شو.

cookie (کوکی): تکه‌داده‌ی کوچکی که سایت در مرورگر تو نگه می‌دارد

cookie در انگلیسی یعنی شیرینی کوچک یا کلوچه. در وب، cookie یک تکه متن کوچک است که سایت به مرورگرت می‌دهد و مرورگر آن را نگه می‌دارد و با هر درخواست بعدی به همان سایت پس می‌فرستد. این‌طوری سایت تو را به یاد می‌آورد: که وارد شده‌ای، سبد خریدت چیست، زبانت کدام است. مثل دستبند کاغذی شهربازی: یک بار دم در می‌گیری و بعد هر جا نشانش بدهی می‌فهمند بلیت داری. شماره‌ی session معمولاً در یک کوکی نگه داشته می‌شود.

The site stores a cookie in your browser to remember you.

سایت برای این که تو را به یاد بیاورد، یک کوکی در مرورگرت ذخیره می‌کند.

access token (اَکسِس توکِن): توکن دسترسی؛ بلیت موقت کار با API

access یعنی دسترسی. token در انگلیسی یعنی ژتون: همان سکه‌ای که به‌جای پول در دستگاه بازی می‌اندازی. access token رشته‌ای بلند از حرف و عدد است که بعد از ورود می‌گیری و با هر درخواست در هدر می‌فرستی تا سرور بداند کی هستی و چه اجازه‌ای داری. خوبی‌اش این است که لازم نیست رمز عبورت را هر بار بفرستی. مثل کارت اتاق هتل: یک بار دم پذیرش خودت را معرفی می‌کنی و بعد کارت در را باز می‌کند. کارت هم بعد از مدتی باطل می‌شود؛ توکن هم معمولاً چند دقیقه تا چند روز عمر دارد. اگر کسی توکنت را داشته باشد انگار خود توست، پس آن را جایی نشان نده.

The access token expires after one hour.

توکن دسترسی بعد از یک ساعت باطل می‌شود.

راهنمای حساب کاربری

How accounts work

First, sign up with your email. After that, go to the login page and enter your password. This step is called authentication: we check who you are.

After login, the site saves a cookie in your browser and starts a session, so you stay logged in for seven days. For the API, you get an access token instead of a cookie.

When you finish on a shared computer, always click Logout.

حساب‌ها چطور کار می‌کنند

اول با ایمیلت ثبت‌نام کن. بعد به صفحه‌ی ورود برو و رمز عبورت را وارد کن. به این مرحله احراز هویت می‌گویند: بررسی می‌کنیم که تو کی هستی.

بعد از ورود، سایت یک کوکی در مرورگرت ذخیره می‌کند و یک نشست شروع می‌کند، پس هفت روز واردشده می‌مانی. برای API، به‌جای کوکی یک توکن دسترسی می‌گیری.

وقتی کارت روی یک کامپیوتر مشترک تمام شد، همیشه روی Logout بزن.