مزوّدو التكاملات ومراقبتها

هذه الصفحة لمشغّلي منصة HyoNova أنفسهم. تغطي جانب المنصة من مركز التكاملات: التطبيقات التي يسجّلها HyoNova مرة واحدة لدى Google وMicrosoft وGitHub لتستطيع الشركات الربط، وشاشة مركز التحكم التي تعرض صحة التكاملات لكل الشركات.

ما الذي يحتاج إلى تطبيق للمنصة#

قواعد لكل المزوّدين#

• تُدخل التطبيقات في مركز التحكم › المزوّدون. ويحتاج الإعداد إلى صلاحية إدارة المزوّدين (providers.manage)، وإلى تحقق إضافي حديث من الهوية، وإلى سبب، ويُسجَّل في سجل التدقيق.
• الأسرار — أسرار العميل والمفاتيح الخاصة وأسرار الـWebhook — تذهب مباشرة إلى مخزن أسرار المنصة. ولا تُعرض مرة أخرى ولا تُكتب في السجلات ولا في سجل التدقيق؛ ويعرض مركز التحكم فقط هل كل منها مُعدّ.
• عناوين إعادة التوجيه والعودة والـWebhook التي تُدخل عند المزوّد تظهر في قسم التشغيل لكل مزوّد في مركز التحكم، بحسب البيئة التي تعمل فيها. انسخها من هناك.
• بعد كل حفظ شغّل اختبار الاتصال. والمزوّد الذي حُفظ ولم يُختبر لا يُعدّ متحققاً منه.
• هذه التطبيقات منفصلة عن تطبيقات تسجيل الدخول عبر Google وربط صناديق البريد. كل تطبيق يطلب صلاحياته فقط، ولا يوسّع أيٌّ منها الآخر.

Google Drive#

يطلب تطبيق Drive الوصول إلى الملفات التي يختارها الشخص، ولا شيء غير ذلك. فلا يستطيع الوصول إلى البريد ولا إلى بقية Drive.

تصنّف Google النطاق drive.file نطاقاً غير حساس، فيحتاج التطبيق إلى التحقق الأساسي فقط، لا إلى مراجعة النطاقات المقيّدة.

Microsoft OneDrive#

أمران ينبغي معرفتهما:

• تشمل Files.Read قراءة ملفات الشخص المسجّل عموماً. فليست لدى Microsoft موافقة لكل ملف في هذا النوع من الاتصال. ولا يسأل HyoNova خدمة Microsoft إلا عمّا يتصفحه الشخص ولا يحفظ إلا ما يربطه، ويقول المنتج ذلك قبل أن يربط أحد.
• حين تنتهي صلاحية سر العميل تتوقف كل اتصالات OneDrive عن التجديد إلى أن يُحفظ سر جديد. ضع تاريخ الانتهاء في تقويمك.

تطبيق GitHub#

الخيار Request user authorization (OAuth) during installation إلزامي لا اختياري. فهو ما يتيح لـ HyoNova أن يتأكد من GitHub أن من يثبّت التطبيق يملك التثبيت فعلاً؛ ودونه يُرفض كل تثبيت. ومع تفعيله يرسل GitHub المتصفح إلى Callback URL بعد التثبيت.

ويوقّع اختبار الاتصال رمزاً بالمفتاح الخاص ويسأل GitHub أي تطبيق هو.

Slack وMicrosoft Teams#

لا شيء يُعدّ على المنصة. يضيف مسؤول الشركة Webhook من إدارة الشركة › التكاملات. ولا يقبل HyoNova إلا:

• عنوان Incoming Webhook من Slack؛
• عنوان Workflow في Teams مشغّله When a Teams webhook request is received. أما عناوين موصلات Office 365 القديمة فتُرفض.

راجع إشعارات Slack وTeams.

تحقّق بعد الإعداد الأول#

يثبت اختبار الاتصال أن بيانات اعتماد التطبيق نفسه تعمل. ولا يثبت رحلة الشخص كاملة. فبعد إعداد مزوّد لأول مرة، أكمل رحلة حقيقية واحدة في شركة اختبار قبل أن تخبر العملاء بأنه جاهز:

راقب التكاملات#

يعرض مركز التحكم › العمليات › التكاملات صحة المنصة لكل الشركات: «الاتصالات وتسليم الإشعارات والخطافات الواردة والتفويضات لكل الشركات.»

ويعرض الأعداد والصحة فقط. «لا تتوفر في هذه الشاشة أسماء الحسابات ولا أسماء الملفات ولا نصوص الرسائل ولا الأسرار، ولا شيء هنا يفتح ما ربطته شركة.»

المزوّدون#

صف واحد لكل مزوّد، لكل الشركات.

طابور التسليم#

الإشعارات التي في طريقها إلى قنوات Slack وTeams: المعلّقة، وأقدم رسالة معلّقة (مع تنبيه حين تنتظر أكثر من 15 دقيقة)، والمقبولة والفاشلة والمتخطاة خلال آخر 24 ساعة. و«مقبولة» تعني أن المزوّد استلم الرسالة، لا أن الناس قرؤوها. و«متخطاة» تعني قناة موقوفة أو غير فعّالة.

الخطافات الواردة#

الأحداث التي يرسلها المزوّدون إلى HyoNova، وهي اليوم من GitHub: المستلَمة والفاشلة خلال آخر 24 ساعة، ووقت آخر حدث. والتسليم ذو التوقيع غير الصالح يُرفض. ولا يُحفظ أي محتوى.

التفويضات#

عمليات تسجيل الدخول لدى Google وMicrosoft وGitHub التي بدأها أشخاص من HyoNova: ما بدأ وما فشل خلال آخر 24 ساعة. والفشل قد يكون أيضاً شخصاً ألغى.

أوقف مزوّداً مؤقتاً#

في صف كل مزوّد زر إيقاف مؤقت. والمزوّد الموقوف يتوقف عن كل الشركات:

• ترى الشركات موقوف من HyoNova على البطاقة؛
• لا اتصالات جديدة ولا مزامنة ولا تسليم؛
• الإشعارات التي يحين وقتها خلال الإيقاف تُتخطى، ولا تُرسل لاحقاً؛
• تبقى الاتصالات القائمة وإعداداتها محفوظة.

واستئناف يعيد تشغيل الاتصالات والمزامنة والتسليم. والإشعارات التي تُخطّيت خلال الإيقاف لا تُرسل بعده.

يحتاج الإيقاف والاستئناف إلى صلاحية إدارة العمليات (operations.manage)، وإلى تحقق إضافي حديث من الهوية، وإلى سبب مكتوب، ويُسجَّل كلاهما في سجل تدقيق المنصة.

الحالة#