إعداد ميزة مشاركة بيانات الاعتماد بسلاسة بين تطبيقات Android ومواقعه الإلكترونية

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

هناك طريقتان متوافقتان لإعداد ميزة مشاركة بيانات الاعتماد:

• Play Console: يُنصح باستخدامها لمعظم المطوّرين عند إعداد ميزة مشاركة بيانات الاعتماد مع تطبيقات Android. تتيح لك هذه الطريقة ضبط إعدادات مشاركة بيانات الاعتماد بدون الحاجة إلى إصدار نسخة جديدة من تطبيقك. يُرجى العلم أنّه حتى عند استخدام Play Console، لا يزال عليك نشر ملف assetlinks.json صالح على موقعك الإلكتروني.
• روابط مواد العرض الرقمية (DAL): مناسبة لحالات الاستخدام المتقدّمة، مثل إتاحة تطبيقات أو نطاقات متعددة مع إعدادات أكثر تعقيدًا.

ملاحظة مهمة: بغض النظر عن كيفية إعداد ميزة "مشاركة بيانات الاعتماد"، يتعامل "مدير كلمات المرور" مع علاقات مشاركة بيانات الاعتماد على أنّها علاقات انتقالية. وهذا يعني أنّه إذا كان الموقع الإلكتروني "أ" يشارك بيانات الاعتماد مع الموقع الإلكتروني "ج"، وكان الموقع الإلكتروني "ب" يشارك أيضًا بيانات الاعتماد مع الموقع الإلكتروني "ج"، سيشارك الموقعان الإلكترونيان "أ" و"ب" بيانات الاعتماد تلقائيًا مع بعضهما البعض أيضًا.

أفضل الممارسات

لتوفير أفضل تجربة أمان ومستخدم، عليك تنفيذ ميزة مشاركة بيانات الاعتماد بسلاسة في نقاط الاتصال التالية:

• نموذج تسجيل الدخول: فعِّل ميزة ملء بيانات الاعتماد تلقائيًا.
• نموذج الاشتراك: تخزين بيانات الاعتماد الجديدة بأمان لاستخدامها على جميع المنصات
• نموذج تغيير كلمة المرور: يمكنك مزامنة تعديلات كلمة المرور على جميع المنصات.
• نموذج إعادة ضبط كلمة المرور: يمكنك السماح بعمليات إعادة ضبط كلمة المرور لمرة واحدة من أجل تعديل جميع المنصات.
• نطاقات Webview: يمكنك توسيع نطاق مشاركة بيانات الاعتماد لتشمل نطاقات Webview في تطبيقك التي تتعامل مع إدارة الحسابات (مثل نماذج تسجيل الدخول إلى المضيف أو الاشتراك أو تغيير كلمة المرور أو إعادة ضبطها).
• تطبيقات Android

يؤدّي هذا النهج إلى إنشاء نظام موحّد لإدارة بيانات الاعتماد، ما يعزّز كلاً من راحة المستخدم وأمانه.

عند تصميم مواقع إدارة الحسابات الإلكترونية، ننصحك باتّباع أفضل الممارسات التالية لمواقع إدارة الحسابات الإلكترونية:

• تصميم نموذج الاشتراك وفقًا لأفضل الممارسات
• تصميم نموذج تسجيل الدخول وفقًا لأفضل الممارسات
• إضافة عنوان URL معروف لتغيير كلمات المرور

عند تصميم تطبيقات Android، ننصحك بدمج تطبيقك مع "مدير بيانات الاعتماد" في Android.

إعداد ميزة "مشاركة بيانات الاعتماد" باستخدام Play Console

يمكنك الآن تفعيل ميزة "مشاركة بيانات الاعتماد بسلاسة" مباشرةً من console Play بدون نشر إصدار جديد من تطبيق Android. وتبسّط هذه الطريقة العملية من خلال إدارة إعدادات مشاركة بيانات الاعتماد من خلال واجهة Play Console.

ملاحظة: تُنشئ أداة Play Console مقتطف JSON المطلوب، وترشدك إلى مكان نشره على موقعك الإلكتروني، ثم تتحقّق منه بعد وضعه للمساعدة في تجنُّب أخطاء الضبط.

المتطلبات الأساسية

قبل إعداد ميزة "مشاركة بيانات الاعتماد" باستخدام Play Console، تأكَّد من توفُّر ما يلي:

• أذونات Play Console اللازمة للوصول إلى قسمَي الروابط لصفحات في التطبيق و إعدادات التطبيق إذا لم تكن صاحب الحساب، اطلب من مشرف Play Console منحك إذن الوصول المناسب.
• إمكانية نشر ملف /.well-known/assetlinks.json على كل نطاق من النطاقات المعنيّة، باتّباع بنية روابط التنقّل إلى مواد العرض الرقمية (DALs)

تفعيل مشاركة بيانات الاعتماد لنطاق جديد

لإعداد ميزة "مشاركة بيانات الاعتماد بسلاسة" في Play Console لنطاق جديد، اتّبِع الخطوات التالية:

1. افتح Play Console وانتقِل إلى صفحة الروابط لصفحات في التطبيق (زيادة عدد المستخدمين > الروابط لصفحات في التطبيق).
2. ضمن علامة التبويب إعدادات التطبيق، انقر على إضافة نطاق.
3. أدخِل نطاق موقعك الإلكتروني.
4. فعِّل الخيار تفعيل مشاركة بيانات الاعتماد.
5. انسخ ملف JSON الذي تم إنشاؤه وانشره في الموقع المحدّد (https://YOUR_DOMAIN/.well-known/assetlinks.json وفقًا للبروتوكول)، أو أضِف المعلومات ذات الصلة إلى ملف assetlinks.json الحالي.
6. انقر على الربط بالموقع الإلكتروني.

في حال نجاح العملية، ستتم إعادتك إلى صفحة الروابط لصفحات في التطبيق.

تفعيل مشاركة بيانات الاعتماد لنطاق حالي

لإعداد ميزة "مشاركة بيانات الاعتماد بسلاسة" في Play Console لنطاق حالي، اتّبِع الخطوات التالية:

1. انقر على علامة التبويب ضبط التطبيق.
2. في قسم النطاقات، ضِمن إعدادات التطبيق، انقر على تفعيل في عمود مشاركة بيانات الاعتماد.
3. انسخ ملف JSON الذي تم إنشاؤه وانشره في الموقع المحدّد (أو أضِف المعلومات ذات الصلة إلى ملف assetlinks.json الحالي).
4. انقر على تفعيل مشاركة بيانات الاعتماد.

في حال نجاح العملية، ستتم إعادتك إلى صفحة الروابط لصفحات في التطبيق.

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

بالنسبة إلى عمليات الإعداد المعقدة التي تتضمّن عدة تطبيقات أو مواقع إلكترونية، استخدِم روابط مواد العرض الرقمية (DAL) لضبط مشاركة بيانات الاعتماد يدويًا.

المتطلبات الأساسية

قبل إعداد ميزة "مشاركة بيانات الاعتماد بسلاسة"، تأكَّد من توفّر ما يلي لكل من كل منصة:

لكل تطبيق Android:

• معرّف تطبيق Android، كما هو موضّح في ملف build.gradle الخاص بالتطبيق
• ملفات SHA256 المرجعية لشهادة التوقيع
• (إجراء مقترَح) تسجيل دخول المستخدم من خلال واجهة برمجة التطبيقات Credential Manager API

لكل موقع إلكتروني:

• إمكانية نشر ملف /.well-known/assetlinks.json على كل ناحية نطاق، وفقًا لبنية روابط التنقل إلى مواد العرض الرقمية (DALs)
• يجب أن تكون جميع نطاقات إدارة الحسابات (مثل تسجيل الدخول أو الاشتراك أو تغيير كلمة المرور أو نماذج إعادة ضبط كلمة المرور) متاحة من خلال بروتوكول HTTPS.

ملاحظة: يشارك Chrome تلقائيًا بيانات الاعتماد المحفوظة بين المواقع الإلكترونية التابعة للموقع نفسه (مثل www.example.com وm.example.com).

تفعيل مشاركة بيانات الاعتماد بسلاسة على مستوى تطبيقات Android والمواقع الإلكترونية

لضبط ميزة "مشاركة بيانات الاعتماد بسلاسة" على مستوى التطبيقات والمواقع الإلكترونية، عليك إنشاء ونشر قوائم بيانات روابط مواد العرض الرقمية التي توضّح الكيانات (المواقع الإلكترونية أو تطبيقات Android) المسموح لها بمشاركة بيانات الاعتماد.

ملاحظة مهمة: يتعامل "مدير كلمات المرور في Google" مع علاقات مشاركة بيانات الاعتماد على أنّها متعدّدة المستويات.

للإفصاح عن علاقة مشاركة بيانات الاعتماد:

1. أنشئ ملف assetlinks.json يتضمّن عبارات تؤدي إلى ربط الموقع الإلكتروني بتطبيق Android، وذلك باتّباع بنية قائمة عبارات DALs:

   [
     {
       "relation":[
         "delegate_permission/common.get_login_creds"
       ],
       "target":{
         "namespace":"web",
         "site":URL
       }
     },
     {
       "relation":[
         "delegate_permission/common.get_login_creds"
       ],
       "target":{
         "namespace":"android_app",
         "package_name":"APP_ID",
         "sha256_cert_fingerprints":[
           "SHA_HEX_VALUE"
         ]
       }
     }
   ]
   

   حيث يكون URL هو عنوان URL لموقعك الإلكتروني، وAPP_ID هو معرّف تطبيق Android، وSHA_HEX_VALUE هو بصمة SHA256 ل شهادة توقيع تطبيق Android.

   يصف الحقل relation العلاقة التي يتم الإعلان عنها. للإشارة إلى أنّ التطبيقات والمواقع الإلكترونية تشارك بيانات اعتماد تسجيل الدخول، حدِّد العلاقات على النحو التالي: delegate_permission/common.get_login_creds. اطّلِع على مزيد من المعلومات حول سلاسل العلاقات في واجهات برمجة التطبيقات لقواعد البيانات.

   حقل target هو عنصر يحدّد مادة العرض التي ينطبق عليها البيان.

   تحدِّد الحقول التالية موقعًا إلكترونيًا:

   namespace

   web

   site

   عنوان URL للموقع الإلكتروني بالتنسيق https://domain[:optional_port]، على سبيل المثال، https://www.example.com يجب أن يكون domain مؤهَّلاً بالكامل، ويجب حذف optional_port عند استخدام المنفذ 443 لبروتوكول HTTPS. لا يمكن أن يكون هدف site سوى نطاق جذر: لا يمكنك قصر ربط التطبيق على دليل فرعي معيّن. لا تُدرِج مسارًا في عنوان URL، مثل شرطة سفلية. لا تُعدّ النطاقات الفرعية متطابقة: أي إذا حدّدت domain على أنّه www.example.com، لن يكون النطاق www.counter.example.com مرتبطًا بتطبيقك.

   تحدِّد الحقول التالية تطبيق Android:

   مساحة الاسم	android_app
   package_name	اسم الحزمة المُعلَن عنه في بيان التطبيق على سبيل المثال، com.example.android
   sha256_cert_fingerprints	ملفات مرجعية SHA256 لـ شهادة توقيع تطبيقك

   ملاحظة مهمة: عند مشاركة بيانات الاعتماد بسلاسة بين موقع إلكتروني وأحد تطبيقات Android، نُدرِج بيانًا ذاتي الإشارة في ملف assetlinks.json للموقع الإلكتروني. يُعدّ ذلك ضروريًا لأنّ ملف بيان تطبيق Android يشير إلى هذا الملف أثناء خطوات الضبط اللاحقة لتفعيل مشاركة كلمة المرور.

2. استضِف ملف JSON الذي يحتوي على روابط تنقل إلى مواد عرض رقمية في الموقع التالي على نطاقات تسجيل الدخول: https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json ، حيث يكون DOMAIN مؤهَّلاً بالكامل، ويجب حذف OPTIONAL_PORT عند استخدام المنفذ 443 لبروتوكول HTTPS.

   ملاحظة: يجب عرض ملف JSON الذي يتضمّن روابط لمواد العرض الرقمية على أنّه Content-Type: application/json في رؤوس HTTP، ولا يمكن أن يكون إعادة توجيه (راجِع إنشاء قائمة بيانات).

3. حدِّد عملية الربط في تطبيق Android من خلال تضمين بيان فيملفres/values/strings.xml لتطبيق Android يرتبط بقائمة البيانات التي أنشأتها في الخطوة 1. أضِف عنصرًا يحدِّد ملفات assetlinks.json التي تريد تحميلها. على سبيل المثال:

     <string name="asset_statements" translatable="false">
   [{
     \"include\": \"https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json\"
   }]
   </string>
   

   استبدِل DOMAIN و OPTIONAL_PORT (يجب حذفهما عند استخدام المنفذ 443 لبروتوكول HTTPS)، على سبيل المثال https://www.example.com. استخدِم علامة الهروب "‎" مع أي علامات اقتباس وعلامات علامة الاقتباس المزدوجة تستخدمها في السلسلة.

   يمكنك أيضًا إضافة مقتطف JSON في ملف strings.xml كما هو موضّح في مستندات DALs، ولكن باستخدام بيان include، يمكنك تغيير العبارات بدون نشر إصدار جديد من تطبيقك.

4. يمكنك الإشارة إلى البيان في البيان عن طريق إضافة السطر التالي إلىملفAndroidManifest.xml التطبيق ضمن<application>:

   <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>
   

5. نشر الإصدار الجديد من تطبيق Android على Google Play Console

   ملاحظة مهمة: لن تسري ميزة "مشاركة بيانات الاعتماد بسلاسة" إلا بعد نشر إصدار جديد من تطبيق Android يتضمّن إشارة إلىملف assetlinks.json المستضاف على موقعك الإلكتروني.

بعد اتّباع هذه الخطوات، تكون قد أعددت بنجاح ميزة مشاركة بيانات الاعتماد بسلاسة بين موقعك الإلكتروني وتطبيق Android.

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