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

جلسه‌ی 23: چه کسی می‌پرسد؟ Who Is Asking?

حالا که توکن داریم، سرور می‌فهمد چه کسی می‌پرسد. یک تابع @app.before پیش از همه‌ی مسیرها اجرا می‌شود، کاربر را از روی توکن در request.user می‌گذارد و جلوی مسیرهای خصوصی را بدون ورود می‌گیرد. هر کس فقط یادداشت‌های خودش را می‌بیند (403، یا 404 برای پنهان کردن)، و خروج یعنی پاک کردن توکن.

در این جلسه یاد می‌گیری

درس

🔐 قانون طلایی این دوره: سرور امانت‌دار است. هر سروری که می‌سازی داده‌ی آدم‌ها را نگه می‌دارد: اسم، امتیاز، یادداشت، رمز. پس به هر چه از بیرون می‌آید شک کن، رمز را هیچ‌وقت خام نگه ندار و داده‌ی کسی را به دیگری نشان نده. فقط سرورهای خودت را امتحان کن. سرور این دوره ساختگی است و داخل همین صفحه کار می‌کند: هر بار که برنامه را اجرا می‌کنی از صفر ساخته می‌شود، پس هر چه می‌خواهی امتحان کن.

یادت هست؟ در جلسه‌ی ۲۲ مشتری توکن را با headers={"Authorization": "Bearer " + token} فرستاد و GET /me با request.token در dict tokens اسم کاربر را پیدا کرد؛ توکن ناشناس یعنی 401. در این جلسه، برای کوتاه ماندن برنامه‌ها، یک تابع کوچک log_in(name) جای POST /login را می‌گیرد: همان کار را می‌کند (توکن تازه می‌سازد و کنار اسم نگه می‌دارد) و هدر آماده را برمی‌گرداند.

from server import app, ask, request, new_token

tokens = {}

def log_in(name):
    token = new_token()
    tokens[token] = name
    return {"Authorization": "Bearer " + token}

@app.get("/me")
def me():
    if request.token not in tokens:
        return {"error": "log in first"}, 401
    return {"name": tokens[request.token]}

sara = log_in("Sara")
ask("GET /me", headers=sara)
ask("GET /me")

یک بار، برای همه. اگر ده مسیر خصوصی داشته باشیم، باید ده بار توکن را بررسی کنیم، و یک بار فراموش کردن کافی است. @app.before تابعی بی‌ورودی را پیش از هر مسیری اجرا می‌کند. آنجا کاربر را از روی توکن پیدا می‌کنیم و در request.user می‌گذاریم؛ بعد هر مسیری فقط request.user را می‌خواند. tokens.get(request.token) اسم را می‌دهد، یا None اگر توکن نیامده یا ناشناس است.

from server import app, ask, request, new_token

tokens = {}

def log_in(name):
    token = new_token()
    tokens[token] = name
    return {"Authorization": "Bearer " + token}

@app.before
def who_is_asking():
    request.user = tokens.get(request.token)

@app.get("/")
def home():
    if request.user is None:
        return "Hello, guest!"
    return "Hello, " + request.user + "!"

ask("GET /", headers=log_in("Sara"))
ask("GET /")

نگهبان دم در. اگر تابع before چیزی برگرداند (یا abort کند)، همان جواب است و مسیر اصلاً اجرا نمی‌شود. پس می‌شود نگهبان ساخت. دو راه داریم: فقط مسیرهایی را ببندیم که با /notes شروع می‌شوند (request.path.startswith("/notes")؛ startswith می‌گوید متن با این تکه شروع می‌شود یا نه)، یا همه را ببندیم جز یک فهرست عمومی. راه دوم امن‌تر است: مسیر تازه‌ای که فراموش کنی، خودبه‌خود بسته است.

from server import app, ask, request, abort, new_token

tokens = {}
PUBLIC = ["/"]

def log_in(name):
    token = new_token()
    tokens[token] = name
    return {"Authorization": "Bearer " + token}

@app.before
def guard():
    request.user = tokens.get(request.token)
    if request.path not in PUBLIC and request.user is None:
        abort(401, "log in first")

@app.get("/")
def home():
    return "Welcome! Log in to see your notes."

@app.get("/notes")
def my_notes():
    return {"owner": request.user, "notes": []}

ask("GET /")
ask("GET /notes")
ask("GET /notes", headers=log_in("Mina"))

401 یا 403؟ 401 (Unauthorized) یعنی «نمی‌دانم کی هستی»: توکن نیامده یا ناشناس است. 403 (Forbidden) یعنی «می‌دانم کی هستی، ولی این مال تو نیست». هر یادداشت یک صاحب (owner) دارد. سارا وارد شده، پس 401 نمی‌گیرد؛ ولی اگر یادداشت علی را بخواهد، 403 می‌گیرد.

from server import app, ask, request, abort, new_token

tokens = {}

def log_in(name):
    token = new_token()
    tokens[token] = name
    return {"Authorization": "Bearer " + token}

notes = {1: {"id": 1, "owner": "Sara", "text": "Buy a gift for Mina"},
         2: {"id": 2, "owner": "Ali", "text": "Football at 5"}}

@app.before
def guard():
    request.user = tokens.get(request.token)
    if request.path.startswith("/notes") and request.user is None:
        abort(401, "log in first")

@app.get("/notes/<int:note_id>")
def one_note(note_id):
    if note_id not in notes:
        abort(404, "no such note")
    if notes[note_id]["owner"] != request.user:
        abort(403, "this note is not yours")
    return notes[note_id]

sara = log_in("Sara")
ask("GET /notes/1", headers=sara)
ask("GET /notes/2", headers=sara)
ask("GET /notes/2")

فقط مال خودت، و گاهی پنهان. صاحب یادداشت تازه همیشه request.user است، نه چیزی که مشتری در JSON نوشته. فهرست هم فقط یادداشت‌های خود آدم است: WHERE owner = ? با request.user. یک نکته‌ی دیگر: 403 به سارا می‌گوید یادداشت ۲ وجود دارد. خیلی از سرورها برای چیزی که مال تو نیست همان 404 را می‌دهند تا چیزی لو نرود. با WHERE id = ? AND owner = ? هر دو حالت یک جواب دارند.

from server import app, ask, request, abort, db, new_token

db.run("CREATE TABLE notes (id INTEGER PRIMARY KEY, owner TEXT, text TEXT)")
tokens = {}

def log_in(name):
    token = new_token()
    tokens[token] = name
    return {"Authorization": "Bearer " + token}

@app.before
def guard():
    request.user = tokens.get(request.token)
    if request.path.startswith("/notes") and request.user is None:
        abort(401, "log in first")

@app.post("/notes")
def add_note():
    done = db.run("INSERT INTO notes (owner, text) VALUES (?, ?)", (request.user, request.json["text"]))
    return {"id": done.id, "text": request.json["text"]}, 201

@app.get("/notes/<int:note_id>")
def one_note(note_id):
    note = db.one("SELECT id, text FROM notes WHERE id = ? AND owner = ?", (note_id, request.user))
    if note is None:
        abort(404, "no such note")
    return note

sara = log_in("Sara")
ali = log_in("Ali")
ask("POST /notes", {"text": "Football at 5", "owner": "Sara"}, headers=ali)
ask("GET /notes/1", headers=ali)
ask("GET /notes/1", headers=sara)

خروج یعنی پاک کردن توکن. اگر دکمه‌ی «خروج» فقط توکن را از گوشی پاک کند، توکن روی سرور هنوز کار می‌کند و هر کس نسخه‌ای از آن داشته باشد، هنوز وارد است. پس POST /logout توکن را از tokens پاک می‌کند: del tokens[request.token] (del یک کلید را با مقدارش از dict برمی‌دارد) و "", 204 برمی‌گرداند. بعد از آن همان توکن 401 می‌گیرد.

from server import app, ask, request, abort, new_token

tokens = {}
PUBLIC = ["/"]

def log_in(name):
    token = new_token()
    tokens[token] = name
    return {"Authorization": "Bearer " + token}

@app.before
def guard():
    request.user = tokens.get(request.token)
    if request.path not in PUBLIC and request.user is None:
        abort(401, "log in first")

@app.get("/me")
def me():
    return {"name": request.user}

@app.post("/logout")
def logout():
    del tokens[request.token]
    return "", 204

sara = log_in("Sara")
ask("GET /me", headers=sara)
ask("POST /logout", headers=sara)
ask("GET /me", headers=sara)

⚠️ اشتباه‌های رایج:
- باور کردن اسمی که مشتری می‌فرستد (request.json["owner"] یا ?user=Sara): هر کس می‌تواند هر اسمی بنویسد. کاربر فقط از توکن می‌آید: request.user.
- نگهبان با request.path == "/notes": /notes/3 از آن رد می‌شود. startswith یا فهرست عمومی.
- بررسی صاحب در GET ولی نه در DELETE و PUT: هر مسیری که به یک چیز دست می‌زند، باید صاحبش را بررسی کند.
- tokens[request.token] به‌جای tokens.get(request.token): وقتی توکنی نیامده، خطای KeyError می‌دهد.
- خروجی که توکن را روی سرور پاک نمی‌کند.

مثال‌های این جلسه

چالش‌ها

  1. The Steps of Logging In (آسان)
  2. Put a Guard at the Door (آسان)
  3. 401 or 403? (متوسط)
  4. Only My Notes (متوسط)
  5. Not Yours: 403 (سخت)
  6. Log Out for Real (سخت)

بیشتر بخوان

← جلسه‌ی 22: ورود: توکن جلسه‌ی 24: پروژه: دفترچه‌ی یادداشت خصوصی →