Download station/adminauth.py from delaris/desk-render: direct link, hf CLI and curl.
- Browser
- Download file 9.44 kB
-
https://huggingface.co/delaris/desk-render/resolve/main/station/adminauth.py
- Command line
-
hf download hf://delaris/desk-render/station/adminauth.py
-
curl -L -o adminauth.py https://huggingface.co/delaris/desk-render/resolve/main/station/adminauth.py
9.44 kB
| #!/usr/bin/env python3 | |
| # -*- coding: utf-8 -*- | |
| """پنل مدیریت — احراز هویت محلی با شناسه و رمز (نسخهٔ ۰.۱.۰). | |
| سه بخش برنامه (بررسی سلامت، مجوز دسترسی/عیبیابی، گواهی استفاده) به «پنل مدیریت» رفتهاند و | |
| این پوشه کلید ورود آنها است: | |
| · رمز هرگز بهصورت متن ذخیره نمیشود؛ فقط «نمک» و «هش» PBKDF2-SHA256 در `config/admin.json`. | |
| · اگر متغیرهای محیطی `STATION_ADMIN_ID` و `STATION_ADMIN_PASS` ست شده باشند، همانها | |
| اولویت دارند (مناسب زمانی که نمیخواهید رمز روی دیسک بماند). | |
| · توکن ورود کوتاهعمر است و پنجرهٔ خطای ورود هم محدود میشود (پنج تلاش در پنج دقیقه). | |
| · پنل برای همین رایانه است؛ اگر روی شبکه بازش کردید، آن را پشت HTTPS بگذارید. | |
| کارهایی که این پوشه نمیکند (صادقانه): رمز را از رهگیری شبکه در HTTP ساده حفظ نمیکند؛ | |
| مدیریت چند کاربر و نقش ندارد؛ لاگِ دسترسی جداگانه نمیسازد. | |
| """ | |
| from __future__ import annotations | |
| import argparse | |
| import hashlib | |
| import hmac | |
| import json | |
| import os | |
| import secrets | |
| import sys | |
| import time | |
| from pathlib import Path | |
| BASE = Path(__file__).resolve().parent | |
| CONFIG = BASE / "config" / "admin.json" | |
| VERSION = "0.1.0" | |
| TOKEN_TTL_SECONDS = 60 * 60 # یک ساعت بیکاری | |
| FAIL_WINDOW_SECONDS = 5 * 60 | |
| FAIL_LIMIT = 5 | |
| PBKDF2_ROUNDS = 200_000 | |
| MIN_PASS_LENGTH = 8 | |
| SESSIONS: dict[str, dict] = {} | |
| FAILS: dict[str, list[float]] = {} | |
| # ------------------------------------------------------------------ تنظیمات | |
| def _hash(password: str, salt_hex: str) -> str: | |
| dk = hashlib.pbkdf2_hmac("sha256", password.encode("utf-8"), bytes.fromhex(salt_hex), | |
| PBKDF2_ROUNDS) | |
| return dk.hex() | |
| def _same(a, b) -> bool: | |
| """مقایسهٔ زمانثابت که با متن فارسی هم کار میکند (compare_digest فقط ASCII میپذیرد).""" | |
| return hmac.compare_digest(str(a or "").encode("utf-8"), str(b or "").encode("utf-8")) | |
| def env_credentials() -> tuple[str, str] | None: | |
| """اگر متغیرهای محیطی ست باشند، همانها معتبرند و فایل خوانده نمیشود.""" | |
| user = os.environ.get("STATION_ADMIN_ID", "").strip() | |
| password = os.environ.get("STATION_ADMIN_PASS", "") | |
| return (user, password) if user and password else None | |
| def load_config(path: Path | str | None = None) -> dict | None: | |
| p = Path(path or CONFIG) | |
| if not p.exists(): | |
| return None | |
| try: | |
| data = json.loads(p.read_text(encoding="utf-8")) | |
| except (json.JSONDecodeError, OSError): | |
| return None | |
| return data if isinstance(data, dict) and data.get("id") and data.get("hash") else None | |
| def set_credentials(user_id: str, password: str, *, path: Path | str | None = None) -> Path: | |
| """شناسه و رمز را ذخیره میکند (فقط هش). رمز کوتاه رد میشود.""" | |
| user_id = str(user_id or "").strip() | |
| if not user_id: | |
| raise ValueError("شناسهٔ ورود خالی است.") | |
| if len(str(password or "")) < MIN_PASS_LENGTH: | |
| raise ValueError(f"رمز باید دستکم {MIN_PASS_LENGTH} نویسه باشد.") | |
| p = Path(path or CONFIG) | |
| p.parent.mkdir(parents=True, exist_ok=True) | |
| salt = secrets.token_hex(16) | |
| p.write_text(json.dumps({"version": VERSION, "id": user_id, "salt": salt, | |
| "rounds": PBKDF2_ROUNDS, "hash": _hash(password, salt)}, | |
| ensure_ascii=False, indent=1), encoding="utf-8") | |
| try: | |
| p.chmod(0o600) # فقط صاحب پرونده بخواند | |
| except OSError: | |
| pass | |
| return p | |
| def is_configured(path: Path | str | None = None) -> bool: | |
| return env_credentials() is not None or load_config(path) is not None | |
| def verify_credentials(user_id: str, password: str, *, path: Path | str | None = None) -> bool: | |
| """مقایسهٔ زمانثابت؛ شناسهٔ اشتباه هم همان جواب را میدهد (بدون افشای کدام غلط بود).""" | |
| env = env_credentials() | |
| if env: | |
| same_id = _same(user_id, env[0]) | |
| same_pass = _same(password, env[1]) | |
| return bool(same_id and same_pass) | |
| cfg = load_config(path) | |
| if not cfg: | |
| return False | |
| rounds = int(cfg.get("rounds") or PBKDF2_ROUNDS) | |
| salt = str(cfg.get("salt") or "") | |
| try: | |
| dk = hashlib.pbkdf2_hmac("sha256", str(password or "").encode("utf-8"), | |
| bytes.fromhex(salt), rounds) | |
| except ValueError: | |
| return False | |
| same_id = _same(user_id, cfg.get("id")) | |
| same_pass = _same(dk.hex(), cfg.get("hash")) | |
| return bool(same_id and same_pass) | |
| # ------------------------------------------------------------------ توکن و محدودیت | |
| def issue_token(user_id: str, *, now: float | None = None) -> str: | |
| t = now if now is not None else time.time() | |
| token = secrets.token_hex(24) | |
| SESSIONS[token] = {"id": user_id, "expires": t + TOKEN_TTL_SECONDS, "made": t} | |
| return token | |
| def check_token(token: str | None, *, now: float | None = None) -> bool: | |
| """توکن معتبر است؟ هر بررسی، عمر توکن را تازه میکند (بیکاری = انقضا).""" | |
| if not token: | |
| return False | |
| rec = SESSIONS.get(str(token)) | |
| if not rec: | |
| return False | |
| t = now if now is not None else time.time() | |
| if rec["expires"] < t: | |
| SESSIONS.pop(str(token), None) | |
| return False | |
| rec["expires"] = t + TOKEN_TTL_SECONDS | |
| return True | |
| def revoke_token(token: str | None) -> bool: | |
| return bool(SESSIONS.pop(str(token), None)) | |
| def active_tokens() -> int: | |
| return len(SESSIONS) | |
| def rate_limited(ip: str, *, now: float | None = None) -> bool: | |
| """آیا این نشانی تازه بیش از حد خطا زده است؟""" | |
| t = now if now is not None else time.time() | |
| hits = [x for x in FAILS.get(str(ip), []) if t - x < FAIL_WINDOW_SECONDS] | |
| FAILS[str(ip)] = hits | |
| return len(hits) >= FAIL_LIMIT | |
| def note_failure(ip: str, *, now: float | None = None) -> int: | |
| t = now if now is not None else time.time() | |
| hits = [x for x in FAILS.get(str(ip), []) if t - x < FAIL_WINDOW_SECONDS] | |
| hits.append(t) | |
| FAILS[str(ip)] = hits | |
| return len(hits) | |
| def reset_failures(ip: str) -> None: | |
| FAILS.pop(str(ip), None) | |
| def login(user_id: str, password: str, *, ip: str = "؟", path: Path | str | None = None, | |
| now: float | None = None) -> dict: | |
| """یکجا: محدودیت، بررسی، توکن. خروجی همیشه «ok» دارد تا کارساز ساده بماند.""" | |
| if not is_configured(path): | |
| return {"ok": False, "error": ("هنوز شناسه و رمز پنل ساخته نشده. یکبار این را اجرا " | |
| "کنید: python3 adminauth.py --set-pass <رمز>")} | |
| if rate_limited(ip, now=now): | |
| return {"ok": False, "rate_limited": True, | |
| "error": "تلاشهای ناموفق زیاد بود؛ چند دقیقه صبر کنید."} | |
| if not verify_credentials(user_id, password, path=path): | |
| left = FAIL_LIMIT - note_failure(ip, now=now) | |
| return {"ok": False, "error": f"شناسه یا رمز درست نیست. {max(left, 0)} تلاش تا قفل موقت."} | |
| reset_failures(ip) | |
| token = issue_token(str(user_id), now=now) | |
| return {"ok": True, "token": token, "ttl_seconds": TOKEN_TTL_SECONDS, | |
| "expires_in_minutes": TOKEN_TTL_SECONDS // 60} | |
| # ------------------------------------------------------------------ خط فرمان | |
| def main(argv: list[str] | None = None) -> int: | |
| ap = argparse.ArgumentParser(description="کلید ورود پنل مدیریت (شناسه و رمز)") | |
| ap.add_argument("--set-id", default="", help="شناسهٔ ورود") | |
| ap.add_argument("--set-pass", default="", help="رمز ورود (فقط هش ذخیره میشود)") | |
| ap.add_argument("--status", action="store_true", help="وضعیت پیکربندی") | |
| ap.add_argument("--check", nargs=2, metavar=("ID", "PASS"), help="آزمودن یک جفت شناسه/رمز") | |
| a = ap.parse_args(argv) | |
| if a.set_pass: | |
| path = set_credentials(a.set_id or "admin", a.set_pass) | |
| print(f"ذخیره شد: {path} (فقط هش؛ رمز روی دیسک نیست)") | |
| return 0 | |
| if a.check: | |
| print("درست است ✅" if verify_credentials(a.check[0], a.check[1]) else "درست نیست ✗") | |
| return 0 if verify_credentials(*a.check) else 1 | |
| if is_configured(): | |
| cfg = load_config() | |
| where = "متغیر محیطی" if env_credentials() else f"پروندهٔ {CONFIG}" | |
| print(f"پنل مدیریت پیکربندی شده است — از {where}" | |
| + (f" · شناسه: {cfg['id']}" if cfg else "")) | |
| return 0 | |
| print("پنل مدیریت هنوز پیکربندی نشده است.") | |
| return 1 | |
| if __name__ == "__main__": | |
| raise SystemExit(main()) | |