يدير قسم التكاملات في لوحة إدارة المنصة تكاملات القراءة على مستوى النشر: نظام للجهة أو الشركة القابضة يقرأ كل مساحات العمل النشطة دفعة واحدة عبر الواجهة البرمجية، ويستقبل أحداثها على خطافات الويب. ما يستطيع هذا التكامل قراءته وشكل بياناته موضّح في القراءة على مستوى الجهة. وتشرح هذه الصفحة إدارته من اللوحة.
أما تكاملات مساحة العمل نفسها (مزامنة نظام تخطيط الموارد، والصلاحيات المحددة، والمهام المجمّعة) فأمر مختلف: يديرها مدير مساحة العمل من الإعدادات ← التكاملات.
من يستطيع استخدامه
لا يظهر التكاملات في الشريط الجانبي للوحة إلا لمشرفي المنصة الذين يملك دورهم في اللوحة التنفيذ في التكاملات (integrations.act)، ويملكه دور المالك المقفل. لا يرى المشاهد والأدوار الأخرى هذا القسم، ومن يفتح /admin/integrations منهم يُعاد إلى أول صفحة مسموحة له في اللوحة. وتعيد مسارات اللوحة خلفه 403 دون هذه الصلاحية، حتى للقراءة.
إنشاء تكامل
- التكاملات ← تكامل جديد.
- أدخل الاسم (مثل «منصة التقارير - الشركة القابضة») ووصفًا اختياريًا.
- أدخل قائمة عناوين IP المسموحة: عنوان IP أو نطاق CIDR في كل سطر (مثل
203.0.113.10أو10.20.0.0/16). وهي مطلوبة. ويُرفض النطاق الذي يشمل كل العناوين (/0)، وتظهر العناوين غير الصالحة تحت الحقل. - إنشاء. يُفتح التكامل على تبويب الإعدادات.
تعرض القائمة لكل تكامل حالته، وعدد مفاتيحه النشطة ونقاط استقباله، وعدد عناوين IP المسموحة. ويُنبَّه على التكامل الذي لا قائمة له: مفاتيحه مرفوضة.
الإعدادات
- التفاصيل: الاسم والوصف.
- قائمة عناوين IP المسموحة: مطلوبة. يمكنك تعديلها، لكن لا يمكن حفظها فارغة. ولا تعمل المفاتيح إلا من العناوين المدرجة.
- الحالة: إيقاف التكامل يرفض كل مفاتيحه مؤقتًا ويؤجل رسائل خطافات الويب، واستئناف التكامل يعيد تشغيله. لا يُحذف شيء.
- حذف التكامل: يحذفه مع مفاتيحه ونقاط استقبال خطافات الويب وسجل التسليم، بعد تأكيد داخل الصفحة. يتوقف النظام المرتبط عن العمل فورًا.
لا يوجد اختيار للصلاحيات: تكامل القراءة على مستوى النشر يقرأ كل شيء دائمًا، للقراءة فقط.
مفاتيح API
- مفاتيح API ← مفتاح جديد.
- سمِّ المفتاح بمكان استخدامه، واختر تاريخ الانتهاء. وهو مطلوب: يتوقف المفتاح في نهاية ذلك اليوم.
- إصدار المفتاح. يظهر المفتاح كاملًا (
jdr_live_…) مرة واحدة في مربع نسخ. انسخه إلى مدير الأسرار لديك. ولا تُغلق النافذة إلا بزر حفظته، إغلاق؛ فجاديرون لا يحتفظ إلا بجزء منه للتعرّف عليه.
إن لم تكن للتكامل قائمة عناوين IP بعد، ينبّه التبويب إلى ذلك ولا يمكن إصدار المفتاح (ip_allowlist_required)؛ ويأخذك زر فتح تبويب الإعدادات إلى القائمة. وتعرض قائمة المفاتيح لكل مفتاح بادئته، وتاريخ إنشائه، وآخر استخدام، وتاريخ انتهائه، وحالته (نشط، منتهٍ، ملغى). ولتدوير مفتاح: أصدر مفتاحًا جديدًا، وانقل النظام إليه، ثم ألغِ القديم.
خطافات الويب
يطلب إضافة نقطة استقبال رابط https عامًا والأحداث المطلوب إرسالها:
- كل أحداث الموارد (
*)، ويشمل الأحداث التي تُضاف لاحقًا، أو أحداث محددة تختارها لكل مورد (الوحدات التنظيمية، والوظائف، والموظفون، والمرشحون، والشواغر وغيرها). - سجل التدقيق (
audit.recorded)، مدرج على حدة وغير مختار افتراضيًا. يرسل كل قيد في سجل التدقيق لكل مساحات العمل النشطة، ومعه قيود المنصة (إجراءات لوحة الإدارة)، حدثًا مستقلًا. يستطيع تكامل القراءة على مستوى النشر اختياره دائمًا، ولا يدخل أبدًا ضمن «كل أحداث الموارد».
لا تُقبل إلا * وaudit.recorded وأنواع الأحداث الواردة في كتالوج الأحداث؛ ويُرفض أي نوع آخر (unknown_event_type). وعند تعديل نقطة استقبال وإلغاء اختيار أنواع أحداث، تُسقط تسليماتها المعلّقة من تلك الأنواع (تُوسم بالفشل، scope changed).
تظهر مشكلات الرابط (ليس https، أو خادم داخلي أو محلي، أو خادم خارج الخوادم المسموح بها على النشر) تحت الحقل. وبعد إضافة، يظهر سر التوقيع (whsec_…) مع مربع نسخ.
ولكل بطاقة نقطة استقبال:
- إرسال حدث تجريبي: يرسل
pingإلى هذه النقطة وحدها ويعرض النتيجة. ويتطلب أن تكون النقطة والتكامل نشطين. - تعديل، وإيقاف / استئناف، وحذف (بعد التأكيد).
- إعادة التفعيل: تُعطَّل النقطة تلقائيًا بعد فشل التسليم 3 أيام متواصلة، ويتلقى كل مالك في لوحة الإدارة رسالة بريد تذكر التكامل ونطاق نقطة الاستقبال مع رابط إلى هذه الصفحة؛ أصلح نظام الاستقبال ثم أعد تفعيلها.
- السر وسجل التسليم: إظهار سر التوقيع، أو تدوير السر. وبعد التدوير يبقى السر السابق يوقّع 24 ساعة: تحمل كل رسالة خلالها توقيعين، فيستطيع نظام الاستقبال الانتقال دون فقدان أي رسالة.
تستقبل نقاط الاستقبال أحداث كل مساحات العمل النشطة، ويحمل كل حدث workspaceId (انظر القراءة على مستوى الجهة).
سجل التسليم
يعرض السجل رسائل النقطة، الأحدث أولًا، ويُحتفظ بها 30 يومًا. صفِّه حسب الحالة (الكل، نجحت، بانتظار المحاولة، فشلت، توقفت المحاولات). ويعرض كل صف:
- نوع الحدث ومعرّفه؛
- مساحة العمل التي جاء منها (الاسم والمعرّف)، أو المنصة للحدث التجريبي ولقيود تدقيق المنصة؛
- الحالة، وعدد المحاولات، ورمز استجابة المستقبل ومدتها، والوقت، والمحاولة التالية.
افتح الصف لقراءة استجابة المستقبل (أول 500 حرف). ويرسل إعادة الإرسال الحدث نفسه مرة أخرى رسالةً جديدة تُحاوَل فورًا.
ما يُسجَّل
يُسجَّل كل تغيير في سجل النشاط في اللوحة: إنشاء التكامل أو تعديله أو حذفه؛ وإصدار مفتاح أو إلغاؤه؛ وإنشاء نقطة استقبال أو تعديلها أو حذفها أو اختبارها أو تدوير سرها؛ وإعادة إرسال رسالة. ولا تُكتب المفاتيح أو الأسرار في السجل أبدًا. ولا تُسجَّل عمليات القراءة التي تُجرى بالمفتاح.