# 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`: ```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 منتقل می‌شوند | ✅ تأیید شده | | زبان اسناد | عناوین انگلیسی، توپیح‌ح فارسی | ✅ تأیید شده |