عملية التحقّق الكاملة من شفافية حِزم APK لخدمات نظام Google

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

عملية التحقّق من المعلنين

يتم تنفيذ سجلّ الشفافية باستخدام شجرة Merkle تتألف من تجزئات. تحتوي العقدة الطرفية على بيانات، وتحتوي العقدة الرئيسية على تجزئة العقد الفرعية.

يتم إجراء عمليتَي حساب على شجرة ميركل للتحقّق من خاصية سجلّات الشفافية التي تكشف عن التلاعب: إثبات التضمين وإثبات الاتساق. يُثبت الأول أنّ السجلّ يتضمّن إدخالاً يتوافق مع إصدار معيّن من حزمة APK. يتضمّن الإدخال في السجلّ تجزئة، وهي ملخّص SHA256 لرمز توقيع الرمز البرمجي على شكل رمز ويب مميّز بتنسيق JSON‏ (JWT)، ويمكن الحصول عليه من حِزم APK المقابلة. ويثبت هذا الأخير أنّه عند إضافة إدخالات جديدة إلى الشجرة، تكون نقطة التحقّق الجديدة متوافقة (من الناحية التشفيرية) مع الإصدار السابق من الشجرة.

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

إذا أردت التأكّد من أنّ ملف APK على جهازك يتوافق مع الادّعاء الوارد في نموذج المدّعي، يُرجى الرجوع إلى المقالة أدناه.

إثبات التضمين

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

كيفية التحقّق من تضمين ملف APK في السجلّ

كما ذكرنا سابقًا، يمكن العثور على قائمة حِزم APK المشمولة حاليًا في صفحة "نظرة عامة".

متطلبات الشهادة الأساسية

قبل المتابعة للتحقّق من أنّ العنصر (البرامج الثابتة أو حزمة APK) يتوافق مع الادّعاء، تأكَّد من توفّر الأدوات التالية على جهاز كمبيوتر متصل بالشبكة. وقد لا تحتاج إلى جميعها، وذلك حسب هدف التحقّق.

Golang

أداة التحقّق مكتوبة بلغة Go. لإنشائها، عليك تثبيت الإصدار 1.24 من Go أو إصدار أحدث من موقع Go الإلكتروني.

Android Debug Bridge (ADB)

‫ADB هي أداة تتواصل مع جهاز Android لفحص الصورة أو استخراج ملفات APK، وهي متاحة على الموقع الإلكتروني لأدوات نظام Android SDK.

أداة التحقّق من إثبات التضمين

أداة التحقّق من إثبات التضمين هي وحدة Go تطلب سجلّ الشفافية وتُخرج ما إذا كان العنصر مضمّنًا في السجلّ. ويتم نشرها في مستودع GitHub الخاص بـ android-binary-transparency على الرابط https://github.com/android/android-binary-transparency/tree/main

لإنشاء نسخة طبق الأصل من مستودع AOSP avb، اتّبِع الخطوات التالية:

computer:~$ git clone https://android.googlesource.com/platform/external/avb

لاستنساخ مستودع GitHub الخاص بـ android-binary-transparency:

computer:~$ git clone https://github.com/android/android-binary-transparency

أداة تجميع الموارد في Android‏ (AAPT2)

‫AAPT2 (أداة تجميع الموارد في Android) هي أداة إنشاء تُستخدَم لتجميع موارد تطبيق Android وحزمها. ويمكن العثور عليها كأداة مستقلة في أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android الإصدار 26.0.2 والإصدارات الأحدث.

bundletool

‫bundletool هي أداة تُستخدَم لإنشاء مجموعة حزمات تطبيق Android‏ (AAB). ويمكن استخدامها أيضًا للتحقّق من توقيعات رموز APK. ويمكن تنزيلها من GitHub.

wget أو curl

wget وcurl هما أداتان يمكن استخدامهما لاسترداد الملفات أو تنزيلها من الإنترنت. تأكَّد من تثبيت أي من هاتين الأداتين، لأنّ نصوص التحقّق البرمجية قد تعتمد عليهما.

Avbtool

يتم استخدام avbtool لاحتساب ملخّص VBMeta لنسخ برامج الجهة المصنِّعة والتحقّق من الملفات الثنائية. بعد استنساخ مستودع avb (كما هو موضّح في قسم "أداة التحقّق من إثبات التضمين")، يمكن العثور على avbtool.py ضمن دليل avb المستنسَخ. يجب إضافة هذا الدليل إلى متغيّر البيئة $PATH.

computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL

Fbpacktool

fbpacktool هو نص برمجي بلغة Python يُستخدَم لفك حزم المكوّنات الفردية في ملف bootloader.img لهواتف Pixel. ولن تحتاج إلى ذلك إذا كنت تتحقّق من ملفات APK. هذه الأداة مهمة لأنّها تتيح لـ "avbtool.py" العثور على الصور المطلوبة لإثبات الملكية.

يتطلّب fbpacktool الإصدار 3.6 من Python أو إصدارًا أحدث وحزمة PyYAML (على سبيل المثال، python3 -m pip install pyyaml).

لاستخدام هذه الأداة، عليك تنزيل نصوص Python البرمجية الستة التالية في الدليل الذي يتضمّن avbtool.py، وجعل fbpacktool.py قابلاً للتنفيذ، وإنشاء رابط رمزي باسم fbpacktool إلى fbpacktool.py لتسهيل الاستخدام.

إذا كان لديك wget:

computer:dir_to_avbtool$ wget https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpacktool.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpack.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/packedstruct.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlparser.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlserializer.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/yamlparser.py
computer:dir_to_avbtool$ chmod +x fbpacktool.py
computer:dir_to_avbtool$ ln -s fbpacktool.py fbpacktool

إذا كان لديك curl:

computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpacktool.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpack.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/packedstruct.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlparser.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlserializer.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/yamlparser.py
computer:dir_to_avbtool$ chmod +x fbpacktool.py
computer:dir_to_avbtool$ ln -s fbpacktool.py fbpacktool

OpenSSL

تساعد أداة openssl في تنفيذ عمليات تشفير مختلفة باستخدام الوحدة الطرفية في سير عمل التحقّق. تأكَّد من تثبيته على نظامك. يمكنك التحقّق من ذلك في الوحدة الطرفية من خلال تنفيذ الأمر التالي والتأكّد من أنّ النتيجة التي تم عرضها ليست فارغة:

computer:~$ which openssl
/usr/bin/openssl

إنشاء حمولة للتحقّق

للتأكّد من أنّ حزمة APK التي استخرجتها من جهازك تتوافق مع ادّعاءاتنا، عليك إنشاء حمولة سجلّ من المعلومات المستمَدة من حزمة APK.

قبل البدء، تأكَّد من إمكانية استخدام adb على جهازك من خلال تفعيل تصحيح أخطاء adb على جهازك.

بعد ذلك، ابحث عن مكان تثبيت ملف APK على جهازك. لأغراض هذا الدليل، سنستخدم حزمة APK لتطبيق Android System Key Verifier (com.google.android.contactkeys) كمثال عملي.

computer:~$ adb shell pm list packages -f | grep contactkeys
package:/data/app/~~i5WYSO4PuAAv798-eHdM7A==/com.google.android.contactkeys-PQCKjnn7xDqjeVhcUDibBA==/base.apk=com.google.android.contactkeys

إذا كان ملف APK الخاص بـ "Android System Key Verifier" مثبّتًا على جهازك، سيعرض الأمر أعلاه مسارًا يشير إلى مكان تثبيته على جهازك. وإلا، لن تظهر أي نتائج.

بعد ذلك، نزِّل ملف APK من جهاز Android على الكمبيوتر الذي تعمل عليه باستخدام هذا الأمر (يُرجى العِلم أنّ الموقع الفعلي واسم ملف APK على جهازك قد يختلفان):

computer:~$ mkdir -p /tmp/testdir && cd /tmp/testdir
computer:/tmp/testdir$ adb pull /data/app/~~i5WYSO4PuAAv798-eHdM7A==/com.google.android.contactkeys-PQCKjnn7xDqjeVhcUDibBA==/base.apk ./contactkeys_candidate.apk

للحصول على اسم حزمة APK التي نزّلتها للتو والتحقّق منه، عليك أولاً فك ضغط حزمة APK، لأنّها في النهاية نوع خاص من ملفات ZIP.

computer:/tmp/testdir$ mkdir extracted && unzip contactkeys_candidate.apk -d extracted/

تؤدي هذه الخطوة إلى فك حزمة جميع الملفات التي يتألف منها ملف APK. يمكن العثور على اسم الحزمة وإصدارها في ملف البيان الخاص بحزمة APK، والذي يكون عادةً في ملف باسم AndroidManifest.xml.

ومع ذلك، فإنّ ملف البيان الذي تم الحصول عليه يكون بتنسيق ثنائي، وهو غير قابل للقراءة من قِبل المستخدمين العاديين. لتحويل ملف XML الثنائي إلى تنسيق يمكن لشخص عادي قراءته، نستخدم أداة aapt2 التي تم تثبيتها سابقًا (كما هو مطلوب في قسم المتطلبات الأساسية).

computer:/tmp/testdir$ aapt2 dump badging ./contactkeys_candidate.apk
package: name='com.google.android.contactkeys' versionCode='7805' versionName='1.219.791156583' platformBuildVersionName='Baklava' platformBuildVersionCode='36' compileSdkVersion='36' compileSdkVersionCodename='Baklava'

من الناتج أعلاه، يمكننا الآن التأكّد من أنّ اسم حزمة APK هذه هو com.google.android.contactkeys ورقم الإصدار (versionCode) هو 1413.

سنبحث الآن عن توقيع شفافية الرمز داخل حزمة APK. يجب أن يكون ملفًا باسم code_transparency_signed.jwt ضمن المجلد META-INF بين الملفات الأخرى المستخرَجة من حزمة APK.

computer:/tmp/testdir$ sha256sum extracted/META-INF/code_transparency_signed.jwt
1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11  code_transparency_signed.jwt

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

1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11
SHA256(Signed Code Transparency JWT)
com.google.android.contactkeys
1143

لاحظ أيضًا حرف السطر الجديد بعد إصدار الحزمة.

يمكنك حفظ المحتوى في ملف، مثل payload.txt. سيكون هذا مفيدًا عند إجراء اختبار إثبات التضمين لاحقًا.

التحقّق من صحة توقيع رمز APK

الآن، علينا التحقّق من صحة رمز توقيع الرمز البرمجي المضمَّن في حزمة APK. لإجراء ذلك، نستخدم bundletool والمفتاح العام لمفتاحَي التشفير اللذين تم استخدامهما لتوقيعه في المقام الأول. ويتم نشرها ضمن كل قسم من حِزم APK المعنيّة. بافتراض أنّك حفظت شهادة المفتاح العام (على سبيل المثال، لخدمة Android System Key Verifier) في ملف باسم signing_cert_pubkey.pem، يُرجى اتّباع الدليل أدناه لإجراء عملية التحقّق من توقيع الرمز.

أولاً، عليك إنشاء أرشيف ZIP وإضافة حزمة APK المرشحة إلى أرشيف ZIP.

computer:/tmp/testdir$ zip -u test.zip contactkeys_candidate.apk
        zip warning: test.zip not found or empty
  adding: contactkeys_candidate.apk (deflated 58%)

computer:/tmp/testdir$ file test.zip
test.zip: Zip archive data, at least v2.0 to extract, compression method=deflate

نحن الآن جاهزون لاستخدام الأمر check-transparency في bundletool للتحقّق مما إذا كان توقيع الرمز المضمّن في حزمة APK المرشحة يتطابق مع التوقيع المنشور.

computer:/tmp/testdir$ java -jar BUNDLETOOL_INSTALL_PATH/bundletool-all-version.jar check-transparency \
  --mode=apk \
  --apk-zip=test.zip \
  --transparency-key-certificate=signing_cert_pubkey.pem

APK signature is valid. SHA-256 fingerprint of the apk signing key certificate (must be compared with the developer's public key manually): D9 E1 73 5B 2A 39 51 27 3A 87 35 B7 66 9E F1 9E F5 3A F1 C1 27 5C BA 31 39 3C 18 40 8B 03 79 D0
Code transparency signature verified for the provided code transparency key certificate.
Code transparency verified: code related file contents match the code transparency file.

يجب التأكّد من أنّ ناتج الأمر أعلاه يشير إلى أنّه تم التحقّق من كل من توقيع شفافية الرمز وشفافية الرمز. إذا لم تكن كذلك، على سبيل المثال، إذا كنت ترى مخرجات مثل Code transparency verification failed because the provided public key certificate does not match the transparency file، فهذا يعني أنّ سلامة رمز حزمة APK المعنيّ قد تكون معرّضة للخطر ويجب عدم الوثوق بحزمة APK. يُرجى التحقّق جيدًا من أنّك تتحقّق من صحتها باستخدام شهادة المفتاح العام الصحيحة. بخلاف ذلك، إذا كان كل شيء آخر صحيحًا، فهذا يعني أنّه تم التحقّق من صحة توقيع الرمز لحزمة APK التي يتم التحقّق منها.

التحقّق من تضمين الحزمة (إثبات التضمين)

باستخدام الحمولة التي أنشأتها سابقًا، أنت الآن جاهز لاختبار ما إذا تم تضمين الحزمة المعنيّة في سجلّ الشفافية.

تم نشر أداة إثبات التضمين في مستودع avb ضمن مشروع مفتوح المصدر لنظام Android. لتشغيلها:

computer:external/avb/tools/transparency/verify$ PAYLOAD_PATH=PATH_TO_PAYLOAD_DIR/payload.txt
computer:external/avb/tools/transparency/verify$ go build cmd/verifier/verifier.go
computer:external/avb/tools/transparency/verify$ ./verifier --payload_path=${PAYLOAD_PATH} --log_type=google_1p_code

تستخدم جهة التحقّق نقطة التحقّق المقابلة ومحتوى السجلّ (الموجود في دليل المربّعات) للتأكّد من أنّ حمولة APK موجودة في سجلّ الشفافية، ما يثبت أنّها منشورة من قِبل Google.

تتم كتابة مخرجات الأمر في stdout:

  • OK. inclusion check success! إذا كان رمز الحزمة مضمّنًا في السجلّ
  • FAILURE إذا لم يكن كذلك.