Files
cti/docs/tools/fill_part1.py
2026-10-14 23:05:02 +03:30

109 lines
12 KiB
Python
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""Fill Self-Evaluation-v1.0.docx with CTI product answers + generate MD answers doc."""
import re, os, zipfile, shutil
SRC = '/home/it003/Desktop/project/cti/Self-Evaluation-v1.0.docx'
OUT_DIR = '/tmp/selfeval_out'
OUT = os.path.join(OUT_DIR, 'Self-Evaluation-v1.0-CTI-Filled.docx')
MD = os.path.join(OUT_DIR, 'SELF-EVALUATION-CTI-ANSWERS.md')
S_DONE = 'پیاده‌سازی شده'
S_PART = 'پیاده‌سازی جزئی — نیازمند تکمیل'
S_NO = 'پیاده‌سازی نشده — بدون ادعا'
S_NA = 'خارج از دامنه محصول'
# keys = tokens matched (substring, case-sensitive) against the شناسه الزام cell text
A = []
def a(keys, status, access, desc, img):
A.append({'keys': keys, 'status': status, 'access': access, 'desc': desc, 'img': img})
# ---------------- 1..85 ----------------
a(['تعداد هسته'], S_DONE,
'نصب محصول روی GNU/Linux (Debian GNU/Linux 12 bookworm) — نصب از طریق پکیج نصب ارائه‌شده توسط سازنده.',
'مشخصات کمینه پیشنهادی: CPU: 4 هسته؛ RAM: 8GB؛ دیسک: 100GB. اجزای وابسته: PostgreSQL نسخه 14 یا بالاتر، Asterisk 18 یا بالاتر، JDK 25. مقادیر نهایی پس از آزمون بار اعلام و تصویر محیط نصب پیوست می‌شود.',
'تصویر محیط نصب (خروجی lscpu، free -h، df -h) پیوست شود.')
a(['FAU_GEN.1.1'], S_PART,
'ثبت لاگ: کلاس UserLogger در بک‌اند (جدول tbl_user_logs). مشاهده: منوی مانیتورینگ ← گزارش لاگ سیستم (/system-logs/index، endpoint ‏/users/user-logs). لاگ فنی: فایل log/pline.log.',
'رویدادهای ثبت‌شده فعلی: ورود موفق/ناموفق، حساب غیرفعال، تغییر گذرواژه، عملیات ایجاد/ویرایش/حذف موجودیت‌ها (کاربران، SIP، صف، IVR، مسیرها و ...) و اعمال تنظیمات سیستم. رویدادهای خواندن لاگ‌ها، تغییر پیکربندی لاگ، خروج داده و خاتمه نشست هنوز به‌طور کامل ثبت نمی‌شوند و در دستور کار اصلاح (NC-013 سند عدم‌انطباق) قرار دارند.',
'تصویر صفحه گزارش لاگ سیستم و نمونه رکورد tbl_user_logs پیوست شود.')
a(['FAU_GEN.1.2'], S_PART,
'رکوردهای لاگ از طریق صفحه گزارش لاگ سیستم (/system-logs/index) قابل مشاهده‌اند.',
'هر رکورد در وضعیت فعلی شامل: کاربر ثبت‌کننده، شرح رویداد و تاریخ/زمان (createdAt) است. ثبت آدرس IP مبدأ و فیلد نتیجه (موفق/ناموفق) به‌صورت استاندارد در حال تکمیل است (NC-012).',
'تصویر یک رکورد لاگ با جزئیات پیوست شود.')
a(['FAU_SAR.1.1'], S_DONE,
'منوی مانیتورینگ ← گزارش لاگ سیستم (/system-logs/index) با مجوز منوی 5_6؛ endpoint بک‌اند: ‏/users/user-logs با کنترل مجوز.',
'فقط کاربران دارای مجوز منو به بازبینی لاگ‌ها دسترسی دارند؛ درخواست بدون مجوز با کد 401/404 رد می‌شود. قابلیت حذف رکورد لاگ با مجوز ویژه و ثبت لاگ همراه است.',
'تصویر صفحه گزارش لاگ و پیام رد دسترسی برای کاربر فاقد مجوز پیوست شود.')
a(['FAU_SAR.1.2'], S_DONE,
'نمایش لاگ‌ها در صفحه گزارش لاگ سیستم.',
'لاگ‌ها به‌صورت متن ساده و قابل فهم (شرح رویداد، نام کاربر، تاریخ/زمان) ثبت و نمایش داده می‌شوند؛ بدون داده رمزنگاری‌شده یا بخش نامرتبط.',
'تصویر نمونه لاگ‌ها پیوست شود.')
a(['FAU_SAR.3.1'], S_DONE,
'پنل فیلتر بالای صفحه /system-logs/index (فیلتر نام کاربری، بازه تاریخ، اندازه صفحه).',
'جستجو و فیلتر لاگ‌ها بر اساس پارامترها در کوئری سمت سرور (endpoint ‏/users/user-logs با پارامترهای username، بازه تاریخ و sort) پیاده‌سازی شده است.',
'تصویر پنل فیلتر و نتیجه جستجو پیوست شود.')
a(['FAU_STG.1.1'], S_PART,
'نگهداری لاگ در پایگاه‌داده (tbl_user_logs) و فایل لاگ (Logback). دسترسی مشاهده با مجوز منو محدود می‌شود.',
'دسترسی مشاهده لاگ محدود به کاربران دارای مجوز است. قابلیت حذف رکورد با مجوز ویژه وجود دارد؛ محدودسازی حذف غیرمجاز و افزودن سازوکار یکپارچگی (hash/append-only) در دستور کار (NC-012) است.',
'تصویر مجوزهای مرتبط با لاگ و پیکربندی دسترسی فایل لاگ پیوست شود.')
a(['FAU_STG.3.1'], S_DONE,
'پیکربندی: فایل application.properties (کلیدهای logging.logback.rollingpolicy.*).',
'آستانه نگهداشت: حداکثر 100 مگابایت برای هر فایل لاگ و نگهداری 30 نسخه (پیکربندی چرخش خودکار Logback).',
'تصویر فایل پیکربندی و فهرست فایل‌های چرخش‌شده در مسیر log پیوست شود.')
a(['FAU_STG.4.1'], S_PART,
'رفتار چرخش خودکار Logback در مسیر log/pline.log.',
'در رسیدن به آستانه، چرخش خودکار انجام و نسخه‌های قدیمی تا سقف 30 نگهداری می‌شوند. رفتار در صورت شکست ذخیره‌سازی (مانند پرشدن دیسک پایگاه‌داده) در حال تعیین سیاست است (NC-014).',
'تصویر فایل‌های چرخش‌شده پیوست شود.')
a(['FAU_COP.1.1(1)'], S_NO,
'-',
'در نسخه فعلی محصول سرویس رمزنگاری/رمزگشایی داده با AES ارائه نمی‌شود؛ بنابراین گزینه‌ای انتخاب نشده است.',
'بدون ادعا — تصویری لازم نیست.')
a(['FAU_COP.1.1(2)'], S_PART,
'امضای توکن نشست: تولید و اعتبارسنجی JWT در UsersController و jwtAuthorizationCheck.',
'درهم‌سازی SHA-512 در قالب امضای JWT (HMAC-SHA512 / HS512) استفاده می‌شود. درهم‌سازی گذرواژه در وضعیت فعلی MD5 است که منسوخ محسوب می‌شود و مهاجرت به bcrypt در دستور کار اصلاح (NC-003) قرار دارد. همچنین کاربر پیش‌فرض admin با MD5("admin") در startup ساخته می‌شود که در دستور کار (NC-019) است.',
'تصویر کد تولید/اعتبارسنجی JWT پس از اصلاح NC-003 پیوست شود.')
a(['FCS_CKM.4.1'], S_NA,
'-',
'کلید امضای توکن از پیکربندی خارجی (environment) خوانده می‌شود؛ سازوکار تخریب کلید در محصول تعبیه نشده است (الزام اختیاری).',
'بدون ادعا — تصویری لازم نیست.')
a(['FCS_CKM.1.1'], S_NO,
'-',
'امضای دیجیتال بسته‌های به‌روزرسانی هنوز پیاده‌سازی نشده است (NC-015)؛ گزینه‌ای انتخاب نشده.',
'بدون ادعا — تصویری لازم نیست.')
a(['FIA_AFL.1.1'], S_NO,
'صفحه ورود: /login؛ endpoint ‏/users/login.',
'آستانه تلاش ناموفق و قفل حساب در وضعیت فعلی پیاده‌سازی نشده است؛ هر تلاش ناموفق ثبت‌نشان می‌شود و پیام پاسخ برای کاربر تعریف‌شده و تعریف‌نشده یکسان است (جلوگیری از Account Harvesting). پیاده‌سازی آستانه قابل تنظیم توسط مدیر همراه با قفل موقت در دستور کار (NC-005) برنامه‌ریزی شده است.',
'پس از پیاده‌سازی NC-005، تصویر پیکربندی آستانه پیوست شود.')
a(['FIA_AFL.1.2'], S_NO,
'-',
'وابسته به الزام قبل؛ پس از افزودن آستانه تلاش ناموفق، قفل موقت/غیرفعال‌سازی حساب و ثبت‌نشان آن اضافه می‌شود (NC-005).',
'پس از پیاده‌سازی، تصویر رفتار قفل حساب پیوست شود.')
a(['FIA_ATD.1.1'], S_DONE,
'صفحه کاربران (/users/index) — جداول tbl_pline_users و tbl_user_access.',
'ویژگی‌های امنیتی هر کاربر: شناسه یکتا، نام کاربری، نام کامل، نقش‌ها (ADMIN/CLIENT)، وضعیت فعال/غیرفعال و مجموعه مجوزهای منو/عملیات.',
'تصویر فرم ایجاد/ویرایش کاربر و بخش دسترسی‌ها پیوست شود.')
a(['FIA_PMG_EXT.1.1'], S_NO,
'فرم‌های ایجاد کاربر و تغییر گذرواژه (/change-password/index).',
'سیاست پیچیدگی گذرواژه در وضعیت فعلی فقط در رابط کاربری (حداقل 6 کاراکتر) بررسی می‌شود و در سمت سرور enforce نمی‌گردد. پیاده‌سازی سیاست مرکزی قابل تنظیم توسط مدیر (حداقل طول، حروف بزرگ/کوچک، عدد، کاراکتر خاص) در دستور کار (NC-004) است.',
'پس از پیاده‌سازی NC-004، تصویر پیکربندی سیاست گذرواژه پیوست شود.')
a(['FIA_UID.1.1'], S_DONE,
'صفحه ورود (/login) — endpoint ‏/users/login؛ احراز هویت درخواست‌ها: فیلتر jwtAuthorizationCheck.',
'شناسایی و احراز هویت پیش از هر عملیات مجاز انجام می‌شود؛ همه مسیرها به‌جز مسیرهای عمومی (ورود، دریافت نسخه) نیازمند توکن معتبر (هدر Authorization: Bearer) هستند.',
'تصویر صفحه ورود و پاسخ 401 برای درخواست بدون توکن پیوست شود.')
a(['FIA_UAU.5.1'], S_DONE,
'صفحه ورود (/login).',
'سازوکار احراز هویت: نام کاربری/گذرواژه (انتخاب شده). پس از ورود موفق، توکن JWT (HS512) با تاریخ انقضا ۳۱ روزه تولید و در سرور ذخیره می‌شود و در درخواست‌های بعدی به‌صورت Bearer ارسال می‌گردد. انقضای طولانی‌تر از استاندارد (۳۱ روز) در دستور کار (NC-020) برای کاهش به ۲ ساعت و پیاده‌سازی refresh token است. محصول به سامانه احراز هویت مرکزی، OTP یا ایمیل/پیامک متصل نیست.',
'تصویر ورود موفق و کد تولید توکن پیوست شود.')
a(['FIA_USB.1.1'], S_PART,
'صفحه کاربران و صفحه دسترسی‌ها؛ گزارش لاگ برای پیشینه احراز هویت.',
'ویژگی‌های امنیتی نگهداری‌شده برای هر کاربر فعال: شناسه، نقش‌ها و مجموعه دسترسی منو/عملیات. پیشینه احراز هویت از طریق گزارش لاگ قابل مشاهده است. نمایش جزئیات کامل واسط کلاینت در حال بررسی است.',
'تصویر مشخصات کاربر و پیشینه ورود او پیوست شود.')
a(['FIA_USB.1.2'], S_DONE,
'فرآیند ورود (‎/users/login).',
'با هر ورود موفق، توکن جدید تولید و جایگزین توکن قبلی در پایگاه‌داده می‌شود؛ در نتیجه نشست قبلی اعتبار خود را از دست می‌دهد و ثبت‌نشان ورود موفق (پیشینه احراز هویت) به‌روزرسانی می‌شود.',
'تصویر رفتار ورود مجدد و ابطال نشست قبلی (کد) پیوست شود.')
a(['FIA_USB.1.3'], S_PART,
'صفحه کاربران (ویرایش توسط مدیر).',
'تغییرات ویژگی‌های امنیتی کاربر توسط مدیر انجام و ثبت‌نشان می‌شود. قاعده صریح «غیرمجاز بودن تغییر در طول نشست فعال کاربر» هنوز اعمال نمی‌شود و در حال بررسی است.',
'تصویر ثبت‌نشان تغییر ویژگی‌های امنیتی پیوست شود.')