OAuth Client

← العودة إلى التكاملات

نظرة عامة

فيما يلي شرح عملي يركز على الأعمال لنوع المستند OAuth Client، مع ربطه بالاستخدام الفعلي داخل منظومة دفاتر دون الدخول في تفاصيل تقنية.

ما هو استخدام نوع المستند OAuth Client في عمليات الأعمال؟

يُستخدم نوع المستند OAuth Client لتمكين دفاتر من التواصل الآمن مع أنظمة أو تطبيقات خارجية معتمدة، مثل: - تطبيقات الشركاء - بوابات العملاء - تطبيقات الجوال - منصات خارجية تحتاج للوصول إلى بيانات محددة

من منظور الأعمال، هذا المستند هو وسيلة للتحكم في من يمكنه الوصول إلى بياناتك، ولماذا، وبأي حدود.
هو أشبه بـ “تصريح رسمي” تمنحه شركتك لتطبيق أو نظام آخر للوصول إلى معلومات معينة داخل دفاتر دون تدخل يدوي متكرر.

المتطلبات الأساسية قبل استخدام OAuth Client

قبل إنشاء واستخدام OAuth Client، يجب التأكد من الآتي:

هذه الخطوة مهمة لضمان أن استخدام OAuth Client يخدم هدفاً تجارياً حقيقياً ولا يفتح المجال لمخاطر غير محسوبة.

سير العمل النموذجي وكيف يتناسب مع عمليات الأعمال

سير العمل المعتاد لاستخدام OAuth Client يكون كالتالي:

  1. ظهور حاجة تجارية

    • مثل إطلاق تطبيق للعملاء أو ربط دفاتر مع نظام شريك.

  2. إنشاء مستند OAuth Client

    • يتم تسجيل التطبيق أو النظام الخارجي رسمياً داخل دفاتر.

  3. تحديد نطاق الاستخدام

    • ما الذي يمكن للتطبيق الوصول إليه وما الذي لا يمكنه الوصول إليه.

  4. الموافقة والاعتماد

    • يتم اعتماد هذا الوصول من الإدارة أو الجهة المختصة.

  5. بدء الاستخدام الفعلي

    • التطبيق الخارجي يبدأ بالعمل مع دفاتر ضمن الحدود المتفق عليها.

بهذا الشكل، يصبح التكامل جزءاً منظماً من سير العمل التجاري وليس حلاً مؤقتاً أو غير منضبط.

السيناريوهات التجارية الرئيسية التي يكون فيها OAuth Client ضرورياً

يكون نوع المستند OAuth Client ضرورياً في حالات مثل:

في كل هذه السيناريوهات، يساعد OAuth Client على تسريع العمل وتحسين تجربة المستخدم مع الحفاظ على التحكم الكامل.

اعتبارات مهمة للمستخدمين

عند التعامل مع OAuth Client، يُنصح بالانتباه إلى ما يلي:

التعامل الواعي مع OAuth Client يحمي بيانات الشركة ويعزز الثقة مع العملاء والشركاء في نفس الوقت.

خلاصة

نوع المستند OAuth Client هو أداة أعمال استراتيجية داخل دفاتر، تُمكّنك من التوسع، والتكامل، وتقديم خدمات رقمية حديثة، مع الحفاظ على السيطرة والأمان. استخدامه الصحيح يفتح فرصاً جديدة دون تعقيد العمليات اليومية.

المعلومات الأساسية

الحقول

اسم الحقل التسمية النوع مطلوب الخيارات الوصف
client_id هوية العميل للتطبيق البيانات - معرف فريد للتطبيق المتكامل مع دفاتر
app_name اسم التطبيق البيانات ✓ - اسم التطبيق الظاهر لإدارة التكاملات في دفاتر
user مستخدم رابط مستخدم المستخدم المسؤول عن صلاحيات هذا التطبيق
allowed_roles Allowed Roles الجدول MultiSelect OAuth Client Role الأدوار المسموح لها باستخدام التطبيق
client_secret كلمة مرور التطبيق الثانوي البيانات - مفتاح سري لمصادقة التطبيق بأمان
skip_authorization تجاهل حق الوصول التحقق من - تخطي موافقة المستخدم أثناء الربط
scopes نطاقات نص ✓ - نطاق الصلاحيات الممنوحة للتطبيق
redirect_uris إعادة توجيه محددات نص - عناوين إعادة التوجيه بعد تسجيل الدخول
defaultredirecturi رابط اعادة التوجيه الافتراضي البيانات ✓ - عنوان إعادة التوجيه الافتراضي للتطبيق
grant_type منحة نوع حدد رمز الترخيص, ضمني طريقة التفويض المعتمدة للتكامل
response_type نوع الاستجابة حدد رمز, رمز نوع الاستجابة المطلوبة من دفاتر

الصلاحيات

الدور قراءة كتابة إنشاء حذف إرسال إلغاء
System Manager ✓ ✓ ✓ ✓

أنواع المستندات ذات الصلة

نوع المستند العلاقة الوحدة
مصادقة رمز التفويض مرتبط من التكاملات
حامل رمز المصادقة مرتبط من التكاملات
مستخدم يربط إلى النواة