Pixel 二進位檔資訊公開記錄採用資訊公開記錄技術。
憑證透明化是網際網路通訊協定,要求憑證授權單位將核發的憑證發布至公開的憑證透明化記錄,這項通訊協定已證明透明記錄的實用性。這項程序大幅減少了憑證誤發的情況,進而提升網際網路的安全性。許多憑證透明化記錄運作人員都仰賴 transparency.dev 上的透明化記錄實作。
資訊公開記錄是透過 Merkle 樹狀結構實作。本頁假設您對 Merkle 樹狀結構和二進位檔透明度有基本瞭解。如要瞭解 Merkle 樹狀結構,請參閱「可驗證的資料結構」;如要瞭解二進位透明度,請參閱到達網頁。
記錄導入
Pixel 二進位檔透明度記錄是以圖塊式 Merkle 樹狀結構實作。資訊方塊內容的根目錄位於 https://developers.google.com/android/binary_transparency/tile。注意:這不是一般網頁,子目錄中的記錄項目應透過 Golang SumDB TLog 程式庫以程式輔助方式讀取,而非透過瀏覽器。
如要瞭解項目內容,請參閱「記錄內容」。
記錄的 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-----
驗證程序會從記錄檔讀取查核點和包含記錄項目的圖塊。
驗證程序
透明度記錄是透過由雜湊組成的 Merkle 樹狀結構實作。葉節點包含資料,父項節點則包含子項的雜湊值。
系統會對 Merkle 樹狀結構執行兩項運算,驗證透明度記錄的防竄改屬性:納入證明和一致性證明。前者證明記錄包含與映像檔版本對應的項目。記錄項目包含 VBMeta 摘要,也就是代表 OS 映像檔的雜湊,可從裝置傳回。後者則證明,當新項目新增至樹狀結構時,新的查核點與先前的樹狀結構版本一致。
如要驗證 Pixel 映像檔,請執行納入證明。執行一致性證明計算是選用操作,因為第三方會持續執行這項操作。
如要熟悉 Pixel 二進位檔透明度的驗證概念,請按照下列操作說明,使用 Pixel 裝置上執行的映像檔。如要以最高程度的信心執行 Pixel 韌體,請參閱「Pixel 二進位檔透明度完整驗證」一文中的驗證程序。
通過認證的必要條件
在驗證構件 (韌體或 APK) 是否符合聲明前,請先確認網路連線電腦上已備妥下列工具。視驗證目標而定,您可能不需要全部提供。
Golang
驗證工具是以 Go 語言編寫。如要建構這項工具,請從 Go 網站安裝 Go 1.24 以上版本。
Android Debug Bridge (ADB)
ADB 工具可與 Android 裝置通訊,檢查映像檔或擷取 APK,可從 Android SDK 平台工具網站取得。
納入證明驗證工具
納入證明驗證工具是 Go 模組,可查詢透明度記錄,並輸出構件是否包含在記錄中。這項資訊發布在 android-binary-transparency GitHub 存放區,網址為:
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 資產封裝工具) 是一種建構工具,用於編譯及封裝 Android 應用程式的資源。在 Android SDK Build Tools 26.0.2 以上版本中,AAPT2 是獨立工具。
bundletool
bundletool 是用於建構 Android App Bundle (AAB) 的工具。也可以用來驗證 APK 程式碼簽章。可從 GitHub 下載。
wget 或 curl
wget 和 curl 是可用於從網際網路擷取或下載檔案的工具。請務必安裝其中一項工具,因為驗證指令碼可能會用到這些工具。
Avbtool
avbtool 用於計算原廠映像檔的 VBMeta 摘要,以及驗證二進位檔。複製 avb 存放區後 (如「納入證明驗證工具」一節所示),您可以在複製的 avb 目錄中找到 avbtool.py。您應將這個目錄新增至 $PATH 環境變數。
computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL
Fbpacktool
fbpacktool 是一種 Python 指令碼,用於解壓縮 Pixel 的 bootloader.img 中的個別元件。如果您要驗證 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 驗證開機程序存放區中發布的納入證明驗證程式。這項工具會計算候選記錄項目的雜湊值,擷取從記錄重新計算檢查點所需的其他雜湊值,並與記錄發布的檢查點進行比較。
指令的輸出內容會寫入 stdout:
- 如果記錄包含圖片,則為
OK - 如果不是,則為
FAILURE。
一致性證明 (選填)
Google 會定期發布新版 Pixel 原廠映像檔,因此透明度記錄會持續增加。見證者會檢查樹狀結構是否以與先前葉節點一致的方式成長。見證者會追蹤樹狀結構根雜湊,並向樹狀結構要求新的葉雜湊,藉此計算下一個候選根雜湊。為確保透明度記錄不會遭到竄改,必須持續檢查一致性。
第三方會主動檢查透明度記錄的僅限附加行為,因此大多數使用者不需要自行執行這項操作,但任何人都可以監控記錄的一致性。Google 已在這個 GitHub 存放區中,發布見證的開放原始碼實作內容。您必須使用 Pixel Binary Transparency (PixelBT) 記錄專用的設定。