Connected App
نظرة عامة
فيما يلي شرح عملي يركز على الأعمال لنوع المستند Connected App، بلغة واضحة ومناسبة للمستخدمين غير التقنيين.
ما هو استخدام نوع المستند Connected App في عمليات الأعمال؟
نوع المستند Connected App يُستخدم لربط "دفاتر" مع أنظمة أو تطبيقات خارجية يعتمد عليها العمل اليومي، مثل بوابات العملاء، أنظمة الدفع، أو تطبيقات الشركاء.
الهدف منه هو تمكين تبادل البيانات بسلاسة بين "دفاتر" وهذه التطبيقات دون تدخل يدوي، مما يقلل الأخطاء ويوفر الوقت ويضمن استمرارية العمليات.
ببساطة، Connected App هو نقطة الثقة التي تسمح لتطبيق خارجي بالعمل مع بياناتك بطريقة منظمة وآمنة تخدم أهداف العمل.
المتطلبات الأساسية قبل استخدام Connected App
قبل البدء باستخدام Connected App، يجب الانتباه إلى ما يلي:
- وجود حاجة عمل واضحة للربط مع نظام أو تطبيق خارجي (مثل تطبيق عملاء أو شريك).
- تحديد نوع البيانات التي سيتم تبادلها ولماذا (مثل طلبات، مدفوعات، بيانات عملاء).
- موافقة الإدارة على مشاركة بيانات محددة مع طرف خارجي.
- وضوح المسؤولية: من داخل الشركة من يدير هذا الربط ويتابع عمله.
هذه الخطوات تضمن أن استخدام Connected App يخدم العمل فعلياً ولا يسبب تعقيداً أو مخاطر غير ضرورية.
سير العمل النموذجي وكيف يتناسب مع عمليات الأعمال
سير العمل المعتاد لاستخدام Connected App يكون كالتالي:
تحديد الحاجة التجارية
مثال: ربط "دفاتر" مع تطبيق خارجي يستقبل طلبات العملاء.إنشاء مستند Connected App
يتم تعريف التطبيق الخارجي واعتماده رسمياً ليكون جزءاً من دورة العمل.تحديد الصلاحيات التجارية
ما الذي يُسمح لهذا التطبيق بالاطلاع عليه أو تنفيذه (مثل إنشاء طلب، متابعة حالة، أو تسجيل دفعة).الاعتماد والتشغيل
بعد الاعتماد، يبدأ التطبيق الخارجي بالتعامل مع "دفاتر" ضمن الإطار المسموح.المتابعة والمراجعة
التأكد بشكل دوري أن الربط يعمل كما هو متوقع ويدعم أهداف العمل.
هذا السير يجعل الربط جزءاً طبيعياً من العمليات اليومية دون تعطيل أو تعقيد.
السيناريوهات التجارية الرئيسية التي يكون فيها Connected App ضرورياً
يكون نوع المستند Connected App مهماً في عدة سيناريوهات، منها:
بوابة عملاء خارجية
عندما يستخدم العملاء تطبيقاً أو موقعاً لإدخال طلباتهم أو متابعة تعاملاتهم.شركاء أعمال
مشاركة البيانات مع موزعين، وسطاء، أو شركاء يحتاجون للتكامل المباشر مع عملياتك.أنظمة دفع أو تحصيل
عند تسجيل المدفوعات تلقائياً دون إدخال يدوي.تطبيقات ميدانية
مثل فرق المبيعات أو الخدمة التي تعمل بتطبيق منفصل لكنها تحتاج بيانات محدثة.
في كل هذه الحالات، Connected App يضمن أن العمل يتم بسلاسة ومن مصدر واحد موثوق.
اعتبارات مهمة للمستخدمين
عند استخدام Connected App، يجب الانتباه إلى النقاط التالية:
- لا تمنح صلاحيات أكثر مما يتطلبه العمل الفعلي.
- راجع التطبيقات المرتبطة بشكل دوري وتأكد أنها ما زالت مستخدمة.
- أي ربط خارجي يمثل امتداداً لعملياتك، لذا يجب التعامل معه بنفس الجدية.
- عند تغيير سياسات العمل أو الشركاء، راجع إعدادات Connected App فوراً.
خلاصة
نوع المستند Connected App هو أداة أعمال أساسية لربط "دفاتر" بالعالم الخارجي بطريقة منظمة وآمنة، ويُستخدم عندما تحتاج العمليات إلى التكامل والتوسع دون فقدان السيطرة أو وضوح المسؤوليات.
المعلومات الأساسية
- الوحدة: التكاملات
- نوع المستند: Document
الحقول
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| provider_name | اسم المزود | البيانات | ✓ | - | اسم مزود الخدمة المتكاملة مع دفاتر |
| openid_configuration | OpenID Configuration | البيانات | - | رابط إعدادات OpenID لمزامنة الدخول الآمن | |
| client_id | Client Id | البيانات | - | معرف التطبيق الممنوح من المزود | |
| redirect_uri | Redirect URI | البيانات | - | عنوان إعادة التوجيه بعد المصادقة | |
| client_secret | سر العميل | كلمة مرور | - | السر السري لتوثيق الاتصال مع المزود | |
| scopes | نطاقات | جدول | OAuth Scope | الصلاحيات المطلوبة للوصول إلى بيانات الأعمال | |
| authorization_uri | Authorization URI | نص صغير | - | رابط بدء عملية التفويض للمستخدمين | |
| token_uri | Token URI | البيانات | - | رابط استلام رموز الوصول والتحديث | |
| revocation_uri | Revocation URI | البيانات | - | رابط إلغاء صلاحية الرموز عند الحاجة | |
| userinfo_uri | Userinfo URI | البيانات | - | رابط جلب بيانات المستخدم المعتمد | |
| introspection_uri | Introspection URI | البيانات | - | رابط فحص حالة وصلاحية الرموز | |
| query_parameters | Query Parameters | جدول | Query Parameters | معلمات إضافية مخصصة لطلبات التفويض |
الجداول الفرعية
نطاقات (OAuth Scope)
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| scope | نطاق | البيانات | - | نطاق الصلاحيات الممنوحة للتطبيق للوصول إلى موارد دفاتر. |
Query Parameters (Query Parameters)
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| key | مفتاح | البيانات | ✓ | - | اسم المعامل المستخدم لتصفية الاستعلام في دفاتر |
| value | القيمة | البيانات | ✓ | - | قيمة المعامل المرسلة لتحديد نتائج الاستعلام في دفاتر |
الصلاحيات
| الدور | قراءة | كتابة | إنشاء | حذف | إرسال | إلغاء |
|---|---|---|---|---|---|---|
| System Manager | ✓ | ✓ | ✓ | ✓ | ||
| All | ✓ |
أنواع المستندات ذات الصلة
| نوع المستند | العلاقة | الوحدة |
|---|---|---|
| حساب البريد الإلكتروني | مرتبط من | البريد الإلكتروني |
| Token Cache | مرتبط من | التكاملات |