دليل ربط UAE PASS بالتطبيقات والمواقع الإلكترونية

ربط UAE PASS يتيح للناس تسجيل الدخول إلى تطبيقك أو موقعك بالهوية الرقمية الإماراتية، والتوقيع على المستندات بها إن احتاجت خدمتك ذلك. الكود نفسه تسجيل دخول قياسي بمعيار OAuth 2.0. أما المسار الأطول فهو اعتماد UAE PASS: يراجع حالة الاستخدام والشاشات قبل أن تحصل على بيانات الدخول، ويقيّم عملك قبل الإطلاق.

ماذا يتطلب ربط UAE PASS؟

الجواب المختصر: تتقدم الجهات الحكومية، والشركات الخاصة التي تملك رخصة تجارية إماراتية سارية، بطلب الربط على بوابة مطوري UAE PASS. يعتمد فريق UAE PASS حالة الاستخدام، ويرسل بيانات البيئة التجريبية، ويقيّم عملك فيها، ثم يصدر بيانات الإنتاج. الدخول من الموقع هو مسار رمز التفويض في OAuth 2.0: التفويض، فرمز الوصول، فبيانات المستخدم، فتسجيل الخروج. وتطبيقات الجوال، ومنها تطبيقات Flutter، تشغّل المسار نفسه داخل WebView وتنتقل إلى تطبيق UAE PASS. وما يصلك من بيانات يعتمد على مستوى الحساب: SOP1 غير موثّق ولا يحمل رقم هوية. واربط الحسابات بالمعرّف UUID أو رقم الهوية، لا بالبريد أو الجوال.

تخطط للدخول بـ UAE PASS؟ اطلب تقديرًا لتطبيقك أو موقعك ←

كل قاعدة في هذا الدليل مأخوذة من وثائق UAE PASS الرسمية (بالإنجليزية)، وهي تتغير كثيرًا، فتأكد من التفاصيل مع فريق الانضمام المخصص لك.

من يستطيع ربط UAE PASS، ولأي غرض؟

UAE PASS هي الهوية الرقمية الوطنية للمواطنين والمقيمين والزوار، ضمن الخطة الوطنية للحكومة الذكية، وتديرها دبي الرقمية وهيئة تنظيم الاتصالات والحكومة الرقمية (TDRA) وهيئة أبوظبي الرقمية. ولكل ميزة استبيان وتقييم خاصان بها.

تبدأ أغلب التطبيقات والمواقع بتسجيل الدخول، ثم تضيف التوقيع أو مشاركة المستندات حين تحتاجها خدمة معينة.

كيف تسير مراحل الانضمام إلى UAE PASS؟

مراحل الانضمام إلى UAE PASS (بالإنجليزية) أربع، ويديرها فريق الانضمام في الإمارة المسجلة فيها جهتك.

ماذا يعني هذا لك: مسار الاعتماد يحدد موعد إطلاقك بقدر ما يحدده الكود، ولا ينشر UAE PASS مددًا زمنية، فاسأل فريق الانضمام. صمّم رحلات UAE PASS قبل التطوير لأنها أول ما يُراجَع، واطلب التقييم حين تعمل كل سيناريوهات قائمة الفحص، لا المسار السهل وحده.

SOP1 وSOP2 وSOP3: من مستخدموك، وماذا يصلك؟

لكل حساب مستوى يعود في الحقل userType، ويحدد ما يستطيع المستخدم فعله والبيانات التي تصلك.

• حدّد المستويات التي تقبلها كل خدمة في مخطط حالة الاستخدام، واعرض رسالة UAE PASS الرسمية حين يصل مستخدم SOP1 إلى خدمة تتطلب التوثيق.
• التزم بقواعد دخولك الحالي: إن كان المستخدم غير الموثّق يصل إلى خدمة عبر دخولك المعتاد، فيجب أن يصل إليها عبر UAE PASS أيضًا.
• الزوار يمكن أن يملكوا حسابات موثّقة. اطلب النطاقين profileType وunifiedId لتعرفهم، ولا تنتظر منهم رقم هوية.
• تاريخ الميلاد والعنوان ليسا في قائمة البيانات المنشورة. إن احتاجتهما خدمتك، فتأكد من UAE PASS خلال الانضمام.

كيف يعمل الدخول بـ UAE PASS من الموقع (الواجهة البرمجية)؟

تسجيل الدخول هو مسار رمز التفويض في OAuth 2.0، ونقاط الاتصال تحت stg-id.uaepass.ae/idshub/ في البيئة التجريبية وid.uaepass.ae/idshub/ في الإنتاج.

1. التفويض في المتصفح: وجّه المستخدم إلى /authorize مع response_type=code وclient_id وredirect_uri وscope وstate (يوصي به UAE PASS للحماية من هجمات CSRF) وacr_values، وui_locales=ar أو en للغة الصفحة.
2. يوافق المستخدم من هاتفه بعد إدخال رقم الهوية أو البريد أو الجوال، فيعيده UAE PASS إلى redirect_uri ومعه code وقيمة state.
3. رمز الوصول، من خادم إلى خادم: أرسل طلب POST إلى /token مع grant_type=authorization_code ورابط إعادة التوجيه نفسه والرمز، بمصادقة HTTP Basic وترويسة Content-Type: multipart/form-data. الرمز يُستخدم مرة واحدة ومدته قصيرة، فاستبدله فورًا. ورموز الوصول في الإنتاج صالحة 3,600 ثانية لكل مزوّدي الخدمة.
4. بيانات المستخدم، من خادم إلى خادم: استدعِ /userinfo مع Authorization: Bearer <token>.
5. تسجيل الخروج: حين يخرج المستخدم من خدمتك، وجّهه أيضًا إلى /logout لتنتهي جلسة UAE PASS كذلك.

ولإثبات المفهوم قبل الانضمام، تنشر الوثائق بيانات دخول تجريبية مشتركة تعمل في البيئة التجريبية فقط.

كيف يعمل ربط UAE PASS في تطبيقات الجوال؟

في iOS وأندرويد، تطلب الوثائق أن يجري الدخول داخل WebView مضمّن في التطبيق، لا في متصفح الهاتف، وأن يسجّل تطبيقك مخطط روابط خاصًا به (URI scheme) ليعيد إليه UAE PASS التحكم.

• تطبيق UAE PASS على الهاتف نفسه: تحقق من وجوده (اسم حزمته في أندرويد، أو المخطط uaepass:// في iOS، وuaepassstg:// في البيئة التجريبية)، وحمّل رابط الدخول بقيمة acr_values الخاصة بالدخول من الجهاز نفسه. حين يصل WebView إلى الرابط العميق لـ UAE PASS، احفظ رابطي النجاح والفشل فيه، وأعد كتابتهما بمخطط تطبيقك، وافتح الرابط لتشغيل UAE PASS. بعد موافقة المستخدم يفتح UAE PASS مخطط تطبيقك؛ حمّل رابط النجاح المحفوظ في WebView نفسه، فيصل الرمز مع إعادة التوجيه.
• تطبيق UAE PASS غير مثبّت: حمّل رابط الدخول القياسي في WebView، ويوافق المستخدم على إشعار يصله على جهاز آخر فيه UAE PASS.

بعدها يجري طلبا رمز الوصول وبيانات المستخدم على خادمك كما في الموقع. وتنشر UAE PASS أيضًا تطبيقات نموذجية مع حزم SDK لنظامي iOS وأندرويد، تغطي الحالتين وبيانات المستخدم وتوقيع المستندات. ومن الوثائق تحذيران: لا تستخدم مخطط التطبيق التجريبي (demo) أبدًا، واجعل البيئة التي تتصل بها مطابقة لتطبيق UAE PASS المثبّت، فالنسخة التجريبية ونسخة الإنتاج تطبيقان مختلفان.

كيف تربط UAE PASS بتطبيق Flutter؟

لا تذكر وثائق UAE PASS أي حزمة لـ Flutter، والحزم المجتمعية على pub.dev لم تنشرها UAE PASS. ابنِ مسار الجوال الموثّق نفسه، ودور Flutter أن يحدد أين تعيش كل قطعة.

والطريق الآخر أن تغلّف حزمتي iOS وأندرويد الرسميتين عبر قناة منصة (platform channel): كود أصلي أكثر، وأقرب إلى نماذج UAE PASS نفسها. وفي الحالتين، اختبر على هواتف حقيقية مع تطبيق UAE PASS التجريبي ومن دونه، بالعربية والإنجليزية.

تخطط لـ UAE PASS في تطبيق أو موقع جديد؟ أرسل لنا الخدمات التي تحتاجه، ومن يسجّل الدخول (مواطنون، مقيمون، زوار، موظفو شركات)، وهل تحتاج التوقيع، والمنصات. نردّ عليك بحالة الاستخدام التي نصمم لها، والشاشات التي تحتاجها، والفريق والسعر. اطلب تقديرًا لتطبيقك أو موقعك ←

لست مستعدًا لمكالمة؟ اطلب ملف الشركة التعريفي ونرسله إليك.

هل تحتاج التوقيع الرقمي أو الختم الإلكتروني من UAE PASS؟

• الدخول أولًا: الدخول بـ UAE PASS إلزامي قبل طلب التوقيع، للتأكد من أن الموقّع هو المستخدم الذي سجّل الدخول. ومستخدمو SOP2 يوقّعون بالمستوى المتقدم، وSOP3 بالمستوى المؤهَّل، ولا يوقّع مستخدمو SOP1.
• للتوقيع رمز وصول خاص به، يحصل عليه خادمك ببيانات العميل (client credentials)، وهو غير رمز الدخول.
• توقيع البصمة يبقي المستند لديك: ترسل بصمته (hash)، وتستلمها موقّعة، وتضمّن التوقيع في ملف PDF.
• الختم الإلكتروني يوقّع باسم جهتك، عبر إجراء شهادات يختلف بين جهات دبي وجهات الإمارات الأخرى. والصيغ هي PAdES لملفات PDF، وCAdES للملفات الأخرى، وXAdES لملفات XML.

ربط الحسابات: القواعد التي يُقيَّم عليها عملك

أغلب ملاحظات التقييم لا تقع في طلبات OAuth، بل فيما بعد الدخول، حين تطابق مستخدم UAE PASS مع سجلاتك. ويفحص UAE PASS إرشادات التطبيق القياسية (بالإنجليزية) قبل اعتماد حالة الاستخدام، وفي البيئة التجريبية، وبعد الإطلاق.

1. افصل UAE PASS عن مسارات الدخول والتسجيل الخاصة بك.
2. طابق تلقائيًا فقط ببيانات فريدة وموثّقة مثل رقم الهوية، ثم احفظ المعرّف UUID وأدخل المستخدم به بعد ذلك. يستطيع المستخدم تغيير بريده وجواله في UAE PASS، فالربط بأيٍّ منهما ينكسر ويُنشئ حسابات مكررة.
3. اربط يدويًا حين لا يطابق شيء موثّق: يدخل المستخدم اسم المستخدم وكلمة المرور الحاليين، أو يجيب عن أسئلة الأمان.
4. سجّل المستخدم الجديد بلا كلمة مرور: املأ النموذج من بيانات UAE PASS واقفل تلك الحقول، ولا ترسل بيانات دخول داخلية بالبريد أو الرسائل النصية.
5. لا تربط حسابًا موثّقًا بحساب غير موثّق، في أي اتجاه.
6. أطلق الربط التلقائي والربط اليدوي والتسجيل الجديد معًا.
7. دع المستخدم يبدأ الدخول بنفسه، واستخدم UAE PASS للرحلة كلها، لا لخطوة واحدة مثل تغيير رقم الجوال.
8. أبقِ بيانات الدخول لقناتها: للموقع بياناته وللجوال بياناته.

UAE PASS يعرّف الأشخاص، لا الشركات. فإن كان المستخدمون يتصرفون نيابة عن شركة، يقرر نظامك بعد الدخول من يحق له ذلك، بربط معرّفه UUID أو رقم هويته بحسابات الشركات التي يمثلها.

زر UAE PASS وقواعد العربية

تنشر UAE PASS إرشادات الأزرار (بالإنجليزية) وملفات الأزرار الرسمية بالعربية والإنجليزية. استخدمها، ولا تصمم زرك الخاص.

• النمط: أبيض، أو أبيض بإطار، أو أسود، بحسب التباين مع الخلفية. ونص الزر أسود أو أبيض فقط، ويحتفظ الشعار بلمساته الخضراء والحمراء.
• الحجم: 140 × 30 نقطة على الأقل، بهامش يساوي عُشر ارتفاع الزر، مع الحفاظ على نسبة الأبعاد.
• الصياغة: زر الدخول بـ UAE PASS (Sign in) في صفحة الدخول، وزر التسجيل (Sign up) في صفحة إنشاء الحساب، ولا يجتمعان في صفحة واحدة، ولا تخلط بين «Login» و«Sign in» في صفحة واحدة. وزر «Sign with UAE PASS» للتوقيع، و«Continue with UAE PASS» لمشاركة المستندات، مع إخبار المستخدم بأنه يشارك مستنداته.
• عبارة «Powered by UAE PASS» وأي استخدام آخر للشعار يحتاج موافقة كتابية مسبقة من UAE PASS أو اتفاقية قائمة.
• الرسائل: تنشر UAE PASS نص الرسالة بالعربية والإنجليزية لكل حالة، مثل إلغاء الدخول أو حساب غير موثّق. استخدمه كما هو، وستلاحظ أن النص العربي يسمّي UAE PASS «الهوية الرقمية».

قبل التقديم: قائمة تجهيز ربط UAE PASS

كيف تختبر UAE PASS في البيئة التجريبية؟

• ثبّت تطبيق UAE PASS التجريبي على هواتف الاختبار (وفي iOS، اعتمد ملف «Dubai Smart Government» من الإعدادات). يبدأ كل حساب جديد بمستوى SOP1.
• ارفع حسابات الاختبار إلى SOP3 من بوابة الخدمة الذاتية التجريبية، ويكفي فيها رقم هوية وهمي، فترقية الوجه والأكشاك داخل التطبيق لا تعمل في البيئة التجريبية. ولا تخفّض مستوى حساب: احذفه وأنشئ غيره.
• اعمل من أي مكان: حسابات الاختبار تُنشأ من أي مكان، وواجهات البيئتين متاحة من خارج الدولة.
• اختبر كل سيناريو في قائمة الفحص بكل مستوى: UAE PASS مثبّت وغير مثبّت، وإلغاء الدخول، ومستخدم غير موثّق، وكل أنواع الربط، والخروج، والعربية والإنجليزية. وسجّل كل سيناريو بالفيديو للتقييم.

أخطاء شائعة في ربط UAE PASS

ما الذي يحدد تكلفة ربط UAE PASS؟

يُسعَّر البناء بحسب ما تحتاجه خدمتك. وأكثر ما يحرّك التكلفة:

• الميزات: الدخول وحده، أو معه التوقيع أو الختم أو مشاركة المستندات.
• القنوات: موقع، وتطبيق iOS، وتطبيق أندرويد، ولكل منها بيانات دخولها وسيناريوهات تقييمها.
• مستخدموك: مستخدمون حاليون يحتاجون ربطًا تلقائيًا ويدويًا، وتسجيلات جديدة، وزوار، وأشخاص يتصرفون نيابة عن شركات.
• نظام الدخول الحالي: إضافة UAE PASS إلى جانب نظام هوية يعمل اليوم عمل مختلف عن بناء جديد.
• جولات التقييم: كل ملاحظة تعني إصلاحًا وجولة أخرى، فالاختبار قبل التقييم يصنع الفرق.

والأدوار: مصمم لرحلات المستخدم التي يراجعها UAE PASS، ومطوّر خوادم لتبادل الرمز وربط الحسابات، ومطوّر جوال لـ WebView والروابط العميقة، ومختبِر جودة لكل سيناريو وتسجيله. ودليلنا عن تكلفة تصميم تطبيق في الإمارات يبيّن كيف تضيف عمليات الربط إلى فريق التطبيق. أما الرسوم، فتقول صفحة الأسئلة الشائعة في UAE PASS إنه لا رسوم حاليًا على الربط، في إجابة تذكر أيضًا مراجعة كانت مقررة في 2021، فتأكد من الوضع الحالي خلال الانضمام.

وصلك عرض سعر لتطبيق فيه UAE PASS؟ أرسله لنا بعد حذف أي معلومات سرية. نردّ عليك بالأسئلة التي تطرحها على الشركة، وبما نغيّره فيه قبل أن توقّع. أرسل لنا عرض السعر ←

كيف نخطط لـ UAE PASS في التطبيق أو الموقع

نخطط لـ UAE PASS من أول نموذج للشاشات: رحلة حالة الاستخدام، ومستويات SOP التي تقبلها كل خدمة، وقواعد الربط، والشاشات بالعربية والإنجليزية، كلها تُصمَّم قبل الكود، لأن UAE PASS يراجعها قبل أن يرسل بيانات البيئة التجريبية. وبصفتنا شركة تصميم تطبيقات في دبي، نبني بـ Flutter وReact Native، وبلغتي Swift وKotlin للتطبيقات الأصلية، مع الخوادم ولوحة التحكم، ونبني البوابات عبر تطوير الويب حسب الطلب. ويختبر فريق جودة مستقل كل سيناريو على هواتف حقيقية. وللأنظمة الحكومية، اطّلع على صفحة البرمجيات للقطاع الحكومي.

Qargo منصة لتأجير السيارات وطلب المشاوير في قطر، فيها تطبيقان للعملاء والسائقين ولوحات تحكم للإدارة والشركاء. تحدّث مع الفريق الذي بناها: احجز اجتماعاً.

خطّط للاعتماد مع البناء

نعمل منذ 2014 مع أكثر من 100 عميل في الإمارات والسعودية وقطر والكويت والولايات المتحدة وكندا. مقرنا في مجمع دبي الرقمي، وفريقنا الأساسي يعمل من مصر. أخبرنا بالخدمات التي تحتاج UAE PASS، ومن سيسجّل الدخول إليها.

اطلب تقديرًا لتطبيقك أو موقعك ← نسألك عن هدفك، وما تستخدمه اليوم، وتوقيتك، ومن يجب أن يشارك في القرار، فتخرج بخطوات تالية واضحة. نردّ بالبريد الإلكتروني أولًا ونرتّب مكالمة فقط إذا رغبت. السؤال لا يُلزمك بشيء، ونوقّع اتفاقية عدم إفصاح أولًا إن طلبت.