หน้านี้จะอธิบายวิธีการต่างๆ เพื่อให้มั่นใจว่า 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หากยังไม่ได้ดำเนินการ