Trang này trình bày nhiều phương thức để đảm bảo rằng tệp APK được cài đặt trên thiết bị Android của bạn tương ứng với thông tin xác nhận quyền sở hữu được đưa ra trong Mô hình bên xác nhận quyền sở hữu. Quá trình này bao gồm việc lấy tệp APK đang được đề cập từ thiết bị của bạn, kiểm tra tính toàn vẹn của mã và thực hiện bằng chứng về việc đưa vào nhật ký trên cấu phần phần mềm đã trích xuất.
Quy trình xác minh
Nhật ký minh bạch được triển khai bằng cây Merkle bao gồm các hàm băm. Nút lá chứa dữ liệu và nút mẹ chứa hàm băm của các nút con.
Về cơ bản, hai phép tính được thực hiện trên cây Merkle để xác minh thuộc tính chống can thiệp của nhật ký minh bạch: bằng chứng bao gồm và bằng chứng nhất quán. Bằng chứng trước chứng minh rằng nhật ký có chứa một mục tương ứng với một phiên bản APK cụ thể. Mục nhập nhật ký bao gồm một hàm băm, là chuỗi băm SHA256 của mã thông báo chữ ký mã dưới dạng Mã thông báo web JSON (JWT), có thể lấy từ các tệp APK tương ứng. Bằng chứng sau chứng minh rằng khi các mục mới được thêm vào cây, điểm kiểm tra mới sẽ nhất quán (về mặt mật mã) với phiên bản trước của cây.
Để xác minh một tệp APK được bảo vệ, hãy thực hiện kiểm thử bằng chứng bao gồm dựa trên một điểm kiểm tra đã được chứng thực. Xin lưu ý rằng chúng tôi dự định tích hợp nhật ký này với một mạng lưới nhân chứng công khai bằng cách sử dụng một giao thức nhân chứng chuẩn hoá. Điều này sẽ cung cấp một điểm kiểm tra được chứng kiến, đảm bảo tính nhất quán của nhật ký.
Nếu bạn muốn tự xác minh rằng tệp APK trên thiết bị của bạn tuân thủ tuyên bố trong mô hình người yêu cầu, hãy tham khảo bài viết dưới đây.
Bằng chứng về việc đưa vào
Người dùng Android có thể kiểm tra xem tệp APK được đề cập trên thiết bị của họ có trong nhật ký hay không bằng cách trước tiên trích xuất tệp APK và siêu dữ liệu liên quan, sau đó so sánh hàm băm gốc được tính toán lại với hàm băm gốc có trong điểm kiểm tra đã xuất bản. Nếu các thông tin này khớp nhau, thì người dùng Android có thể yên tâm về một số biện pháp bảo vệ được mô tả trong Mô hình mối đe doạ.
Cách xác minh việc đưa tệp APK vào nhật ký
Như đã mô tả trước đó, bạn có thể tìm thấy danh sách các tệp APK hiện được đề cập trong trang Tổng quan.
Điều kiện tiên quyết để được chứng nhận
Trước khi tiến hành xác minh rằng cấu phần phần mềm (chương trình cơ sở hoặc APK) tuân thủ tuyên bố, hãy đảm bảo rằng các công cụ sau đây có sẵn trên một máy tính có kết nối mạng. Tuỳ thuộc vào mục tiêu xác minh, bạn có thể không cần tất cả các thông tin này.
Golang
Công cụ xác minh được viết bằng Go. Để xây dựng công cụ này, hãy cài đặt Go 1.24 trở lên từ trang web của Go.
Cầu gỡ lỗi Android (ADB)
ADB là một công cụ giao tiếp với thiết bị Android để kiểm tra hình ảnh hoặc trích xuất tệp APK, có trên trang web Công cụ nền tảng SDK Android.
Trình xác minh bằng chứng về việc đưa vào
Trình xác minh bằng chứng bao gồm là một mô-đun Go truy vấn nhật ký minh bạch và xuất ra thông tin cho biết liệu một cấu phần phần mềm có được đưa vào nhật ký hay không.
Tệp này được phát hành trong kho lưu trữ GitHub android-binary-transparency tại https://github.com/android/android-binary-transparency/tree/main
Cách sao chép kho lưu trữ AOSP avb:
computer:~$ git clone https://android.googlesource.com/platform/external/avb
Cách sao chép kho lưu trữ GitHub android-binary-transparency:
computer:~$ git clone https://github.com/android/android-binary-transparency
AAPT2
AAPT2 (Công cụ đóng gói tài nguyên Android) là một công cụ bản dựng dùng để biên dịch và đóng gói tài nguyên của ứng dụng Android. Bạn có thể tìm thấy công cụ này dưới dạng một công cụ độc lập trong Công cụ tạo bản dựng SDK Android phiên bản 26.0.2 trở lên.
bundletool
bundletool là một công cụ dùng để tạo Android App Bundle (AAB). Công cụ này cũng có thể được dùng để xác minh chữ ký mã APK.
Bạn có thể tải tệp này xuống từ GitHub.
wget hoặc curl
wget và curl là các công cụ có thể dùng để truy xuất hoặc tải tệp xuống từ Internet. Hãy nhớ cài đặt một trong hai công cụ này vì tập lệnh xác minh có thể dựa vào chúng.
Avbtool
avbtool được dùng để tính toán chuỗi đại diện VBMeta của hình ảnh gốc và xác minh tệp nhị phân.
Sau khi sao chép kho lưu trữ avb (như trong phần Trình xác minh bằng chứng bao gồm), bạn có thể tìm thấy avbtool.py trong thư mục avb đã sao chép.
Bạn nên thêm thư mục này vào biến môi trường $PATH.
computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL
Fbpacktool
fbpacktool là một tập lệnh Python dùng để giải nén từng thành phần trong bootloader.img của Pixel.
Bạn không cần quyền này nếu đang xác minh APK.
Công cụ này rất quan trọng vì giúp avbtool.py tìm thấy những hình ảnh cần thiết để xác minh.
fbpacktool yêu cầu Python 3.6 trở lên và gói PyYAML (ví dụ: python3 -m pip install pyyaml).
Để sử dụng công cụ này, bạn nên tải 6 tập lệnh Python sau đây xuống thư mục chứa avbtool.py, đặt fbpacktool.py ở trạng thái có thể thực thi và tạo một liên kết tượng trưng có tên fbpacktool đến fbpacktool.py để thuận tiện.
Nếu bạn có 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
Nếu bạn có 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 giúp thực hiện nhiều thao tác mã hoá bằng cách sử dụng thiết bị đầu cuối trong quy trình xác minh. Đảm bảo rằng bạn đã cài đặt công cụ này trên hệ thống. Bạn có thể kiểm tra trên thiết bị đầu cuối bằng cách chạy lệnh sau và đảm bảo kết quả trả về không trống:
computer:~$ which openssl
/usr/bin/openssl
Tạo tải trọng để xác minh
Để xác minh rằng APK bạn đã trích xuất từ thiết bị của mình theo tuyên bố của chúng tôi, bạn phải tạo một tải trọng nhật ký từ thông tin lấy từ APK.
Trước khi bắt đầu, hãy đảm bảo rằng bạn có thể sử dụng adb trên thiết bị bằng cách bật tính năng gỡ lỗi adb trên thiết bị.
Sau đó, hãy tìm vị trí cài đặt tệp APK trên thiết bị. Để phục vụ cho mục đích của hướng dẫn này, chúng ta sẽ sử dụng APK Android System Key Verifier (com.google.android.contactkeys) làm ví dụ thực tế.
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
Nếu APK Trình xác minh khoá hệ thống Android được cài đặt trên thiết bị của bạn, thì lệnh trên sẽ trả về một đường dẫn cho biết vị trí cài đặt APK đó trên thiết bị của bạn. Nếu không, bạn sẽ không thấy kết quả nào.
Sau đó, hãy tải tệp APK từ thiết bị Android xuống máy tính mà bạn đang làm việc bằng lệnh này (lưu ý rằng vị trí thực tế và tên tệp APK trên thiết bị của bạn có thể khác nhau):
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
Để lấy và xác minh tên gói của tệp APK bạn vừa tải xuống, trước tiên, bạn cần giải nén tệp APK đó, vì về cơ bản, tệp APK là một loại tệp ZIP đặc biệt.
computer:/tmp/testdir$ mkdir extracted && unzip contactkeys_candidate.apk -d extracted/
Bước này sẽ giải nén tất cả các tệp tạo nên APK. Bạn có thể tìm thấy tên gói và phiên bản trong tệp kê khai của APK, thường nằm trong tệp có tên AndroidManifest.xml.
Tuy nhiên, tệp kê khai thu được ở dạng nhị phân, không thể đọc được.
Để chuyển đổi XML nhị phân thành dạng người dùng có thể đọc được, chúng tôi sử dụng công cụ aapt2 đã cài đặt trước đó (theo yêu cầu cài đặt trong phần điều kiện tiên quyết).
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'
Từ kết quả đầu ra ở trên, giờ đây chúng ta có thể chắc chắn rằng tên gói của tệp APK này là com.google.android.contactkeys và số phiên bản (versionCode) là 1413.
Bây giờ, chúng ta sẽ tìm chữ ký tính minh bạch của mã trong tệp APK. Đó phải là một tệp có tên code_transparency_signed.jwt nằm trong thư mục META-INF cùng với các tệp khác được trích xuất từ APK.
computer:/tmp/testdir$ sha256sum extracted/META-INF/code_transparency_signed.jwt
1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11 code_transparency_signed.jwt
Với chuỗi băm này, giờ đây chúng ta có mọi thông tin cần thiết để ghép nối tải trọng nhật ký theo định dạng được mô tả trong phần Nội dung nhật ký. Trong ví dụ này, tải trọng nhật ký tương ứng sẽ có dạng như sau:
1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11
SHA256(Signed Code Transparency JWT)
com.google.android.contactkeys
1143
Ngoài ra, hãy lưu ý ký tự dòng mới sau phiên bản gói.
Bạn có thể lưu nội dung vào một tệp, chẳng hạn như payload.txt. Điều này sẽ hữu ích khi thực hiện kiểm thử bằng chứng bao gồm sau này.
Xác minh tính xác thực của chữ ký mã APK
Bây giờ, chúng ta nên xác minh tính xác thực của mã thông báo chữ ký mã được nhúng trong APK. Để làm việc này, chúng ta sử dụng bundletool và khoá công khai của cặp khoá đã được dùng để ký ngay từ đầu. Các tệp này được xuất bản trong từng phần của tệp APK tương ứng. Giả sử bạn đã lưu chứng chỉ khoá công khai
(ví dụ: cho Android System Key Verifier)
vào một tệp có tên là signing_cert_pubkey.pem,
hãy làm theo hướng dẫn bên dưới để xác minh chữ ký mã.
Trước tiên, bạn nên tạo một tệp lưu trữ ZIP và thêm tệp APK đề xuất vào tệp lưu trữ 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
Bây giờ, chúng ta đã sẵn sàng sử dụng lệnh check-transparency của bundletool để xác minh xem chữ ký mã được nhúng trong APK đề xuất có khớp với chữ ký đã xuất bản hay không.
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.
Bạn nên đảm bảo rằng kết quả của lệnh trên cho biết cả chữ ký minh bạch của mã và tính minh bạch của mã đều được xác minh.
Nếu không, ví dụ: nếu bạn thấy kết quả như Code transparency verification failed because the provided public key
certificate does not match the transparency file, thì tức là tính toàn vẹn của mã của APK có thể bị xâm phạm và bạn không nên tin tưởng APK đó.
Hãy nhớ kiểm tra kỹ để đảm bảo bạn đang xác minh các chữ ký đó dựa trên đúng chứng chỉ khoá công khai.
Nếu không, nếu mọi thứ khác đều ổn, thì điều này có nghĩa là tính xác thực của chữ ký mã đã được xác minh cho tệp APK mà bạn đang xác thực.
Xác minh việc đưa gói vào (Bằng chứng đưa vào)
Sử dụng tải trọng mà bạn đã tạo trước đó, giờ đây, bạn đã sẵn sàng kiểm tra xem gói được đề cập đã được đưa vào nhật ký minh bạch hay chưa.
Công cụ chứng minh việc đưa vào đã được phát hành trong avb kho lưu trữ trong Dự án nguồn mở Android. Cách chạy:
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
Trình xác minh sử dụng điểm kiểm tra tương ứng và nội dung nhật ký (tìm thấy tại thư mục ô) để kiểm tra xem tải trọng APK của bạn có nằm trong nhật ký minh bạch hay không, từ đó xác minh rằng tải trọng đó thực sự do Google phát hành.
Kết quả của lệnh được ghi vào stdout:
OK. inclusion check success!nếu mã của gói được đưa vào nhật ký,FAILUREnếu không.