File size: 9,442 Bytes
87dd0fa | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 | #!/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())
|