دليل التكامل

ربط الوكلاء بأنظمة المؤسسات

يجب أن يحدد التكامل المؤسسي طريقة الاتصال والمصادقة والعمليات المسموح بها والتأثيرات الجانبية وإعادة المحاولة والمهلات. اعتمادًا على النظام المستهدف، قد يستخدم المحول REST أو GraphQL أو SOAP أو المراسلة أو واجهة قاعدة بيانات يتم التحكم فيها بعناية. لا يطالب ActiveMotion بكتالوج ثابت للموصلات المعدة مسبقًا؛ تقوم كل مشاركة بجرد أنظمة العميل والتأكد من إمكانية إعادة استخدام المحول أو ضرورة تنفيذه.

المصادقة وإدارة الاعتمادات

يجب أن يستخدم التعامل مع بيانات الاعتماد المدير السري المعتمد للعميل وطريقة المصادقة. قد يكون OAuth، أو مفاتيح API، أو هوية حمل العمل، أو TLS المتبادل مناسبًا اعتمادًا على النظام. قم بتوسيع نطاق كل هوية إلى الحد الأدنى من العمليات المطلوبة، وتدوير المستندات وإبطالها، وسلوك فشل الاختبار. لا يُفترض أن يكون هناك دوران لوقت التوقف عن العمل صفر؛ ويجب أن يتم دعمه والتحقق من صحته بواسطة المكونات المحددة.

بناء التكاملات المخصصة

يجب أن تصف مواصفات المحول المخصص العملية، والمدخلات والمخرجات المكتوبة، والترخيص، وأوضاع الخطأ، والكمون المتوقع، والعجز، والآثار الجانبية. قم باختباره مقابل وضع الحماية أو الاختبار المزدوج الخاضع للرقابة، وقم بإدراجه في تقييمات سير العمل، ثم قم بتحريره من خلال عملية التغيير الخاصة بالعميل. يمكن لمخططات OpenAPI أو GraphQL تسريع عملية السقالات، لكن التعليمات البرمجية وأوصاف الأدوات التي تم إنشاؤها لا تزال تتطلب مراجعة أمنية واختبارًا سلوكيًا.

مراقبة صحة التكامل

تتضمن إشارات صحة التكامل المفيدة نجاح الطلب، ووقت الاستجابة، وفئة الخطأ، وحالة حد المعدل، وانتهاء صلاحية بيانات الاعتماد. أرسل تلك الإشارات إلى أدوات المراقبة التي اختارها العميل وحدد التنبيهات من خطوط الأساس المقاسة. يعد قطع الدائرة، والتراجع، والتصعيد البشري من خيارات التصميم التي يجب اختبارها لكل وضع فشل؛ لا ينبغي للنظام أن يستبدل بصمت إجراءً بمخاطر أو دلالات مختلفة.