12 KiB
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 | مرحله ۳ |
۱.۲ قوانین عمومی
- هر مرحله فقط با تأیید کاربر آغاز میشود.
- ابتدا سند عدمانطباق بهروزرسانی شود، سپس رفع شروع شود.
- پس از هر رفع: اسکریپت
fill_self_evaluation.pyمجدداً اجرا شود تا پاسخنامه docx و MD بهروزرسانی شوند. - وضعیت NC در جدول عدمانطباق به «رفعشده» تغییر یابد.
- آیتمهای رمزنگاری/هش (NC-003) بدون بازیابی MD5، با rehash در اولین login موفق به bcrypt مهاجرت میشوند.
2. جزئیات هر مرحله
مرحله ۱ — بحرانی
NC-011: مدیریت امن secretها
شواهد:
p-line/src/main/resources/application.properties:14—spring.datasource.password=Mehdi@123p-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
اقدام اصلاحی:
- خروجی
git log --all --full-history -- application.propertiesرا بررسی کنید؛ تمام ارجاع به مقدار قبلی را پاک کنید. - مقادیر حساس را به متغیرهای محیطی (
SPRING_DATASOURCE_PASSWORD,PLINE_JWT_SECRET) منتقل کنید. - در
Docker/Compose: ازsecretsیا--env-fileاستفاده کنید. - انقضای JWT را از ۳۱ روز (
jwt. expiration=2678400) به ۲ ساعت کاهش دهید. - 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— پیادهسازی MD5p-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
طراحی مهاجرت تدریجی:
- در
GlobalTools.java: یک متدverifyPassword(String raw, String stored)اضافه کنید که:- اگر
storedشروع به$2a$یا$2b$میشود → با bcrypt مقایسه کنید. - اگر
storedیک هش MD5 است → با MD5 مقایسه کنید؛ اگر موفق بود، رمز عبور را rehash با bcrypt و در DB ذخیره کنید.
- اگر
- در
UsersController.login()(login موفق): پس از احراز هویت، رمز عبور را rehash کنید. - در
Initializer.java:204: پیشفرض admin را با bcrypt hash جایگزین کنید. - در تمام مسیرهای 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:8008application.properties:69-70— خطوط مرتبط
اقدام اصلاحی:
- URL لایسنس را به HTTPS تغییر دهید یا از متغیر محیطی استفاده کنید.
- اگر سرویس لایسنس فقط 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/keystorecti-app/src/components/services/PlineTools.tsx:26—http://localhost:8080
اقدام اصلاحی:
- گواهینامه X.509 معتبر دریافت کنید (Let's Encrypt یا داخلی).
- در
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 - Redirect HTTP (8080) → HTTPS (8443) در فیلتر یا reverse proxy.
- در
PlineTools.tsx: پروتکل را بهhttps://و پورت 8443 تغییر دهید. - هدرهای امنیتی را اضافه کنید:
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 منتقل میشوند | ✅ تأیید شده |
| زبان اسناد | عناوین انگلیسی، توپیحح فارسی | ✅ تأیید شده |