درستی‌سنجی کامل شفافیت APK خدمات سیستم Google

این صفحه روش‌های مختلفی را برای اطمینان از اینکه APK نصب‌شده در دستگاه Android شما با ادعای مطرح‌شده در مدل مدعی مطابقت دارد، شرح می‌دهد. این کار شامل استخراج APK موردنظر از دستگاهتان، بررسی تمامیت کد آن، و انجام اثبات گنجاندن گزارش روی مصنوع استخراج‌شده است.

فرایند درستی‌سنجی

گزارش شفاف‌سازی با درخت مرکل متشکل از درهم‌سازها پیاده‌سازی می‌شود. گره برگ حاوی داده است و گره والد حاوی درهم‌سازی فرزندانش است.

اساساً، دو محاسبه روی درخت مرکل انجام می‌شود تا ویژگی دستکاری‌نمای گزارش‌های شفافیت تأیید شود: اثبات گنجاندن و اثبات سازگاری. مورد اول ثابت می‌کند که گزارش حاوی ورودی‌ای است که با نسخه APK خاصی مطابقت دارد. ورودی گزارش شامل درهم‌سازی است که خلاصه SHA256 از کد نشانه امضا به‌شکل JSON Web Token (JWT) است که می‌توان آن را از فایل‌های APK مربوطه دریافت کرد. مورد دوم ثابت می‌کند که وقتی ورودی‌های جدید به درخت اضافه می‌شود، نقطه بازرسی جدید (ازنظر رمزنگاری) با نسخه قبلی درخت سازگار است.

برای درستی‌سنجی APK تحت پوشش، آزمایش اثبات گنجاندن را براساس نقطه بازرسی شاهد انجام دهید. توجه داشته باشید که قصد داریم این گزارش را بااستفاده از پروتکل گواه استانداردشده با شبکه گواه عمومی ادغام کنیم. این کار یک نقطه بازرسی گواهی‌شده ارائه می‌دهد که سازگاری گزارش را تضمین می‌کند.

اگر می‌خواهید مطمئن شوید که APK موجود در دستگاهتان با ادعای مطرح‌شده در مدل مدعی مطابقت دارد، به گزارش زیر مراجعه کنید.

گواه دربرگیری

کاربر Android می‌تواند با استخراج کردن APK و فراداده مربوط به آن و سپس مقایسه کردن درهم‌سازی ریشه بازمحاسبه‌شده با درهم‌سازی ریشه موجود در نقطه بازرسی منتشرشده، بررسی کند که APK تحت‌پوشش در دستگاهش در گزارش وجود دارد یا نه. اگر مطابقت داشته باشند، کاربر Android می‌تواند از برخی‌از محافظت‌های شرح‌داده‌شده در «مدل تهدید» مطمئن باشد.

نحوه درستی‌سنجی گنجاندن APK در گزارش

همان‌طور که قبلاً توضیح داده شد، فهرست فایل‌های APK که درحال‌حاضر تحت پوشش هستند را می‌توانید در صفحه نمای کلی پیدا کنید.

پیش‌نیازهای تأیید

قبل‌از ادامه دادن برای درستی‌سنجی اینکه آرتیفکت (سفت‌افزار یا APK) مطابق با ادعا است، مطمئن شوید که ابزارهای زیر در رایانه متصل به شبکه دردسترس است. بسته به هدف درستی‌سنجی، ممکن است به همه آن‌ها نیاز نداشته باشید.

Golang

ابزار درستی‌سنجی به زبان Go نوشته شده است. برای ساختن آن، Go نسخه ۱.۲۴ یا جدیدتر را از سایت Go نصب کنید.

پل اشکال‌زدایی Android‏ (ADB)

ADB ابزاری است که با دستگاه Android ارتباط برقرار می‌کند تا تصویر را بررسی کند یا فایل‌های APK را استخراج کند، این ابزار در وب‌سایت «ابزارهای پلاتفرم کیت توسعه نرم‌افزار Android» دردسترس است.

درستی‌سنجی‌کننده «اثبات گنجاندن»

درستی‌سنج اثبات گنجاندن یک ماژول 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 استفاده می‌شود. این ابزار را می‌توانید به‌عنوان ابزاری مستقل در ابزارهای ساخت کیت توسعه نرم‌افزار Android نسخه ۲۶.۰.۲ و بالاتر پیدا کنید.

bundletool

bundletool ابزاری است که برای ساختن Android App Bundle‏ (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 به Python 3.6 یا جدیدتر و بسته PyYAML نیاز دارد (برای مثال، python3 -m pip install pyyaml).

برای استفاده از این ابزار، باید شش اسکریپت پایتون زیر را در دایرکتوری‌ای که 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 (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» در دستگاهتان نصب شده باشد، فرمان بالا مسیری را برمی‌گرداند که نشان می‌دهد این APK در کجای دستگاهتان نصب شده است. درغیراین‌صورت، هیچ خروجی‌ای نخواهید دید.

سپس، 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 را از حالت فشرده خارج کنید، زیرا 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) در فایلی با نام 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 منتشر شده است.

خروجی فرمان در خروجی استاندارد نوشته می‌شود:

  • OK. inclusion check success! اگر کد بسته در گزارش گنجانده شده باشد،
  • FAILURE اگر این‌طور نیست.