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

240 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 منتقل می‌شوند | ✅ تأیید شده |
| زبان اسناد | عناوین انگلیسی، توپیح‌ح فارسی | ✅ تأیید شده |