การยืนยันความโปร่งใสของ APK บริการระบบของ Google อย่างเต็มรูปแบบ

หน้านี้จะอธิบายวิธีการต่างๆ เพื่อให้มั่นใจว่า APK ที่ติดตั้งในอุปกรณ์ Android ของคุณสอดคล้องกับการอ้างสิทธิ์ที่ทำในโมเดลผู้อ้างสิทธิ์ ซึ่งรวมถึงการดึง APK ที่เป็นปัญหาจากอุปกรณ์ของคุณ ตรวจสอบความสมบูรณ์ของโค้ด และทำการพิสูจน์การรวมบันทึกในอาร์ติแฟกต์ที่แยกออกมา

กระบวนการยืนยันตัวตน

บันทึกความโปร่งใสจะใช้ Merkle Tree ซึ่งประกอบด้วยแฮช โหนดปลายสุดจะมีข้อมูล และโหนดหลักจะมีแฮชของโหนดย่อย

โดยพื้นฐานแล้ว ระบบจะทำการคำนวณ 2 รายการใน Merkle Tree เพื่อยืนยันคุณสมบัติที่เห็นร่องรอยการงัดแงะของบันทึกความโปร่งใส ซึ่งได้แก่ หลักฐานการรวมและหลักฐานความสอดคล้อง โดยหลักฐานแรกจะพิสูจน์ว่าบันทึกมีรายการที่สอดคล้องกับ APK เวอร์ชันหนึ่งๆ รายการบันทึกประกอบด้วยแฮช ซึ่งเป็นไดเจสต์ SHA256 ของโทเค็นลายเซ็นโค้ดในรูปแบบโทเค็นเว็บ JSON (JWT) ซึ่งรับได้จาก APK ที่เกี่ยวข้อง ส่วนหลักฐานความสอดคล้องจะพิสูจน์ว่าเมื่อมีการเพิ่มรายการใหม่ลงในโครงสร้าง Checkpoint ใหม่จะสอดคล้อง (ตามหลักการเข้ารหัส) กับโครงสร้างเวอร์ชันก่อนหน้า

หากต้องการยืนยัน APK ที่ครอบคลุม ให้ทำการทดสอบหลักฐานการรวมโดยอิงตามจุดตรวจสอบที่ได้รับการรับรอง โปรดทราบว่าเราวางแผนที่จะผสานรวมบันทึกนี้กับเครือข่ายพยานสาธารณะโดยใช้โปรโตคอลพยานที่ได้มาตรฐาน ซึ่งจะให้จุดตรวจสอบที่มีการตรวจสอบ ซึ่งรับประกันความสอดคล้องของบันทึก

หากต้องการตรวจสอบว่า APK ที่คุณมีในอุปกรณ์เป็นไปตามการอ้างสิทธิ์ที่ระบุไว้ในโมเดลผู้อ้างสิทธิ์ โปรดดูคำอธิบายด้านล่าง

Inclusion Proof

ผู้ใช้ Android สามารถตรวจสอบว่า APK ที่ครอบคลุมในอุปกรณ์ของตนอยู่ในบันทึกหรือไม่ โดยเริ่มจากการแยก APK และข้อมูลเมตาที่เกี่ยวข้อง จากนั้นเปรียบเทียบแฮชรูทที่คำนวณใหม่กับแฮชรูทที่อยู่ในจุดตรวจสอบที่เผยแพร่ หากตรงกัน ผู้ใช้ Android จะมั่นใจได้ถึงการป้องกันบางอย่างที่อธิบายไว้ในโมเดลภัยคุกคาม

วิธียืนยันการรวม APK ในบันทึก

ตามที่อธิบายไว้ก่อนหน้านี้ คุณดูรายการ APK ที่ครอบคลุมในปัจจุบันได้ในหน้าภาพรวม

ข้อกำหนดเบื้องต้นในการรับการยืนยัน

ก่อนดำเนินการต่อเพื่อยืนยันว่าอาร์ติแฟกต์ (เฟิร์มแวร์หรือ APK) เป็นไปตามการอ้างสิทธิ์ โปรดตรวจสอบว่าเครื่องมือต่อไปนี้พร้อมใช้งานในคอมพิวเตอร์ที่เชื่อมต่อเครือข่าย คุณอาจไม่จำเป็นต้องใช้ข้อมูลทั้งหมด ทั้งนี้ขึ้นอยู่กับเป้าหมายการยืนยัน

Golang

เครื่องมือยืนยันเขียนด้วย Go หากต้องการสร้างเครื่องมือดังกล่าว ให้ติดตั้ง Go 1.24 ขึ้นไปจากเว็บไซต์ Go

Android Debug Bridge (ADB)

ADB เป็นเครื่องมือที่สื่อสารกับอุปกรณ์ Android เพื่อตรวจสอบอิมเมจหรือแยก APK ซึ่งมีอยู่ในเว็บไซต์เครื่องมือแพลตฟอร์ม Android SDK

เครื่องมือตรวจสอบ Inclusion Proof

ตัวตรวจสอบหลักฐานการรวมเป็นโมดูล Go ที่ค้นหาบันทึกความโปร่งใสและแสดงผลว่าอาร์ติแฟกต์รวมอยู่ในบันทึกหรือไม่ ซึ่งเผยแพร่ในที่เก็บ GitHub ของ android-binary-transparency ที่ https://github.com/android/android-binary-transparency/tree/main

วิธีโคลนที่เก็บ avb ของ AOSP

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

วิธีโคลนที่เก็บ GitHub android-binary-transparency

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

AAPT2

AAPT2 (Android Asset Packaging Tool) เป็นเครื่องมือสร้างที่ใช้ในการคอมไพล์และจัดแพ็กเกจทรัพยากรของแอป Android ซึ่งเป็นเครื่องมือแบบสแตนด์อโลนในเครื่องมือสร้าง Android SDK เวอร์ชัน 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 6 รายการต่อไปนี้ลงในไดเรกทอรีที่มี 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 จากอุปกรณ์ 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 ชื่อแพ็กเกจและเวอร์ชันจะอยู่ใน manifest ของ APK ซึ่งโดยปกติจะอยู่ในไฟล์ชื่อ AndroidManifest.xml

อย่างไรก็ตาม ไฟล์ Manifest ที่ได้รับจะอยู่ในรูปแบบไบนารีซึ่งมนุษย์อ่านไม่ได้ ในการแปลง 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 เป็นผู้เผยแพร่เพย์โหลดดังกล่าวจริง

ระบบจะเขียนเอาต์พุตของคำสั่งไปยัง stdout ดังนี้

  • OK. inclusion check success! หากโค้ดของแพ็กเกจรวมอยู่ในบันทึก
  • FAILURE หากยังไม่ได้ดำเนินการ