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