حامل رمز المصادقة

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

نظرة عامة

فيما يلي شرح عملي يركز على الأعمال لنوع المستند حامل رمز المصادقة، مع توضيح دوره ضمن عمليات العمل اليومية في دفاتر.

ما هو استخدام نوع المستند "حامل رمز المصادقة" في عمليات الأعمال؟

نوع المستند حامل رمز المصادقة يُستخدم لإدارة صلاحية الاتصال الآمن بين دفاتر وأنظمة أو خدمات خارجية تعتمد عليها الشركة في أعمالها اليومية.

بشكل مبسّط: - هو وسيلة تُمكّن دفاتر من التعرّف على نفسه بثقة عند التعامل مع طرف خارجي. - يضمن أن تبادل البيانات (مثل الطلبات، المدفوعات، أو المعلومات التشغيلية) يتم فقط مع جهات مصرح لها. - يعمل كـ تصريح مؤقت يسمح بتنفيذ عمليات محددة دون الحاجة لإدخال بيانات اعتماد يدوياً في كل مرة.

المتطلبات الأساسية قبل استخدام "حامل رمز المصادقة"

قبل البدء باستخدام هذا النوع من المستندات، يجب التأكد من الأمور التالية على مستوى الأعمال:

  1. وجود حاجة واضحة للتكامل

    • مثل الربط مع بوابة دفع، منصة حكومية، نظام شريك، أو خدمة خارجية.

  2. موافقة الجهة الخارجية

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

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

    • ما الذي يُسمح لدفاتر بالقيام به؟ (قراءة بيانات، إرسال بيانات، تنفيذ عمليات).

  4. وضوح المسؤوليات

    • تحديد من في الفريق مسؤول عن متابعة صلاحية الربط وتجديده عند الحاجة.

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

سير العمل المعتاد لاستخدام حامل رمز المصادقة يكون كالتالي:

  1. قرار إداري بالربط

    • الإدارة تقرر ربط دفاتر مع نظام خارجي لدعم عملية عمل (مثل الفوترة أو التحصيل).

  2. إعداد التفويض

    • يتم إنشاء مستند حامل رمز المصادقة ليعكس هذا التفويض التجاري.

  3. بدء التشغيل

    • بعد تفعيله، يبدأ دفاتر باستخدام هذا الرمز تلقائياً عند تنفيذ العمليات المرتبطة.

  4. التشغيل اليومي

    • المستخدمون يعملون بشكل طبيعي دون تدخل يدوي، بينما يتم الاتصال بالخدمة الخارجية في الخلفية.

  5. المتابعة والتجديد

    • عند انتهاء صلاحية التفويض، يتم تجديده لضمان استمرارية العمل دون انقطاع.

هذا يجعل العمليات أكثر سلاسة ويقلل الاعتماد على الإجراءات اليدوية.

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

يكون نوع المستند حامل رمز المصادقة ضرورياً في الحالات التالية:

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

عند التعامل مع حامل رمز المصادقة، يجب الانتباه إلى ما يلي:

خلاصة

نوع المستند حامل رمز المصادقة هو عنصر أساسي غير مرئي يدعم الثقة والاستمرارية في تكاملات دفاتر مع العالم الخارجي. ورغم أنه لا يظهر في العمليات اليومية للمستخدمين، إلا أنه يلعب دوراً محورياً في تمكين الأعمال من العمل بسلاسة وأمان.

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

الحقول

اسم الحقل التسمية النوع مطلوب الخيارات الوصف
client عميل رابط OAuth Client العميل المرتبط الذي أصدر الرمز للوصول إلى خدمات دفاتر
user مستخدم رابط مستخدم المستخدم الذي يملك الصلاحيات ويستخدم الرمز للوصول
scopes نطاقات نص - نطاقات الصلاحيات المسموح بها لاستخدام واجهات خدمات دفاتر
access_token رمز وصول البيانات - رمز وصول فعّال يستخدم للمصادقة على الطلبات
refresh_token تحديث رمز البيانات - رمز لتجديد الوصول عند انتهاء صلاحية رمز الوصول
expiration_time وقت انتهاء الصلاحية التاريخ والوقت - التاريخ والوقت الذي ينتهي فيه مفعول رمز الوصول
expires_in ينتهي في الباحث - مدة الصلاحية بالثواني قبل انتهاء رمز الوصول
status الحالة حدد نشط, إلغاء حالة الرمز الحالية للاستخدام أو الإلغاء

الصلاحيات

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

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

نوع المستند العلاقة الوحدة
OAuth Client يربط إلى التكاملات
مستخدم يربط إلى النواة