sdk/1.1.0 · حُدّث في ٠٩‏/٠٧‏/٢٠٢٦

عمليات التكامل وSDK

المسارات الأولى لربط المستشعرات وتلقي الإشارات واستخدام تقييم ADDA.

يوضح دليل التكاملات كيفية ربط المستشعرات واستعلامات الثقة وevidence ووحدات السمعة باستخدام مرجع مشترك.

لا ينتهي التكامل الجيد عندما يستجيب endpoint، بل يتطلب أيضًا التحقق من التنسيق والحوكمة وقابلية التتبع وكيف يؤثر المصدر الجديد في tasks وincidents وautomations والدليل الحي.

استخدم هذا الدليل لتحويل اتصال تقني إلى قدرة تشغيلية حقيقية داخل ADDA.

قائمة التحقق

• تسجيل المستشعر أو النطاق قبل تفعيل الاستيعاب في الإنتاج.
• اختبار تقييم الثقة وتسجيل evidence باستخدام حالات مضبوطة.
• توثيق أخطاء التكامل المتكررة.

بدء سريع

1. سجّل أولًا المصدر أو النطاق المراد دمجه.
2. اختبر تدفقًا أدنى من طرف إلى طرف قبل اعتبار التكامل جاهزًا.
3. إذا ترك التكامل سؤالًا متكررًا، فحوّله إلى manual candidate.

التدفق التشغيلي

الاتصال

تسجيل المستشعر أو المصدر أو الوحدة التي ستدفع الإشارات.

تحديد الهوية التقنية والتشغيلية للتكامل.

التحقق

فحص أن الأحداث أو scores أو evidence تصدر بتنسيق مفيد لـ ADDA.

التحقق من أن التقييم يدخل فعلًا إلى التدفق الصحيح.

التحويل إلى منتج

ربط التكامل بالوثائق أو الدليل أو tasks أو automations عند الحاجة.

تجنب عمليات التكامل المعزولة عن بقية المنتج.

flowchart LR
  S1["الاتصال"]
  S2["التحقق"]
  S3["التحويل إلى منتج"]
  S1 --> S2
  S2 --> S3

أدوات التحقق والفحوص

تنفذ قراءة سياقية لهذه الواجهة وتعيد خطوات مقترحة بتركيز تشغيلي.

التحقق من مسار التكامل

يلخص المقالات والخطوات التالية للتهيئة التقنية والتشغيلية.

أمثلة

الحدث الأدنى للاستيعاب

{
  "type": "sensor.alert",
  "source": "adda-agent-demo",
  "severity": "yellow",
  "summary": "Se detecta actividad anómala en endpoint observado."
}

الروابط والمراجع

المسارات ذات الصلة

عمليات التكامل العامة المستشعرات في مساحة العمل

APIs

/api/adda/v1/sensors
/api/adda/v1/sensors/register
/api/adda/v1/events/ingest

Docs ومسارات الدعم

docs/ADDA_API.md
docs/ADDA_MANUAL.md

المشكلات الشائعة

• غالبًا ما ينتج عن ربط مصدر من دون تحقق تشغيلي ضوضاء أكثر من التغطية.
• يؤدي عدم توثيق الأخطاء المتكررة إلى تكرار الفريق للتشخيص.

الإجراءات المقترحة

• حوّل التكامل إلى منتج باستخدام quickstarts وأمثلة ومسارات مرئية.
• صعّد أي فجوة متكررة في التهيئة إلى manual candidate.

Reason Codes مفيدة

قاموس Score

severity

الأولوية المؤسسية للإشارة على مقياس ADDA.

action

الخطوة التشغيلية التالية التي يوصي بها المحرك.

reasonCodes

أسباب قابلة للتفسير لتبرير التقييم.

ملاحظات البروتوكول

• التكامل الجاهز هو الذي يدخل في التدفقات التشغيلية، لا في API فقط.

سجل المقالة

٠٩‏/٠٧‏/٢٠٢٦

وُسعت المقالة بدليل بدء سريع للتكامل ومثال للاستيعاب.