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

جلسه‌ی 28: پروژه: قفل کردن یک API Project: Lock Down the API

پایان فاز ۷. ایده‌های جلسه‌های ۲۵ تا ۲۷ را یک بار دیگر در یک نگاه می‌بینی، با یک یادآوری از فاز ۶. بعد پروژه: امید با اجازه‌ی خودش از تو خواسته API باشگاهش را پیش از استفاده امن کنی. این API چند حفره دارد و تو در سه قدم قفلش می‌کنی: ثبت‌نام و فهرست اعضا، ورود با قفل، و خطاها، لاگ و جست‌وجو.

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

درس

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

📌 جلسه‌ی ۲۵ در یک نگاه: به کلاینت اعتماد نکن. صفحه را می‌شود دور زد، پس سرور همه‌چیز را دوباره چک می‌کند (هست؟ نوعش درست است؟ در محدوده است؟ وگرنه 400). متن کاربر فقط با ? به SQL می‌رود، هیچ‌وقت چسبانده. از بدنه فقط فیلدهای فهرست مجاز برداشته می‌شود؛ role، coins و id را سرور تعیین می‌کند. قیمت، امتیاز و درست و غلط را خود سرور از داده‌ی خودش حساب می‌کند. و چه کسی می‌پرسد از توکن می‌آید، نه از بدنه.

📌 جلسه‌ی ۲۶ در یک نگاه: محدودیت سرعت. request.ip نشانی فرستنده است و ask(..., ip=...) نشانی دیگری را شبیه‌سازی می‌کند. now() ساعت ساختگی است و wait(n) آن را جلو می‌برد. برای هر نشانی زمان درخواست‌ها را نگه می‌داریم، قدیمی‌ها را دور می‌ریزیم و اگر پر بود 429 Too Many Requests می‌دهیم؛ برای همه‌ی routeها یک‌جا در @app.before. ورود: رمزهای غلطِ پشت سر هم برای هر اسم شمرده می‌شوند و بعد از چند تا، حساب برای مدتی قفل می‌شود؛ رمز درست شمارش را صفر می‌کند.

📌 جلسه‌ی ۲۷ در یک نگاه: خطا، لاگ و رازها. با app.debug = False خرابی فقط 500 و {"error": "something went wrong on the server"} است و جزئیاتش در app.logs. در لاگ: چه کسی، چه کاری، کِی، از کجا؛ هرگز رمز، توکن یا هش. جواب‌ها فقط فیلدهای عمومی دارند (public(user)) و ایمیل هر کس فقط به خودش نشان داده می‌شود (403 برای بقیه). یک پیام برای اسم ناشناخته و رمز غلط. رازها در متغیرهای محیطی، نه در کد. HTTPS درخواست را سر راه قفل می‌کند و CORS می‌گوید صفحه‌ی کدام سایت جواب‌ها را بخواند.

⚠️ اشتباه‌های رایج این فاز:
- «صفحه‌ام چکش می‌کند» و چک نکردن روی سرور.
- چسباندن متن کاربر به SQL با + یا f-string.
- فهرست ممنوع (همه جز role) به‌جای فهرست مجاز.
- چک کردن بعد از عوض کردن داده.
- دور نریختن زمان‌های قدیمی، یا <= به‌جای < در بازه‌ی زمانی.
- یک شمارنده برای همه به‌جای یکی برای هر نشانی یا اسم.
- نوشتن رمز در لاگ، فرستادن return user با هش و ایمیل، یا پیام خطایی که می‌گوید کدام اسم‌ها هستند.

🔁 از فاز ۶: کاربر و ورود. رمز خام نگه داشته نمی‌شود: hash_password("cat123") یک salt$hash می‌دهد و check_password(password, stored) می‌گوید جور است یا نه. ورود درست یک توکن تازه (new_token()) می‌دهد که سرور در tokens[token] = name نگه می‌دارد. کلاینت آن را با Authorization: Bearer ... می‌فرستد و نگهبان @app.before از request.token کاربر را پیدا می‌کند و در request.user می‌گذارد. بدون توکن درست 401، توکن درست ولی چیزِ کس دیگر 403.

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

users = {"sara": hash_password("cat123")}
tokens = {}


@app.post("/login")
def login():
    data = request.json or {}
    stored = users.get(data.get("name"))
    if stored is None or not check_password(data.get("password", ""), stored):
        abort(401, "wrong name or password")
    token = new_token()
    tokens[token] = data["name"]
    return {"token": token}


@app.before
def guard():
    if request.path == "/me":
        if request.token not in tokens:
            return {"error": "log in first"}, 401
        request.user = tokens[request.token]


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


r = ask("POST /login", {"name": "sara", "password": "cat123"}, quiet=True)
ask("GET /me")
ask("GET /me", headers={"Authorization": "Bearer " + r.json["token"]})

🔐 پروژه: قفل کردن API باشگاه. امید برای باشگاه شطرنج مدرسه با عجله یک API نوشته و از تو خواسته پیش از این‌که بچه‌ها از آن استفاده کنند امنش کنی. این همان کاری است که آدم‌های امنیت انجام می‌دهند: با اجازه‌ی صاحب سرور، روی سرور خود او (این‌جا یک سرور ساختگی) حفره پیدا می‌کنند و درستش می‌کنند. حفره‌ها:
1. ثبت‌نام role را از کلاینت قبول می‌کند و رمز را خام نگه می‌دارد.
2. GET /members همه‌ی ستون‌ها را، رمزها هم، به همه نشان می‌دهد.
3. ورود وجود ندارد؛ وقتی بسازی‌اش باید جلوی حدس زدن رمز را بگیرد.
4. GET /search اسم را به SQL چسبانده و خرابی‌ها متن خطای کامل را نشان می‌دهند.
سه قدم: (۱) ثبت‌نام و فهرست اعضا، (۲) ورود با قفل، (۳) debug، لاگ و جست‌وجو. هر قدم روی کد قدم قبل ساخته می‌شود؛ دکمه‌ی «ادامه از کد مرحله‌ی قبلم» کدت را می‌آورد. یادت باشد: سرورِ کسی را بدون اجازه‌ی کتبی او امتحان نکن، و اگر در سایتی واقعی حفره‌ای دیدی، به یک بزرگ‌تر بگو.

API امید، همان‌طور که هست. اجرایش کن و حفره‌ها را در خروجی ببین: رضا خودش را admin کرده، رمز 1 قبول شده و GET /members رمز همه را نشان می‌دهد. این کد شروع قدم اول پروژه است.

from server import app, ask, request, abort, db, hash_password, check_password, now, wait

db.run("CREATE TABLE members (id INTEGER PRIMARY KEY, name TEXT, password TEXT, role TEXT)")

@app.post("/signup")
def signup():
    data = request.json
    role = data.get("role", "member")
    db.run("INSERT INTO members (name, password, role) VALUES (?, ?, ?)", (data["name"], data["password"], role))
    return {"name": data["name"], "role": role}, 201

@app.get("/members")
def members():
    return db.all("SELECT * FROM members ORDER BY id")

@app.get("/search")
def search():
    name = request.args.get("name", "")
    return db.all("SELECT name, role FROM members WHERE name = '" + name + "'")

ask("POST /signup", {"name": "sara", "password": "cat123"})
ask("POST /signup", {"name": "reza", "password": "dog456", "role": "admin"})
ask("POST /signup", {"name": "omid", "password": "1"})
ask("GET /members")
ask("GET /search?name=sara")

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

چالش‌ها

  1. Safe or Leaky? (آسان)
  2. Steps of a Login (آسان)
  3. 400, 429 or 500? (متوسط)
  4. Step 1: Signing Up Safely (متوسط)
  5. Step 2: A Login With a Lock (سخت)
  6. Step 3: Errors, Logs and Search (سخت)

بیشتر بخوان

← جلسه‌ی 27: خطا، لاگ و رازها جلسه‌ی 29: نقشه‌ی API: قبل از کد →