Files
cti/docs/markdown/SECURITY-REMEDIATION-PLAN.md
2026-10-14 23:05:02 +03:30

12 KiB
Raw Permalink Blame History

SECURITY-REMEDIATION-PLAN — نقشه راه رفع عدم‌انطباق‌های امنیتی CTI

هدف: راهنمای گام‌به‌گام برای رفع ۱۸ مورد عدم‌انطباق امنیتی (NC-001 تا NC-018) در سامانه Raymand-CTI 2.0.3. تاریخ: 2026-09-16 مرجع کد: cti-app/ (فرانت) و p-line/ (بک‌اند) قوانین تکمیل: فقط با هماهنگی و تأیید کاربر، مرحله‌به‌مرحله.


1. چارچوب کاری

۱.۱ ترتیب اصلی رفع

مرحله اولویت اقدامات وابسته به
مرحله ۱ بحرانی NC-011 → NC-003 → NC-002 → NC-001 —
مرحله ۲ بالا NC-005 → NC-004 → NC-006 → NC-008 → NC-007 مرحله ۱
مرحله ۳ بالا NC-009 → NC-010 → NC-012 → NC-013 مرحله ۲
مرحله ۴ متوسط NC-014 → NC-015 → NC-016 → NC-017 → NC-018 مرحله ۳

۱.۲ قوانین عمومی

  1. هر مرحله فقط با تأیید کاربر آغاز می‌شود.
  2. ابتدا سند عدم‌انطباق به‌روزرسانی شود، سپس رفع شروع شود.
  3. پس از هر رفع: اسکریپت fill_self_evaluation.py مجدداً اجرا شود تا پاسخ‌نامه docx و MD به‌روزرسانی شوند.
  4. وضعیت NC در جدول عدم‌انطباق به «رفع‌شده» تغییر یابد.
  5. آیتم‌های رمزنگاری/هش (NC-003) بدون بازیابی MD5، با rehash در اولین login موفق به bcrypt مهاجرت می‌شوند.

2. جزئیات هر مرحله

مرحله ۱ — بحرانی

NC-011: مدیریت امن secretها

شواهد:

  • p-line/src/main/resources/application.properties:14 — spring.datasource.password=Mehdi@123
  • p-line/src/main/resources/application.properties:51 — pline.jwt_secret=...متن آشکار...
  • cti-app/src/components/services/PlineTools.tsx:35 — IP هاردکد http://192.168.180.7:8684

اقدام اصلاحی:

  1. خروجی git log --all --full-history -- application.properties را بررسی کنید؛ تمام ارجاع به مقدار قبلی را پاک کنید.
  2. مقادیر حساس را به متغیرهای محیطی (SPRING_DATASOURCE_PASSWORD, PLINE_JWT_SECRET) منتقل کنید.
  3. در Docker/Compose: از secrets یا --env-file استفاده کنید.
  4. انقضای JWT را از ۳۱ روز (jwt. expiration=2678400) به ۲ ساعت کاهش دهید.
  5. IP به‌روزرسانی سازنده در PlineTools.tsx را به متغیر محیطی منتقل کنید.

چک‌لیست اعتبارسنجی:

  • grep -r "Mehdi@123" p-line/ خالی است.
  • grep -r "jwt_secret.*=" p-line/src/main/resources/application.properties خالی است.
  • برنامه بدون password هاردکد استارت می‌شود.

NC-003: حذف MD5

شواهد:

  • p-line/src/main/java/ir/peeco/pline/tools/GlobalTools.java:59-63 — پیاده‌سازی MD5
  • p-line/src/main/java/ir/peeco/pline/controllers/UsersController.java:97 (login)، :166,171 (change-password)، :218,256 (create/update)
  • p-line/src/main/java/ir/peeco/pline/init/Initializer.java:204 — پیش‌فرض admin با MD5("admin")
  • p-line/src/main/java/ir/peeco/pline/controllers/QueueLiveInfoController.java:87,104

طراحی مهاجرت تدریجی:

  1. در GlobalTools.java: یک متد verifyPassword(String raw, String stored) اضافه کنید که:
    • اگر stored شروع به $2a$ یا $2b$ می‌شود → با bcrypt مقایسه کنید.
    • اگر stored یک هش MD5 است → با MD5 مقایسه کنید؛ اگر موفق بود، رمز عبور را rehash با bcrypt و در DB ذخیره کنید.
  2. در UsersController.login() (login موفق): پس از احراز هویت، رمز عبور را rehash کنید.
  3. در Initializer.java:204: پیش‌فرض admin را با bcrypt hash جایگزین کنید.
  4. در تمام مسیرهای create/change-password: فقط از bcrypt استفاده کنید.

چک‌لیست اعتبارسنجی:

  • grep -rn "MD5\|md5\|MessageDigest.*MD5" p-line/src/main/java/ir/peeco/pline/ فقط در GlobalTools.verifyPassword برای backward compatibility باقی بماند.
  • پسورد جدید با bcrypt hash ذخیره می‌شود.
  • ورود admin با bcrypt کار می‌کند.

NC-002: حذف HTTP حساس

شواهد:

  • application.properties:68 — pline.license_url=http://license.raymandcti.com:8008
  • application.properties:69-70 — خطوط مرتبط

اقدام اصلاحی:

  1. URL لایسنس را به HTTPS تغییر دهید یا از متغیر محیطی استفاده کنید.
  2. اگر سرویس لایسنس فقط HTTP پشتیبانی می‌کند، آن را در scope امنیتی خارج کنید.

چک‌لیست اعتبارسنجی:

  • grep -rn "http://" p-line/src/main/resources/application.properties خالی است (جز خطوط غیرحساس مثل تنظیمات UI).
  • درخواست لایسنس با HTTPS یا localhost انجام می‌شود.

NC-001: فعال‌سازی HTTPS/TLS

شواهد:

  • application.properties:3 — server.port=8080 بدون ssl/keystore
  • cti-app/src/components/services/PlineTools.tsx:26 — http://localhost:8080

اقدام اصلاحی:

  1. گواهینامه X.509 معتبر دریافت کنید (Let's Encrypt یا داخلی).
  2. در application.properties:
    server.port=8443
    server.ssl.enabled=true
    server.ssl.key-store=/path/to/keystore.p12
    server.ssl.key-store-password=***
    server.ssl.key-store-type=PKCS12
    
  3. Redirect HTTP (8080) → HTTPS (8443) در فیلتر یا reverse proxy.
  4. در PlineTools.tsx: پروتکل را به https:// و پورت 8443 تغییر دهید.
  5. هدرهای امنیتی را اضافه کنید: Strict-Transport-Security, X-Content-Type-Options, X-Frame-Options, Cache-Control.

چک‌لیست اعتبارسناجی:

  • curl -k https://server:8443/app/get-version کار می‌کند.
  • curl http://server:8080/... ریدایرکت به HTTPS می‌شود.
  • هدرهای امنیتی در پاسخ‌ها موجود است.

مرحله ۲ — احراز هویت و نشست

NC-005: شمارش تلاش ناموفق

شواهد: UsersController.java:83-135 — login بدون شمارنده/قفل

اقدام: شمارنده username/IP اضافه کنید؛ آستانه قابل تنظیم؛ قفل موقت یا غیرفعال‌سازی؛ رفتار یکسان برای کاربر ناشناس.

NC-004: سیاست گذرواژه

شواهد: UsersController.java:137-182 (فقط null-check)، UsersController.java:209 (create بدون validation)

اقدام: policy مرکزی: طول ≥ 8، حروف بزرگ/کوچک، عدد، کاراکتر خاص؛ قابل تنظیم توسط مدیر.

NC-006: CAPTCHA سمت سرور

شواهد: Captcha.tsx:12-22 (Math.random)، Login.tsx:58 (مقایسه در کلاینت)

اقدام: challenge سمت سرور، اعتبارسنجی server-side، عمر کوتاه.

NC-008: logout/revoke

شواهد: هیچ endpoint logout در UsersController؛ App.tsx:50-54 (فقط removeCookies)

اقدام: endpoint logout سرورساز؛ invalidate نشست؛ revoke/rotation توکن؛ ثبت رویداد خروج.

NC-007: نشست

شواهد: jwtAuthorizationCheck.java:101 (بدون setMaxInactiveInterval)

اقدام: سیاست نشست، inactivity timeout سرور، شمارش نشست فعال، نمایش سوابق ورود.


مرحله ۳ — دسترسی و لاگ

NC-009: CORS

شواهد: jwtAuthorizationCheck.java:56,89-90,127,144,154,164,175,188 — Access-Control-Allow-Origin: * + Allow-Credentials: true؛ ~۵۰ کنترلر با @CrossOrigin(value="*")؛ WebSocketConfig.java:15

اقدام: allowlist origin، حذف wildcard با credential، محدود کردن header/method.

NC-010: مسیرهای عمومی

شواهد: jwtAuthorizationCheck.java:73-81 — مسیرهای public؛ DownloadControllers.java:31,63,83

اقدام: حذف public بودن غیرضروری، اعمال authorization/محدودیت فایل.

NC-012: یکپارچگی لاگ

شواهد: UserLogger.java + TblUserLog بدون hash؛ SystemLogs.tsx:429 DELETE

اقدام: audit DB یا زنجیره هش، محدودیت حذف لاگ.

NC-013: پوشش لاگ

شواهد: لاگ‌های کامنت‌شده در UsersController.java:204، AmisController.java:85، MusicOnHoldsController.java:55، RingGroupUsersController.java:45

اقدام: audit service مرکزی، تست پوشش login/read/create/update/delete/export.


مرحله ۴ — به‌روزرسانی و شواهد

NC-014: ظرفیت لاگ

شواهد: تنظیمات logging — threshold، هشدار، retention/rotation، fail-safe.

NC-015: امضای دیجیتال به‌روزرسانی

شواهد: AppControllers.java، UpdateService.ts

NC-016: منبع زمان معتبر

شواهد: endpoint /app/ntp-check/{server} در AppControllers.java:544

NC-017: validation گواهینامه

شواهد: Certificates.tsx — بررسی RFC 5280، chain، CA، OCSP/CRL، EKU.

NC-018: SSH

شواهد: جست‌وجوی کد — اگر SSH وجود ندارد انتخاب نشود؛ در غیر این صورت الزامات کامل SSH تکمیل شود.


3. یافته‌های جدید (پیشنهادی برای اضافه‌کردن)

NC-019 (پیشنهادی): پیش‌فرض admin با MD5

شواهد: Initializer.java:204 — MD5("admin") برای کاربر پیش‌فرض admin.

اقدام: پیش‌فرض admin را با bcrypt hash جایگزین کنید و پیامدری منتشر کنید.

NC-020 (پیشنهادی): انقضای JWT ۳۱ روزه

شواهد: application.properties:52 — jwt. expiration=2678400 (۳۱ روز)

اقدام: کاهش به ۲ ساعت یا استفاده از refresh token.


4. چک‌لیست پس از هر رفع

برای هر آیتم NC که رفع می‌شود:

گام عمل مسئول
۱ به‌روزرسانی عدم‌انطباق-الزامات-امنیتی-CTI.md — وضعیت → «رفع‌شده» + شواهد توسعه‌دهنده
۲ اجرای python3 docs/tools/fill_self_evaluation.py برای به‌روزرسانی docx و MD توسعه‌دهنده
۳ تأیید بصری در docs/questionnaire/Self-Evaluation-v1.0-CTI-Filled.pdf ارزیاب امنیت
۴ بروزرسانی SELF-EVALUATION-CTI-ANSWERS.md در docs/markdown/ توسعه‌دهنده
۵ Commit رفع در git توسعه‌دهنده

5. تصمیمات طراحی مهم

تصمیم توضیح وضعیت
مهاجرت MD5→bcrypt rehash در اولین login موفق ✅ تأیید شده
secretها به environment/secret manager منتقل می‌شوند ✅ تأیید شده
زبان اسناد عناوین انگلیسی، توپیح‌ح فارسی ✅ تأیید شده