استخدام ميزة "توقيع التطبيق" من Play

من خلال ميزة "توقيع التطبيق" من Google Play، تدير Google مفتاح توقيع تطبيقك وتحميه ضمن البنية الأساسية الآمنة نفسها التي تستخدمها Google لتخزين مفاتيحها. وتتم حماية هذه المفاتيح من خلال "خدمة إدارة المفاتيح" (KMS) من Google. لمزيد من المعلومات حول هذه البنية الأساسية الرائدة في المجال، يمكنك الاطّلاع على التقرير الموجز حول الأمان في Google Cloud.

 

ما أهمية ميزة "توقيع التطبيق" من Google Play؟ بالإضافة إلى حماية مفاتيحك من الفقدان الدائم أو الاختراق، يتيح لك التسجيل في ميزة "توقيع التطبيق" من Google Play الاستفادة من التحسينات على "مجموعة حزمات تطبيق Android" ‏(.aab). ومن خلال السماح لـ Google بتوقيع حِزم APK المحسَّنة للتوزيع التي تم إنشاؤها من حِزم تطبيقك، يمكنك الاستفادة من خدمات قيّمة، مثل الحماية التلقائية والترجمة التلقائية لنصوص التطبيق باستخدام نماذج Gemini. تستفيد الألعاب من خدمات تلقائية إضافية، مثل Sidekick في "ألعاب Play" واللعب أثناء تنزيل اللعبة والفترات التجريبية المجانية للألعاب المدفوعة.

لإعداد ميزة "توقيع التطبيق" من Google Play، يجب أن تكون صاحب الحساب أو أن يكون لديك إذن إصدار التطبيق في قناة الإصدار العلني واستبعاد الأجهزة واستخدام ميزة "توقيع التطبيق" من Google Play، كما يجب الموافقة على بنود الخدمة.

المفاهيم الأساسية

عند استخدام ميزة "توقيع التطبيق" من Google Play، ستتعامل مع مفتاحَين مختلفَين. ومن المهم أن تفهم الفرق بينهما، وبين تنسيقاتهما التقنية، لتجنُّب مشاكل المصادقة مع واجهات برمجة التطبيقات التابعة لجهات خارجية.

نوع المفتاح	من الجهة المسؤولة عنه؟	التفاصيل التقنية والغرض
مفتاح التحميل	أنت (يجب الاحتفاظ به في مكان آمن)	التنسيق: يتم تخزينه في ملف تخزين مفاتيح Java (‎.jks أو ‎.keystore). المتطلبات: يجب أن يكون مفتاح RSA بحجم 2048 بت أو أكثر. الغرض: يمكنك استخدام هذا المفتاح لتوقيع حِزمة تطبيقك قبل تحميلها إلى Play Console. تستخدم Google هذا المفتاح للتحقق من هويتك، وفي حال فقدان هذا المفتاح أو تعرضه للاختراق، بإمكان Google إعادة ضبطه نيابةً عنك.
مفتاح توقيع التطبيق	Google Play	التنسيق: مرتبط بشهادة عامة (‎.der أو ‎.pem). المتطلبات: أن تكون المفاتيح التي تنشئها Google هي مفاتيح RSA بحجم 4096 بت. ويجب أن تكون المفاتيح المخصّصة من النوع RSA بحجم 2048 بت أو أعلى. الغرض: تستخدم Google هذا المفتاح لتوقيع حِزم APK النهائية التي يتم تسليمها إلى أجهزة المستخدمين. يمكنك أن تطلب من Google إنشاءه أو يمكنك تقديم مفتاحك الخاص. لا يمكن إعادة ضبط هذا المفتاح في حال فقدانه إذا كنت تديره بنفسك (بدون ميزة "توقيع التطبيق" من Google Play).
مقاوم لهجمات كمبيوتر الكم	Google Play	التنسيق: مفتاحان مرتبطان بشهادات عامة (‎.der أو ‎.pem). المتطلبات: يجمع نظام التوقيع المختلط المقاوم لهجمات كمبيوتر الكم بين مفتاح RSA 4096-bit كلاسيكي ومفتاح ML-DSA-65 ما بعد التشفير الكمّي. تنشئ Google مفتاحًا كلاسيكيًا جديدًا للتوقيع المختلط يختلف عن المفتاح الكلاسيكي الذي تستخدمه للأجهزة التي تعمل بإصدارات Android الأقدم من 17، ما يؤدي إلى استخدام تطبيقك لثلاثة مفاتيح مميزة. الغرض: تتحقّق أجهزة Android 17 والإصدارات الأحدث من التطبيق باستخدام حزمة التوقيع المختلط 3.2 لحمايته من هجمات الحوسبة الكمية المستقبلية. تواصل الأجهزة التي تعمل بإصدارات Android القديمة التحقّق من التطبيق باستخدام حِزَم التوقيع الكلاسيكي.

ملاحظة: لضمان أقصى درجات الأمان، يجب أن يختلف مفتاح التحميل عن مفتاح توقيع التطبيق.

آلية توقيع Google لتطبيقك: عندما تنشئ Google حِزم APK وتوقّعها باستخدام مفتاح توقيع التطبيق، فإنها تستخدم أداة apksigner لإضافة طابعَين إلى بيان تطبيقك (com.android.stamp.source وcom.android.stamp.type). يضمن هذان الطابعان إمكانية تتبُّع حِزم APK بشكل آمن وصولاَ إلى الموقِّع الأصلي.

إعداد ميزة "توقيع التطبيق" من Google Play

تختلف خطوات عملية الإعداد بناءً على ما إذا كنت بصدد نشر تطبيق جديد أو نقل تطبيق حالي.

للتطبيقات الجديدة

1. إنشاء تطبيق جديد: سيتم تلقائيًا تسجيل تطبيقك في عملية التوقيع المختلط المقاوم لهجمات كمبيوتر الكم، وذلك باستخدام مفاتيح من إنشاء Google. ننشئ أيضًا مفتاحًا كلاسيكيًا منفصلاً لاستخدامه في حِزَم التوقيع التي يتم التعرّف عليها على الأجهزة التي تعمل بنظام التشغيل Android 16 والإصدارات الأقدم. 
2. إنشاء مفتاح تحميل: عليك إنشاء ملف تخزين مفاتيح لتتمكن من توقيع حِزمة تطبيق الإصدار الخاصة بك. يمكنك إنشاؤه مباشرةً في "استوديو Android" أو استخدام أداة Java keytool من سطر الأوامر.
3. تحميل حِزمة تطبيقك: انتقِل إلى Play Console وابدأ بتجهيز إصدار جديد. عند تحميل حِزمة تطبيقك، يتم تلقائيًا تسجيل تطبيقك في عملية التوقيع المختلط المقاوم لهجمات كمبيوتر الكم، وذلك باستخدام مفاتيح من إنشاء Google.
4. تغيير مفتاح توقيع تطبيقك (اختياري): يمكن للمطوّرين المتمرسين الذين يريدون إدارة مفاتيحهم الخاصة تغيير هذا الإعداد التلقائي. ويمكنك إجراء ذلك من خلال النقر على تغيير مفتاح التوقيع في قسم "سلامة التطبيق" من إصدارك، أو من خلال الانتقال إلى محمي من خلال Google Play > الحماية في "متجر Play" > إدارة ميزة "توقيع التطبيق" من Google Play. سيكون بإمكانك بعد ذلك اختيار:

• استخدام المفتاح نفسه كتطبيق آخر في حساب المطوّر هذا
• تقديم نسخة من مفتاح توقيع تطبيقك (باتّباع التعليمات)
   

للتطبيقات الحالية

إذا كنت تدير مفاتيحك الخاصة وتحمّل حِزم APK حاليًا، يمكنك الترقية إلى ميزة "توقيع التطبيق" من Google Play للاستفادة من حِزم التطبيقات وتحسينات Google Play.

1. انتقِل إلى محمي من خلال Google Play > الحماية في "متجر Play" > الانتقال إلى ميزة "توقيع التطبيق" من Google Play في Play Console.
2. اقبَل بنود الخدمة إذا لم يسبق لك إجراء ذلك.
3. انقل نسخة من مفتاحك الأصلي: نزِّل أداة PEPK واتّبِع التعليمات المفصّلة الموحّدة لتشفير مفتاح توقيع التطبيق الحالي وتحميله من أي مستودع.

إنشاء مفتاح تحميل جديد (إجراء يُنصح به): بادر بإنشاء مفتاح جديد في "استوديو Android" لاستخدامه كمفتاح تحميل خاص بك من الآن فصاعدًا، ثم سجِّل شهادته في Play Console.

التسجيل لدى موفّري واجهة برمجة التطبيقات

إذا كان تطبيقك يستخدم واجهات برمجة تطبيقات (مثل "خرائط Google" أو OAuth أو "تسجيل الدخول باستخدام Facebook")، ستصادق هذه الخدمات على تطبيقك باستخدام بصمة مفتاح توقيع التطبيق.

بما أنّ Google توقّع حزمة APK النهائية، عليك تسجيل بصمة مفتاح توقيع التطبيق الذي تحتفظ به Google لدى موفّري واجهة برمجة التطبيقات، وليس مفتاح التحميل المحلي فقط.

1. انتقِل إلى محمي من خلال Google Play > التوزيع على "متجر Play" > الانتقال إلى ميزة "توقيع التطبيق" من Google Play.
2. انتقِل إلى قسم مفتاح توقيع التطبيق.
3. انسخ البصمات المطلوبة (SHA-1 أو SHA-256). إذا كان تطبيقك يستخدم التوقيع المختلط المقاوم لهجمات كمبيوتر الكم، عليك نسخ البصمات لثلاثة مفاتيح وتسجيل كل منها لدى موفّري واجهات برمجة التطبيقات: مفتاحا التوقيع الكلاسيكي والتوقيع المقاوم لكمبيوتر الكم الجديدان المستخدَمان على الأجهزة الأحدث، ومفتاح التوقيع الكلاسيكي المستخدَم على الأجهزة القديمة.
4. الصِق هذه البصمات في وحدة تحكّم موفّر واجهة برمجة التطبيقات (مثل Google Cloud Console).
   ملاحظة: عدِّل ملف assetlinks.json باستخدام هذه البصمات إذا كنت تستخدم ميزة Android App Links.

إدارة مفاتيحك

ترقية مفتاح توقيع التطبيق

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

آلية فرض القيود على مستوى إصدارات Android:

• الإصدار Android T (المستوى 33 من واجهة برمجة التطبيقات) والإصدارات الأحدث: يفرض نظام Android الأساسي بشكل صارم استخدام المفتاح الذي تمت ترقيته.
• الإصدارات من Android N (المستوى 24 من واجهة برمجة التطبيقات) إلى Android S (المستوى 32 من واجهة برمجة التطبيقات): لا يفرض نظام Android الأساسي استخدام المفتاح الذي تمت ترقيته وسيظلّ معترفًا بمفتاح التوقيع القديم. ومع ذلك، توفّر ميزة Google Play للحماية طبقة إضافية من الأمان عبر التحقّق من توقيع تحديثات التطبيق باستخدام مفتاحك الذي تمت ترقيته (ما لم يوقِف المستخدم هذه الميزة).

اعتبارات مهمّة:

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

كيفية الترقية:

1. انتقِل إلى محمي من خلال Google Play > التوزيع على "متجر Play" > الانتقال إلى ميزة "توقيع التطبيق" من Google Play.
2. ضمن قسم "مفتاح توقيع التطبيق"، انقر على ترقية المفتاح.
3. اختَر مسار الترقية:
   • السماح لمتجر Google Play بإنشاء مفتاح توقيع تطبيق جديد (مستحسَن)
   • استخدام مفتاح توقيع التطبيق نفسه المستخدَم مع تطبيق آخر في حساب المطوِّر هذا
   • تقديم نسخة من مفتاح توقيع تطبيقك (باتّباع التعليمات)
4. انقر على حفظ وسجِّل بصمات المفاتيح الجديدة لدى موفّري واجهة برمجة التطبيقات.

طلب إعادة ضبط مفتاح التحميل

إذا فقدت مفتاح التحميل أو كنت تشتبه في تعرّضه للاختراق، لن يتم حظرك من الوصول إلى تطبيقك.

1. أنشئ مفتاح تحميل جديدًا في "استوديو Android".
2. صدِّر الشهادة بتنسيق PEM:
   keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
   (لتلقي المزيد من المساعدة بشأن أداة keytool ومسارات ملف تخزين المفاتيح، يُرجى الرجوع إلى دليل توقيع التطبيق في "استوديو Android").
3. بعد إنشاء ملف PEM، أرسِل طلب إعادة الضبط في Play Console.
4. انتقِل إلى محمي من خلال Google Play > الحماية على "متجر Play" > إدارة ميزة "توقيع التطبيق" من Google Play.
5. في قسم شهادة مفتاح التحميل، انقر على طلب إعادة ضبط مفتاح التحميل.
6. أدخِل سبب إعادة الضبط.
7. حمِّل ملف upload_certificate.pem وانقر على طلب.

أفضل الممارسات وطرق التوزيع البديلة

• الأمان: يمكنك حماية إذن الوصول إلى Play Console من خلال فرض ميزة "التحقّق بخطوتين" على جميع المستخدمين.
• تحسينات Google Play: يتيح لك التسجيل في ميزة "توقيع التطبيق" من Google Play الاستفادة من تحسينات Google Play لحِزم تطبيقاتك. لتلقّي التحديثات، عليك أولاً إجراء أي تغييرات ضرورية عند إنشاء إصدار جديد، ثم ثانيًا تحميل حِزمة التطبيق الجديدة.
• التوزيع خارج Google Play: إذا كنت توزّع تطبيقك من خلال متاجر تطبيقات أخرى وأردت استخدام مفتاح التوقيع نفسه في كل مكان، لديك خياران. [1] يمكنك السماح لـ Google بإنشاء مفتاح توقيع التطبيق وتنزيل حزمة APK عالمية موقَّعة من Play Console أو واجهة Google Play Developer API لتوزيعها في مكان آخر (في واجهة Google Play Developer API، انتقِل إلى "الاختبار والإصدار" > أحدث الإصدارات والحِزم، واختَر حِزمة تطبيقك، ثم انقر على علامة التبويب "عمليات التنزيل")، أو [2] يمكنك إنشاء مفتاح توقيع التطبيق الذي تريد استخدامه في جميع متاجر التطبيقات ونقل نسخة منه إلى Google عند إعداد ميزة "توقيع التطبيق" من Google Play. تعرّف على مزيد من المعلومات حول طريقة عمل تحديثات التطبيقات وخيارات تفعيل التحديثات على مستوى متاجر متعددة أو إيقافها.
• الاختبار: استخدِم ميزة مشاركة التطبيقات مع الفريق الداخلي لاختبار ما سيوفّره Google Play للمستخدمين بالضبط، أو نزِّل حِزم APK مخصّصة للجهاز من "مستكشف حِزم التطبيقات" وثبِّتها محليًا باستخدام الأمر adb install-multiple *.apk.
• الإصدار 4 من مخطّط توقيع حِزم APK: تستخدم ميزة "توقيع التطبيق" من Google Play تلقائيًا توقيع الإصدار 4 للتطبيقات المؤهَّلة من أجل إتاحة التوزيع المحسَّن على أجهزة Android 11 والإصدارات الأحدث. ما مِن إجراء مطلوب اتّخاذه من جانبك. ويستثني ذلك جميع التطبيقات التي تستخدم نظام التوقيع المختلط المقاوم لهجمات كمبيوتر الكم، والذي لا يتوافق بعد مع الإصدار 4 من نظام التوقيع. يمكنك الاطّلاع على مزيد من المعلومات حول المزايا التقنية في مستندات الإصدار 4 من مخطّط توقيع حزمة APK.
• مشاريع Google Cloud المستضافة ذاتيًا: إذا كانت لديك متطلبات أمان محدّدة للغاية (مثل استخدام مفاتيح الشركة المصنّعة للجهاز الأصلي)، يمكنك استخدام واجهة Google Play Developer API للتسجيل في ميزة "توقيع التطبيق" من Google Play من خلال مشروع Google Cloud مستضاف ذاتيًا. ملاحظة: هذا إعداد غير عادي ولا ننصح به. إنّ اختيارك لمشروع مستضاف ذاتيًا يضع على عاتقك المسؤولية الكاملة عن جميع عمليات توقيع التطبيق، كما أنّه يحرمك من ميزات Google Play الحيوية، وأبرزها القدرة على "التعافي من الكوارث".