خلّي Python يكتب التقرير

01 / ملخص الدرس

نحوّل الـ Findings من بيانات لتقرير Markdown كامل بجدول وتفاصيل، ونعرف أدوات زي Pandoc و SysReptor اللي بتطلّع منه PDF.

ضمن مسارالتوثيق وكتابة تقارير اختبار الاختراق18 / 21

02 / شرح الدرس مكتوبًا

نص شرح المعلم والكود الذي كتبه ونتيجة تشغيله، بنفس ترتيب الدرس.

أهلاً بيك. نسخ ولزق عشرين Finding في Word، وتنسيق كل جدول بإيدك… ده ساعات. وكل مرة بتنسخ، فيه احتمال تغلط.

الحل: خزّن الـ Findings كبيانات، list من dictionaries، أو ملف JSON. خلّي الـ code يطلّع منها Markdown. وبعدين أداة زي Pandoc تحوّل الـ Markdown لـ PDF أو Word بالشكل اللي إنت عايزه. نكتب generator بسيط: بيعمل جدول Findings Summary، وبعدين جزء لكل Finding، ويحفَظ الكل في ملف report dot md. نشغّل… ده تقرير Markdown كامل، طلع في ثانْيَة.

main.py

findings = [
    {"id": "F-01", "title": "SQL Injection in login form", "severity": "Critical", "cvss": 9.8,
     "fix": "Use prepared statements."},
    {"id": "F-02", "title": "Default admin password", "severity": "Critical", "cvss": 9.1,
     "fix": "Set a long random password and enable MFA."},
    {"id": "F-03", "title": "Missing security headers", "severity": "Medium", "cvss": 5.3,
     "fix": "Add CSP and X-Frame-Options headers."},
]

lines = ["# Penetration Test Report", "", "## Findings Summary", "",
         "| ID | Title | Severity | CVSS |", "|----|-------|----------|------|"]
for f in findings:
    lines.append(f"| {f['id']} | {f['title']} | {f['severity']} | {f['cvss']} |")

lines += ["", "## Technical Findings"]
for f in findings:
    lines += ["", f"### {f['id']}: {f['title']}", f"**Severity:** {f['severity']} ({f['cvss']})",
              f"**Remediation:** {f['fix']}"]

report = "\n".join(lines)
open("report.md", "w").write(report)
print(report)

المخرجات

# Penetration Test Report

## Findings Summary

| ID | Title | Severity | CVSS |
|----|-------|----------|------|
| F-01 | SQL Injection in login form | Critical | 9.8 |
| F-02 | Default admin password | Critical | 9.1 |
| F-03 | Missing security headers | Medium | 5.3 |

## Technical Findings

### F-01: SQL Injection in login form
**Severity:** Critical (9.8)
**Remediation:** Use prepared statements.

### F-02: Default admin password
**Severity:** Critical (9.1)
**Remediation:** Set a long random password and enable MFA.

### F-03: Missing security headers
**Severity:** Medium (5.3)
**Remediation:** Add CSP and X-Frame-Options headers.

ولو مش عايز تكتب الـ generator بنفسك، فيه أدوات جاهزة: SysReptor، و Ghostwriter، و Dradis. بتخزّن الـ Findings، وعندها مكتبة Findings جاهزة تعيد استخدامها، وتطلّع PDF احترافي. بس خد بالك: الأتمتة بتوفّر وقت التنسيق، مش التفكير. كل Finding لازم تقراه وتعدّله على حسب العميل ده بالزبط. دورك: ضيف سطر تحت العنوان، فيه عدد الـ Findings كلها، وكام واحد منهم Critical.

تمرين

احسب crit بـ sum وضيف سطر Total findings تحت العنوان.

الحل: نشغّل…

main.py

findings = [
    {"id": "F-01", "title": "SQL Injection in login form", "severity": "Critical", "cvss": 9.8,
     "fix": "Use prepared statements."},
    {"id": "F-02", "title": "Default admin password", "severity": "Critical", "cvss": 9.1,
     "fix": "Set a long random password and enable MFA."},
    {"id": "F-03", "title": "Missing security headers", "severity": "Medium", "cvss": 5.3,
     "fix": "Add CSP and X-Frame-Options headers."},
]

crit = sum(f["severity"] == "Critical" for f in findings)
lines = ["# Penetration Test Report", "", f"Total findings: {len(findings)} ({crit} critical)", "", "## Findings Summary", "",
         "| ID | Title | Severity | CVSS |", "|----|-------|----------|------|"]
for f in findings:
    lines.append(f"| {f['id']} | {f['title']} | {f['severity']} | {f['cvss']} |")

lines += ["", "## Technical Findings"]
for f in findings:
    lines += ["", f"### {f['id']}: {f['title']}", f"**Severity:** {f['severity']} ({f['cvss']})",
              f"**Remediation:** {f['fix']}"]

report = "\n".join(lines)
open("report.md", "w").write(report)
print(report)

المخرجات

# Penetration Test Report

Total findings: 3 (2 critical)

## Findings Summary

| ID | Title | Severity | CVSS |
|----|-------|----------|------|
| F-01 | SQL Injection in login form | Critical | 9.8 |
| F-02 | Default admin password | Critical | 9.1 |
| F-03 | Missing security headers | Medium | 5.3 |

## Technical Findings

### F-01: SQL Injection in login form
**Severity:** Critical (9.8)
**Remediation:** Use prepared statements.

### F-02: Default admin password
**Severity:** Critical (9.1)
**Remediation:** Set a long random password and enable MFA.

### F-03: Missing security headers
**Severity:** Medium (5.3)
**Remediation:** Add CSP and X-Frame-Options headers.

الدرس الجاي: التقرير خلص… بس قبل ما تبعته، لازم يتراجع. وبعد الإصلاح، فيه Retest. يلا بينا.

03 / دروس المسار (21)