تسجيل تطبيق خارجي

الهدف

سجّل نظامًا خارجيًا (تكاملًا أو خدمة أو وسيط برمجيات) حتى يتمكن من استدعاء واجهات Parsware البرمجية باستخدام بيانات اعتماده الخاصة.

المتطلبات المسبقة

• أنت مسجّل الدخول إلى مركز التحكم الإداري بصفة مسؤول المنصة.
• أنت تعرف النطاقات التي يحتاجها النظام الخارجي (على سبيل المثال، صلاحية القراءة لبيانات التطبيق).

الخطوات

1. افتح صفحة تسجيلات التطبيقات من شريط التنقل الجانبي.
2. أدخل اسم تطبيق يعرّف النظام الخارجي.
3. اختر من القائمة النطاقات التي يحتاجها التطبيق. كل نطاق يمنح نوعًا محددًا من الصلاحيات.
4. اختر الأدوار الأمنية التي يحملها التطبيق، إن وُجدت. تركُ هذا فارغًا هو أقل امتياز: يمكن للتطبيق استدعاء المنصة دون أن يمسّ أي سجل. يعمل سكربت Custom API بصفة التطبيق نفسه وتحت هذه الأدوار — فالتطبيق الذي تقرأ سكربتاته السجلات أو تكتبها يحتاج بالضبط الدور الواحد الذي يجيز ذلك، ويُمنح ذلك الدور صلاحيات في البيئات التي يخدمها التطبيق فقط.
5. اختر تسجيل التطبيق.
6. تعرض لوحة مُعرّف العميل وسر العميل الجديدين. انسخ سر العميل الآن — فهو يُعرض مرة واحدة فقط ولا يمكن استرجاعه بعد ذلك.

ما الذي يحدث خلف الكواليس

يصبح التطبيق الخارجي عميلًا مسجّلًا لواجهة البرمجة. يستخدم التطبيق مُعرّف العميل وسر العميل للمصادقة والحصول على رمز وصول قصير العمر، ثم يستدعي التطبيق واجهات Parsware البرمجية بذلك الرمز. يقتصر الرمز على النطاقات التي منحتها بالضبط.

حل المشكلات

• «Scope … can only be granted by the platform operator.» — ‏parsware.provision و parsware.portals.serve تخص خوادم مشغّل المنصة نفسه (الموقع الإلكتروني ومضيف البوابات) ولا تظهر في قائمتك. لا يحتاجها أيٌّ من تطبيقاتك.
• ظل التطبيق الذي أُبطل يتلقى إجابات لبعض الوقت. يمنعه الإبطال فورًا من الحصول على رمز جديد، لكن كل خدمة تتحقق بنفسها من الرمز الذي يحمله، فيبقى صالحًا حتى ينتهي خلال ساعة. لقطعه فورًا، أزل أيضًا أذونات دوره في تلك البيئة: فهي تُفحص عند كل استدعاء.
• «Scope … is not a known platform scope.» — النطاق المطلوب غير موجود في فهرس النطاقات. اختر النطاقات من القائمة المعروضة فقط.
• «At least one scope must be granted.» — اختر نطاقًا واحدًا على الأقل قبل التسجيل.
• فقدتَ سر العميل — لا يمكن استرجاع السر. ألغِ التسجيل ثم سجّل التطبيق من جديد للحصول على سر جديد.

سيناريوهات ذات صلة

• إلغاء تسجيل تطبيق خارجي.