ربط الهوية الرقمية UAE PASS بتطبيقك: الدخول والتوقيع
كيف تضيف منشأة في الإمارات تسجيل الدخول والتوقيع ومشاركة البيانات عبر UAE PASS إلى تطبيقها: مراحل الاعتماد الأربع، وربط الحسابات، وقواعد تجربة المستخدم.
تستطيع المنشأة الخاصة في الإمارات أن تضيف UAE PASS إلى موقعها الإلكتروني أو تطبيقها الجوال لتسجيل الدخول، وللتوقيع الرقمي والختم الإلكتروني (eSeal)، ولمشاركة البيانات والمستندات بموافقة المستخدم. تتقدّم المنشأة بصفتها «مزوّد خدمة» برخصة تجارية إماراتية سارية، فتُعتمد حالة الاستخدام، ثم تبني الربط على بيئة الاختبار، وتجتاز تقييمًا، وبعدها فقط تحصل على بيانات اعتماد بيئة الإنتاج. الجانب التقني قائم على معيار OAuth 2.0 المعروف، أما معظم الجهد فيقع في ربط الحسابات واتباع قواعد رحلة المستخدم الرسمية.
آخر تحديث: 6 نوفمبر 2026
ما الذي يقدّمه UAE PASS للمنشآت الخاصة
UAE PASS هو الهوية الرقمية الوطنية في الإمارات، ويُستخدم لتسجيل الدخول إلى الخدمات الحكومية. فسجل الموردين الاتحادي التابع لوزارة المالية، على سبيل المثال، يعتمد UAE PASS لتسجيل الدخول. وإضافته إلى تطبيقك تتيح للمستخدمين أنفسهم الدخول أو توقيع المستندات دون إنشاء كلمة مرور جديدة.
تذكر الوثائق الرسمية ثلاث خدمات:
| الخدمة | متاحة لـ | استخدام معتاد في تطبيق خاص |
|---|---|---|
| المصادقة (تسجيل الدخول) | الجهات الحكومية والمنشآت الخاصة | زر «تسجيل الدخول باستخدام UAE PASS» في بوابة أو تطبيق جوال |
| التوقيع الرقمي والختم الإلكتروني | الجهات الحكومية والمنشآت الخاصة | توقيع العملاء على عقد أو نموذج، وختم المستندات التي تصدرها منشأتك |
| مشاركة البيانات والمستندات | المنشآت الخاصة فقط | طلب مستند لدى جهة أخرى بموافقة المستخدم |
وتغطي الوثائق أيضًا التسجيل عبر الويب، وتأكيد المعاملات ببصمة الوجه، والتوقيع على البصمة الرقمية للمستند (Hash Signing) بدلًا من الملف كاملًا. ولكل خدمة استبيان خاص بها أثناء الاعتماد، لذا حدّد مبكرًا ما تحتاج إليه.
قبل التقديم: من هو مزوّد الخدمة
مزوّد الخدمة هو منشأتك، لا الجهة التي تبرمج لك. يطلب فريق الاعتماد من المنشآت الخاصة رخصة تجارية إماراتية سارية، ويوجّهها بحسب الإمارة المسجّلة فيها. ويمكن لشركة برمجيات خارج الإمارات أن تبني الربط وتختبره، لكن الطلب والاتفاقية وبيانات الاعتماد تكون باسم المنشأة المرخّصة في الإمارات.
جهّز ثلاثة أمور قبل تقديم الطلب:
- الخدمات المطلوبة: تسجيل الدخول فقط، أم معه التوقيع أو الختم الإلكتروني أو مشاركة البيانات.
- مخطط سير العمل لرحلة المستخدم، مبني على حالات الاستخدام القياسية في الإرشادات الرسمية.
- نماذج أولية للواجهات (Wireframes) لكل شاشة يظهر فيها UAE PASS.
حالات الاستخدام التي تخرج عن الإرشادات القياسية تحتاج إلى موافقة الإدارة، وتنبّه الوثائق إلى أن ذلك قد يطيل المدة. لذا فإن التصميم وفق السيناريوهات القياسية هو الطريق الأسرع عادةً.
مراحل الاعتماد الأربع
تقسّم الوثائق عملية الاعتماد إلى أربع مراحل. هذا ما يحدث في كل مرحلة ومن يتولّاه:
| المرحلة | ما تقوم به منشأتك | ما يقوم به فريق اعتماد UAE PASS |
|---|---|---|
| البدء | تقديم الطلب عبر بوابة المطورين (نوع الجهة: خاصة)، وتعبئة استبيانات الخدمات، وإرسال مخطط سير العمل والنماذج الأولية | طلب الرخصة التجارية، وإرسال المواد المرجعية، وتقييم حالة الاستخدام واعتمادها |
| التطوير | الربط على بيئة الاختبار، ثم طلب تقييم بيئة الاختبار | إصدار بيانات اعتماد بيئة الاختبار، وبدء توقيع اتفاقية مزوّد الخدمة (مذكرة تفاهم للجهات الحكومية) |
| التقييم | معالجة الملاحظات، وتسجيل فيديو لكل سيناريو مختبَر، وتوقيع الاتفاقية | إجراء التقييم وفق قائمة تحقق، وجولة ثانية عند الحاجة، والحصول على موافقة الإدارة |
| الإطلاق | تقديم نموذج الإطلاق، والتنفيذ على بيئة الإنتاج، وإبلاغهم بموعد الإطلاق | إصدار بيانات اعتماد الإنتاج، وإجراء تقييم الإنتاج، ومنحك وصولًا إلى مكتب الدعم |
يخرج من هذا الجدول أمران عمليان. الأول أن رابط إعادة التوجيه (Redirect URL) الذي تسجّله لبيئة الاختبار يجب أن يكون عنوان تطوير أو اختبار، ولا يُطلب رابط الإنتاج إلا بعد اعتماد التقييم. والثاني أن بيانات الاعتماد خاصة بكل قناة: البيانات المعتمدة لموقعك الإلكتروني لا تُستخدم في تطبيقك الجوال دون موافقة الفريق، فإن احتجت إلى الاثنين فأدرجهما في حالة الاستخدام من البداية.
كيف يعمل تسجيل الدخول تقنيًا
تطبيقات الويب
تقوم المصادقة في UAE PASS على معيار OAuth 2.0. يرسل تطبيقك المستخدم إلى نقطة التفويض (authorize)، ثم يستقبل رمز التفويض على رابط إعادة التوجيه، ويستبدله على الخادم برمز وصول (token)، ثم يقرأ بيانات المستخدم من نقطة معلومات المستخدم (userinfo). بيئة الاختبار على stg-id.uaepass.ae وبيئة الإنتاج على id.uaepass.ae، ولكل منهما نقاط authorize وtoken وuserinfo وlogout.
للاختبار، يحتاج المطورون والمختبرون إلى مستخدم على بيئة الاختبار، وإلى تطبيق UAE PASS الخاص ببيئة الاختبار مثبّتًا على جهاز اختبار. وعندما يسجّل المستخدم خروجه من بوابتك، تنص الوثائق على أن تسجّل خروجه من UAE PASS أيضًا عبر نقطة الخروج، مع إعادة توجيهه إلى موقعك.
التطبيقات الجوالة
يحتاج التطبيق الجوال إلى خطوات إضافية، لأن المستخدم يؤكد الدخول في تطبيق UAE PASS على الهاتف نفسه. باختصار، يقوم تطبيقك بما يلي:
- يسجّل نظام عناوين خاصًا به (Custom URI Scheme) لدى نظام التشغيل.
- يبدأ مسار OAuth داخل WebView.
- يلتقط عنوان تطبيق UAE PASS، ويستبدل رابط الرجوع بعنوان تطبيقك، ثم يفتح تطبيق UAE PASS.
- يستقبل المستخدم عائدًا عبر عنوان تطبيقك، ويفتح رابط الرجوع الأصلي داخل WebView.
- يراقب رابط إعادة التوجيه الخاص بـ OAuth، الذي يعني اكتمال الدخول.
وتنبّه الوثائق إلى استخدام نظام العناوين الخاص بتطبيقك لا عناوين التطبيق التجريبي، في بيئتي الاختبار والإنتاج، وإلا قد يُوجَّه المستخدمون إلى تطبيق آخر. وتتوفر تطبيقات نموذجية لنظامي iOS وAndroid.
مستويات الحسابات وربط المستخدمين الحاليين
حسابات UAE PASS ثلاثة مستويات، تسمّيها الوثائق «قوة الملف الشخصي» (SOP):
- SOP1، الأساسي: البريد الإلكتروني ورقم الهاتف موثّقان برمز OTP، والهوية الإماراتية غير موثّقة. خدمات محدودة، ولا توقيع للمستندات.
- SOP2، المتقدم: حساب موثّق، والتوقيع فيه بالمستوى المتقدم.
- SOP3، المعتمد: حساب موثّق بالقياسات الحيوية، والتوقيع فيه بالمستوى المعتمد.
لا يُرجع UAE PASS رقم الهوية الإماراتية لمستخدم SOP1، لذا يجب أن يعرض تطبيقك رسالة واضحة بدلًا من أن يتوقف دون تفسير. وحدّد في مخطط حالة الاستخدام المستويات التي تقبلها خدمتك.
أما السؤال الأصعب فهو: ماذا يحدث حين يدخل شخص عبر UAE PASS ولديك عملاء مسجّلون أصلًا؟ تصف الإرشادات ثلاثة مسارات، وتتوقع تنفيذها جميعًا في الإصدار نفسه:
- الربط التلقائي: مطابقة خاصية موثّقة وفريدة، مثل رقم هوية إماراتية موثّق، أو بريد إلكتروني موثّق وفريد، أو بريد إلكتروني ورقم هاتف موثّقين معًا.
- الربط اليدوي: يُطلب من المستخدم الدخول مرة واحدة باسم المستخدم وكلمة المرور الحاليين (أو الإجابة عن أسئلة أمان)، ثم تُربط الحسابات.
- تسجيل مستخدم جديد: تُعبّأ استمارة التسجيل مسبقًا من بيانات UAE PASS، ولا يُطلب إلا ما تحتاج إليه منشأتك من حقول.
وفي كل الحالات تحفظ معرّف UUID الذي يُرجعه UAE PASS وتستخدمه في عمليات الدخول اللاحقة. ولا يُنصح بالربط على البريد الإلكتروني وحده، كما لا يُستحسن ربط حساب موثّق بحساب غير موثّق في أي من الاتجاهين.
قواعد تجربة المستخدم التي يفحصها التقييم، وخطط البديل
يراجع فريق الاعتماد رحلتك وفق إرشادات التنفيذ القياسية قبل الاعتماد، وأثناء تقييم بيئة الاختبار، وبعد الإطلاق. وهذه أكثر القواعد التي تستلزم تغييرًا في التطبيقات القائمة:
- فصل المسارات. لا يُدمج «تسجيل الدخول باستخدام UAE PASS» في مسار الدخول أو التسجيل المحلي لديك.
- لا كلمات مرور في رحلة UAE PASS. لا تطلب من مستخدم UAE PASS الجديد إنشاء اسم مستخدم وكلمة مرور، ولا ترسل له واحدة بالبريد، ولا تتيح تغيير كلمة المرور أثناء الدخول عبر UAE PASS.
- المستخدم هو من يبدأ الدخول. لا تُطلق مصادقة UAE PASS نيابةً عن المستخدم.
- رحلة كاملة لا ميزة جانبية. يجب أن يصل مستخدمو UAE PASS إلى الخدمات نفسها المتاحة للمستخدمين المحليين، فاستخدامه لتحديث البريد الإلكتروني وحده مثلًا أمر يجب تجنّبه.
- الأزرار والرسائل الرسمية. استخدم تصاميم الأزرار المنشورة (ولها نسخ عربية وإنجليزية)، واتبع إرشادات نصوص الرسائل عند عرض الأخطاء.
وخطط البديل نابعة من القواعد نفسها. فبما أن المسارين مستقلان، يبقى الدخول الحالي متاحًا للعملاء الذين لا يملكون حساب UAE PASS. وجهّز شاشات واضحة للحالات المتوقعة: مستخدم SOP1 في خدمة تحتاج إلى هوية موثّقة، ومستخدم يلغي العملية في تطبيق UAE PASS، وعميل سابق لا تطابق بياناته أي حساب. كل حالة منها تحتاج إلى خطوة تالية، لا إلى رمز خطأ.
دور KF Tech Solutions
نبني مواقع الويب والتطبيقات الجوالة والأنظمة الخلفية التي تشغّلها، بما في ذلك الربط عبر واجهات البرمجة مع الأنظمة الخارجية. وفي حالة UAE PASS يعني ذلك مسار OAuth على خادمك، والانتقال بين تطبيقك وتطبيق UAE PASS على الهاتف، وربط الحسابات ببيانات عملائك الحالية، والشاشات والنماذج الأولية التي يحتاجها طلب اعتماد حالة الاستخدام. ويبقى الطلب والاتفاقية باسم منشأتك. نعمل مع المنشآت في مصر والخليج، ويمكنك الاطلاع على أسلوبنا في الربط في مقال ربط الأنظمة التي تعمل بها بالفعل وفي خدمة واجهات البرمجة والأنظمة الخلفية.
أسئلة شائعة
هل تستطيع شركة خاصة استخدام UAE PASS؟
نعم. المصادقة والتوقيع الرقمي والختم الإلكتروني متاحة للجهات الحكومية والمنشآت الخاصة، أما مشاركة البيانات والمستندات فمتاحة للمنشآت الخاصة فقط. وتحتاج المنشآت الخاصة إلى رخصة تجارية إماراتية سارية لبدء الاعتماد.
هل يمكن لمطوّر من خارج الإمارات تنفيذ الربط؟
يمكن للمطوّر بناء الربط واختباره، لكن مزوّد الخدمة الذي يتقدّم للاعتماد هو المنشأة المرخّصة في الإمارات. وتصدر بيانات الاعتماد واتفاقية مزوّد الخدمة وموافقة الإطلاق باسم تلك المنشأة.
هل UAE PASS هو نفسه تسجيل الدخول عبر OpenID Connect؟
يقوم ربط الويب على OAuth 2.0 بنقاط authorize وtoken وuserinfo وlogout، وتذكر متطلبات التطبيقات الجوالة OAuth 2.0 أو OpenID Connect. وما يميّزه هو عملية الاعتماد وقواعد رحلة المستخدم المضافة فوق ذلك.
هل يجب أن نلغي طريقة الدخول الحالية؟
لا. تشترط الإرشادات أن يكون مسار UAE PASS مستقلًا عن الدخول المحلي، فيبقى الدخول الحالي متاحًا لمن لا يستخدم UAE PASS.
كم تستغرق عملية الاعتماد؟
لا تحدد الوثائق مدة ثابتة. فالمدة تعتمد على سرعة اعتماد حالة الاستخدام، وعدد جولات التقييم، ومدى اتباع رحلتك لحالات الاستخدام القياسية. والحالات غير القياسية تحتاج إلى موافقة إضافية.
هل نضيف UAE PASS إلى تطبيق لم نبنه بعد؟
إذا كان مستخدموك من المقيمين في الإمارات، فخطّط له من الإصدار الأول، لأن قواعد الربط تؤثر في تصميم جدول المستخدمين. وإن كنت ما زلت تختبر الفكرة، فاقرأ لديك فكرة تطبيق؟ ابدأ صغيرًا بنسخة أولية، وتعرّف على ما يحدّد تكلفة تصميم تطبيقات الهواتف الذكية في الإمارات. ومزيد من المحتوى للمنشآت الإماراتية في صفحة الإمارات.
إن أردت إضافة UAE PASS إلى موقعك الإلكتروني أو تطبيقك، أخبرنا بما تبنيه أو احجز مكالمة مجانية، وسنرسم معك خطة الاعتماد والربط.
المصادر
اقرأ المزيد
النشرة البريدية
ملاحظات من حين لآخر عن البرمجيات والأتمتة وإدارة أعمال أفضل. دون رسائل مزعجة.