ThreatPad

منصة تدوين تعاونية فورية مبنية لفرق استخبارات التهديدات السيبرانية (CTI) وعمليات الأمن.

يجمع ThreatPad بين سرعة أدوات الإنتاجية الحديثة والقدرات الخاصة بـ CTI: الاستخراج التلقائي للمؤشرات (IOC)، التصدير بصيغة STIX 2.1، قوالب التهديدات المنظمة، والتحكم الدقيق في الوصول.

عرض توضيحي مباشر — تسجيل الدخول باستخدام [email protected] / password123

الميزات

• محرر غني — WYSIWYG مع تمييز الصياغة، الجداول، قوائم المهام، تبديل التحرير/المعاينة
• الرسم والرسوم البيانية — لوحة Excalidraw كاملة الصفحة لمخططات تدفق الهجمات، مخططات الشبكة، وسير العمل. كما يمكن تضمينها ككتل رسم داخلية داخل الملاحظات النصية.
• الاستخراج التلقائي للمؤشرات — كشف عناوين IP، النطاقات، عناوين URL، التجزئات (hashes)، البريد الإلكتروني، ثغرات CVE من محتوى الملاحظة
• التصدير القائم على الإضافات — JSON، CSV، STIX 2.1 مضمنة. أضف بنفسك بملف واحد
• قوالب CTI — تفريغ المؤشرات، ملف تعريف الجهات التهديدية، ملاحظات الحوادث، متتبع الحملات
• مساحات العمل والمجلدات — مجلدات متداخلة، مساحات عمل متعددة، تصفية قائمة على الوسوم
• التحكم في الوصول — RBAC لمساحة العمل (مالك/محرر/مشاهد)، مشاركة لكل ملاحظة، ملاحظات خاصة
• سجل الإصدارات — لقطات تلقائية كل 5 دقائق، عرض الفروق، استعادة بنقرة واحدة
• البحث النصي الكامل — بحث فرعي وجذري مدعوم بـ Postgres
• تسجيل التدقيق — تتبع جميع إجراءات المستخدم عبر مساحات العمل
• الاستضافة الذاتية — تبقى بياناتك على شبكتك

التثبيت السريع

يتطلب Docker. هذا كل شيء.

git clone https://github.com/bhavikmalhotra/ThreatPad.git
cd ThreatPad
docker compose -f docker-compose.prod.yml up -d --build

افتح http://localhost:3000 — سيتم توجيهك لإنشاء حساب المسؤول الخاص بك.

يؤدي هذا إلى تشغيل PostgreSQL وRedis وخادم API وتطبيق الويب. يتم تطبيق مخطط قاعدة البيانات تلقائيًا.

إعداد التطوير

يتطلب Node.js 22+ و pnpm 9+.

pnpm install
cp .env.example .env
docker compose up -d          # Postgres + Redis
pnpm --filter @threatpad/db push
pnpm --filter @threatpad/db seed   # بيانات تجريبية اختيارية
pnpm dev

• واجهة المستخدم: http://localhost:3000
• API: http://localhost:3002
• تسجيل الدخول التجريبي: [email protected] / password123 (إذا تمت البذر)

كتابة الإضافات

يستخدم ThreatPad نظام إضافات قائم على السجل (registry). التصدير هو أول نوع إضافة — المزيد مخطط له.

أنشئ ملفًا في apps/server/src/plugins/exporters/:

import type { ExportPlugin } from '@threatpad/shared/types';

export const myExporter: ExportPlugin = {
  key: 'myformat',
  label: 'My Format',
  fileExtension: '.xml',
  contentType: 'application/xml',
  async export({ noteId, iocs, note }) {
    const xml = buildXml(iocs);
    return { data: xml, contentType: 'application/xml', filename: `iocs-${noteId}.xml` };
  },
};

سجله في apps/server/src/plugins/exporters/index.ts:

import { myExporter } from './my-exporter.js';
exportRegistry.register(myExporter);

تكتشف الواجهة الأمامية التنسيقات الجديدة تلقائيًا — لا حاجة لتغييرات في واجهة المستخدم.

التوثيق

• التكوين ومتغيرات البيئة
• مرجع API
• الهندسة المعمارية

الترخيص

MIT