דף הפרטים הטכניים של השקיפות בינארית של Pixel

יומן השקיפות הבינארית של Pixel מבוסס על טכנולוגיית יומן שקיפות.

התועלת של יומני שקיפות הוכחה באמצעות שקיפות אישורים, פרוטוקול אינטרנט שמחייב רשויות אישורים לפרסם את האישורים שהן מנפיקות ביומני שקיפות אישורים שגלויים לכולם. התהליך הזה הפחית באופן משמעותי את ההנפקה השגויה של אישורים, וכך הגביר את האבטחה באינטרנט. הרבה מפעילי יומנים של שקיפות אישורים מסתמכים על הטמעה של יומני שקיפות שנמצאים בכתובת transparency.dev.

יומני השקיפות מוטמעים באמצעות עצי מרקל (Merkle trees). ההנחה בדף הזה היא שיש לכם ידע כללי על עצי מרקל ועל שקיפות בינארית. במאמר מבני נתונים שניתנים לאימות יש סקירה כללית של עצי Merkle, ובדף הנחיתה יש סקירה כללית של שקיפות בינארית.

הטמעת יומנים

יומן השקיפות הבינארית של Pixel מוטמע כעץ מרקל מבוסס-משבצות. השורש של תוכן המשבצת מוצג בכתובת https://developers.google.com/android/binary_transparency/tile. הערה: זה לא דף אינטרנט רגיל. צריך לקרוא את רשומות היומן שבספריות המשנה שלו באופן פרוגרמטי באמצעות ספריית TLog של Golang SumDB, ולא באמצעות דפדפן.

במאמר תוכן היומן מוסבר מה מכילות הרשומות.

ה-hash של שורש עץ Merkle של יומן, שכלול בנקודת ביקורת, מוצג בכתובת 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-----

תהליך האימות קורא את נקודת הבדיקה ואת המשבצות שמכילות את רשומות היומן מהיומן.

תהליך האימות

יומן שקיפות מיושם באמצעות עץ מרקל שמורכב מגיבובים. צומת עלה מכיל נתונים, וצומת הורה מכיל את הגיבוב של הצמתים הצאצאים שלו.

כדי לאמת את המאפיין של יומני השקיפות שמעיד על שיבוש, מתבצעים שני חישובים בעץ מרקל: הוכחת הכללה והוכחת עקביות. הראשון מוכיח שהיומן כולל רשומה שתואמת לגרסת תמונה, כלומר. רשומת היומן כוללת את תקציר VBMeta, גיבוב שמייצג את קובצי האימג' של מערכת ההפעלה, שאפשר להחזיר ממכשיר. האחרון מוכיח שכאשר נוספים ערכים חדשים לעץ, נקודת הבדיקה החדשה עקבית עם הגרסה הקודמת של העץ.

כדי לאמת את התמונה ב-Pixel, צריך לבצע את הוכחת ההכללה. ביצוע החישוב של הוכחת העקביות הוא אופציונלי, כי צדדים שלישיים מבצעים אותו באופן רציף.

אם אתם רוצים להכיר את מושגי האימות בשקיפות הבינארית של Pixel, אתם יכולים לפעול לפי ההוראות שבהמשך כדי להשתמש בתמונה שפועלת במכשיר Pixel שלכם. אם אתם רוצים להפעיל את הקושחה של Pixel ברמת האמינות הגבוהה ביותר, עיינו בתהליך האימות במאמר אימות מלא של שקיפות בינארית ב-Pixel.

דרישות מוקדמות לאימות

לפני שממשיכים לאימות של הארטיפקט (קושחה או APK) בהתאם לטענה, צריך לוודא שהכלים הבאים זמינים במחשב שמחובר לרשת. יכול להיות שלא תצטרכו את כל השלבים האלה, בהתאם ליעד האימות.

Golang

כלי האימות כתוב ב-Go. כדי ליצור אותו, צריך להתקין את Go בגרסה 1.24 ואילך מאתר Go.

Android Debug Bridge‏ (ADB)

‫ADB הוא כלי שמתקשר עם מכשיר Android כדי לבדוק את קובץ האימג' או לחלץ קובצי APK. הוא זמין באתר של Android SDK Platform Tools.

מאמת הוכחת הכללה

המאמת של הוכחת ההכללה הוא מודול 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

AAPT2

‫AAPT2 (כלי Android לאריזת נכסים) הוא כלי build שמשמש לקמפול ולאריזה של המשאבים של אפליקציה ל-Android. הוא זמין ככלי נפרד ב-Android SDK Build Tools מגרסה 26.0.2 ואילך.

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).

כדי להשתמש בכלי הזה, צריך להוריד את ששת הסקריפטים הבאים של 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

הוכחת הכללה

בעלי מכשיר 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. הכלי הזה מחשב את ה-hash של רשומת היומן המועמדת, מאחזר מהיומן את ערכי ה-hash האחרים שנדרשים כדי לחשב מחדש את נקודת הבדיקה, ומשווה אותה לנקודת הבדיקה שפורסמה על ידי היומן.

הפלט של הפקודה נכתב ב-stdout:

  • ‫OK אם התמונה נכללת ביומן,
  • FAILURE אם הוא לא מותקן.

הוכחת עקביות (אופציונלי)

‫Google מפרסמת מדי פעם גרסאות חדשות של קובץ האימג' של Pixel, ולכן יומן השקיפות גדל כל הזמן. עד בודק שהעץ גדל באופן שתואם לעלים הקודמים שלו. העד עוקב אחרי גיבוב שורש העץ, ומחשב את גיבוב השורש המועמד הבא על ידי בקשת גיבובי העלים החדשים מהעץ. כדי שיומן שקיפות יהיה עמיד בפני שיבושים, צריך לבדוק אותו באופן קבוע כדי לוודא שהוא עקבי.

התנהגות הוספה בלבד של יומן השקיפות נבדקת באופן פעיל על ידי צדדים שלישיים, ולכן רוב המשתמשים לא צריכים לעשות זאת בעצמם, אבל כל אחד יכול לעקוב אחרי העקביות של היומן. ‫Google פרסמה הטמעה של עד בקוד פתוח במאגר GitHub הזה. צריך להשתמש בהגדרות הספציפיות ליומן של שקיפות בינארית ב-Pixel‏ (PixelBT).