صفحه جزئیات فنی شفاف‌سازی باینری Pixel

«گزارش شفافیت دودویی Pixel» از فناوری گزارش شفافیت بهره می‌برد.

کاربرد گزارش‌های شفافیت با شفافیت گواهینامه اثبات شده است، یک پروتکل اینترنتی که «مرجع گواهینامه» را ملزم می‌کند گواهینامه‌هایی را که صادر می‌کند در گزارش‌های عمومی «شفافیت گواهینامه» منتشر کند. این فرایند صدور اشتباه گواهینامه‌ها را به‌میزان زیادی کاهش داده است و درنتیجه امنیت اینترنت را افزایش داده است. بسیاری از اپراتورهای گزارش «شفافیت گواهینامه» به پیاده‌سازی گزارش‌های شفاف‌سازی موجود در transparency.dev متکی هستند.

گزارش‌های شفاف‌سازی با درخت‌های مرکل پیاده‌سازی می‌شوند. این صفحه فرض می‌کند که شما با درخت‌های مرکل و شفافیت دودویی آشنایی کلی دارید. برای نمای کلی درخت‌های Merkle، به ساختارهای داده قابل‌تأیید و برای نمای کلی شفافیت دودویی به صفحه مقصد مراجعه کنید.

پیاده‌سازی گزارش

«گزارش شفافیت دودویی Pixel» به‌عنوان درخت مرکل مبتنی بر کاشی پیاده‌سازی شده است. ریشه محتوای کاشی در https://developers.google.com/android/binary_transparency/tile ارائه می‌شود. توجه: این یک صفحه وب معمولی نیست؛ ورودی‌های گزارش موجود در زیرفهرست‌های راهنمای آن باید به‌صورت برنامه‌نویسی‌شده با Golang SumDB کتابخانه TLog خوانده شود و نه ازطریق مرورگر.

برای شرح محتوای ورودی‌ها، به محتوای گزارش مراجعه کنید.

درهم‌سازی ریشه درخت مرکل از یک گزارش، که در یک نقطه بازرسی قرار دارد، در https://developers.google.com/android/binary_transparency/checkpoint.txt ارائه می‌شود. در قالب ایست بازرسی ارائه می‌شود. برگ‌های این درخت Merkle در https://developers.google.com/android/binary_transparency/image_info.txt ارائه می‌شود. امضای ایست بازرسی را می‌توان با کلید عمومی زیر درستی‌سنجی کرد:

-----BEGIN CERTIFICATE-----
MIICPDCCAeOgAwIBAgIVAPooxISw/nFF/dPwmCUaV36Z4s3hMAoGCCqGSM49BAMCMHQxCzAJBgNV
BAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYD
VQQKEwtHb29nbGUgSW5jLjEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDAgFw0y
MTA3MTkyMjQxNDFaGA8yMDUxMDcxOTIyNDE0MVowdDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNh
bGlmb3JuaWExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC0dvb2dsZSBJbmMuMRAw
DgYDVQQLEwdBbmRyb2lkMRAwDgYDVQQDEwdBbmRyb2lkMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcD
QgAEU83uXNUiTYE53c2TfdWmqpW20bBXy4KEf5Ff8dV8GLKlVAXKHyjw3Lp9J3E0yCRJ/39XKeuA
AMF7KzSvhD248KNQME4wDAYDVR0TBAUwAwEB/zAdBgNVHQ4EFgQUHRpvuNkzjtBY213BWgUyWWHm
3VYwHwYDVR0jBBgwFoAUHRpvuNkzjtBY213BWgUyWWHm3VYwCgYIKoZIzj0EAwIDRwAwRAIgZsZb
CNBXRkCKLS+LG/41VWj1cTszt9QCdJQNuy7aT94CIDPgn7v5b1ykBVUTuLgRSofxAzHg9R4dg1oA
7tTFAuDg
-----END CERTIFICATE-----

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

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

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

دو محاسبه روی درخت Merkle انجام می‌شود تا ویژگی ضد دستکاری گزارش‌های شفاف‌سازی تأیید شود: اثبات گنجاندن و اثبات سازگاری. مورد اول ثابت می‌کند که گزارش شامل ورودی مربوط به نسخه تصویر است. ورودی گزارش شامل خلاصه VBMeta است، درهم‌سازی که تصاویر سیستم‌عامل را نشان می‌دهد و می‌تواند از دستگاه برگردانده شود. مورد دوم ثابت می‌کند که وقتی ورودی‌های جدید به درخت اضافه می‌شود، ایست بازرسی جدید با نسخه قبلی درخت سازگار است.

برای درستی‌سنجی تصویر Pixel، اثبات گنجاندن را انجام دهید. انجام محاسبات اثبات سازگاری اختیاری است، زیرا اشخاص ثالث به‌طور مداوم این کار را انجام می‌دهند.

اگر می‌خواهید با مفاهیم درستی‌سنجی در «شفافیت باینری» Pixel آشنا شوید، می‌توانید با دنبال کردن دستورالعمل‌های زیر از تصویر درحال اجرا در دستگاه Pixel خود استفاده کنید. اگر می‌خواهید سفت‌افزار Pixel را با بالاترین درجه اطمینان اجرا کنید، فرایند درستی‌سنجی را در درستی‌سنجی کامل شفافیت دودویی Pixel ببینید.

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

قبل‌از ادامه دادن برای درستی‌سنجی اینکه آرتیفکت (سفت‌افزار یا 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

برای شبیه‌سازی مخزن android-binary-transparency GitHub:

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

ابزار بسته‌بندی دارایی Android‏ (AAPT2)

‫AAPT2 (ابزار بسته‌بندی دارایی Android) ابزار ساختی است که برای کامپایل و بسته‌بندی منابع برنامه Android استفاده می‌شود. این ابزار را می‌توانید به‌عنوان ابزاری مستقل در ابزارهای ساخت کیت توسعه نرم‌افزار Android نسخه ۲۶.۰.۲ و بالاتر پیدا کنید.

دسته‌ابزار

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

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

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

برای بررسی اینکه تصویر در دستگاه Pixel در گزارش شفافیت وجود دارد یا نه، با adb به دستگاه متصل شوید، سپس فرمان‌های زیر را اجرا کنید:

FINGERPRINT=$(adb shell getprop ro.build.fingerprint)
VBMETA_DIGEST=$(adb shell getprop ro.boot.vbmeta.digest)
LOG_ENTRY="${FINGERPRINT}\n${VBMETA_DIGEST}\n"
PAYLOAD_PATH="/tmp/log_payload.txt"
echo -e $LOG_ENTRY > $PAYLOAD_PATH

cd avb/tools/transparency/verify/
go build cmd/verifier/verifier.go
./verifier --payload_path=$PAYLOAD_PATH --log_type=pixel

بند اول فراداده را از دستگاه Pixel در قالب ورودی گزارش بازیابی می‌کند و آن را در /tmp/log_payload.txt ذخیره می‌کند.

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

برونداد فرمان در stdout نوشته می‌شود:

  • OK اگر تصویر در گزارش گنجانده شده باشد،
  • اگر روشن نیست، FAILURE.

اثبات سازگاری (اختیاری)

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

عملکرد فقط افزودنی گزارش شفاف‌سازی به‌طور فعال توسط طرف‌های سوم بررسی می‌شود و بنابراین اکثر کاربران نیازی به انجام این کار ندارند، اما هر کسی می‌تواند سازگاری گزارش را نظارت کند. ‫Google پیاده‌سازی منبع باز گواه را در این مخزن Github منتشر کرده است. لازم است از پیکربندی مختص گزارش «شفافیت دودویی Pixel»‏ (PixelBT) استفاده کنید.