سجل تحويلات OGI

تحويلات مجتمعية لـ OGI، أداة مفتوحة المصدر لتحليل الاستخبارات والروابط.

كيف يعمل

كل مجلد تحت transforms/ هو تحويل يمكن تثبيته بشكل مستقل. تقوم واجهة سطر الأوامر OGI وواجهة مستخدم Transform Hub بقراءة index.json (التي تُنشأ تلقائيًا عند كل دمج) لاكتشاف ما هو متاح.

تثبيت تحويل

استخدم واجهة سطر الأوامر من مشروع الخلفية OGI:

cd backend
uv sync
uv run ogi transform search shodan
uv run ogi transform install shodan-host-lookup

أو استخدم واجهة مستخدم Transform Hub داخل OGI.

تجاوزات الحدود القصوى لوقت التشغيل

ترث التحويلات المجتمعية في هذا السجل تجاوزات الحدود القصوى لتحويلات المضيف من OGI. يمكن للمشغلين تقييد أو إزالة الإعدادات القصوى الشائعة مثل max_results و max_urls و max_links و max_content_chars أو timeout_seconds مركزيًا باستخدام متغير البيئة للخلفية:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=50,max_urls=25,max_links=40

لإزالة حد في نشر محلي:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

تم تكوين هذا في تطبيق OGI الرئيسي، وليس في مستودع السجل هذا.

التحويلات المضمنة (تُصدر مع OGI)

الفئة	التحويلات
DNS	domain-to-ip, domain-to-mx, domain-to-ns, ip-to-domain, whois-lookup
الشهادات	domain-to-certs, cert-transparency
البريد الإلكتروني	domain-to-emails, email-to-domain
IP	ip-to-asn, ip-to-geolocation
اجتماعي	username-search
التجزئة	hash-lookup
الويب	domain-to-urls, url-to-headers, url-to-links, url-to-content, content-to-iocs
البنية التحتية	organization-to-team-members

المساهمة بتحويل

1. افرك (Fork) هذا المستودع
2. أضف التحويل الخاص بك تحت transforms/<category>/<slug>/
3. قم بتضمين plugin.yaml و README.md و transforms/*.py
4. أعلن عن الأسرار المطلوبة في api_keys_required، وليس في transform_settings
5. افتح طلب سحب (PR) - تتحقق CI تلقائيًا

عند إضافة إعدادات محدودة، يُفضل استخدام الأسماء الشائعة مثل max_results و max_urls و max_links و max_content_chars أو timeout_seconds ما لم يكن الإعداد خاصًا بالتحويل حقًا. وهذا يحافظ على توقع التجاوزات من جانب المشغل عبر النظام البيئي.

انظر CONTRIBUTING.md للدليل الكامل.

الترخيص

AGPLv3