Google System Services APK Şeffaflık Tam Doğrulaması

Bu sayfada, Android cihazınıza yüklenen APK'nın Hak Talebinde Bulunan Model'de yapılan hak talebiyle eşleştiğinden emin olmak için kullanabileceğiniz çeşitli yöntemler açıklanmaktadır. Bu işlem, söz konusu APK'yı cihazınızdan almayı, kod bütünlüğünü kontrol etmeyi ve ayıklanan yapı üzerinde günlük dahil etme kanıtı gerçekleştirmeyi içerir.

Doğrulama Süreci

Şeffaflık günlüğü, karma değerlerden oluşan bir Merkle ağacı ile uygulanır. Yaprak düğümde veri, üst düğümde ise alt düğümlerinin karması bulunur.

Temel olarak, şeffaflık günlüklerinin kurcalanmaya karşı koruma özelliğini doğrulamak için Merkle ağacında iki hesaplama yapılır: dahil etme kanıtı ve tutarlılık kanıtı. İlki, günlüğün belirli bir APK sürümüne karşılık gelen bir giriş içerdiğini kanıtlar. Günlük girişi, ilgili APK'lardan alınabilen JSON Web Jetonu (JWT) biçimindeki kod imzalama jetonunun SHA256 özeti olan bir karma içerir. İkincisi, ağaca yeni girişler eklendiğinde yeni kontrol noktasının ağacın önceki sürümüyle (kriptografik olarak) tutarlı olduğunu kanıtlar.

Kapsanan bir APK'yı doğrulamak için tanık olunan bir kontrol noktasına dayalı dahil etme kanıtı testi gerçekleştirin. Bu günlüğü, standartlaştırılmış bir tanık protokolü kullanarak herkese açık bir tanık ağıyla entegre etmeyi planladığımızı unutmayın. Bu işlem, günlüğün tutarlılığını garanti eden tanıklı bir kontrol noktası sağlar.

Cihazınızdaki APK'nın, hak talebinde bulunan modelde belirtilen iddiaya uygun olduğundan emin olmak istiyorsanız aşağıdaki açıklamayı inceleyin.

Dahil etme kanıtı

Android kullanıcıları, cihazlarındaki kapsam dahilindeki bir APK'nın günlükte olup olmadığını kontrol etmek için önce APK'yı ve ilgili meta verilerini ayıklayabilir, ardından yeniden hesaplanan kök karmasını yayınlanan kontrol noktasında bulunan kök karmasıyla karşılaştırabilir. Eşleşme varsa Android kullanıcısı, Tehdit Modeli'nde açıklanan bazı koruma özelliklerinden yararlanabilir.

APK'nın Günlüğe Dahil Edildiğini Doğrulama

Daha önce açıklandığı gibi, şu anda kapsanan APK'ların listesini Genel bakış sayfasında bulabilirsiniz.

Doğrulama Ön Koşulları

Öğenin (donanım yazılımı veya APK) iddiaya uygun olduğunu doğrulamaya geçmeden önce aşağıdaki araçların ağa bağlı bir bilgisayarda mevcut olduğundan emin olun. Doğrulama hedefine bağlı olarak bunların tümüne ihtiyacınız olmayabilir.

Golang

Doğrulama aracı Go dilinde yazılmıştır. Aracı derlemek için Go sitesinden Go 1.24 veya sonraki bir sürümü yükleyin.

Android Debug Bridge (ADB)

ADB, Android cihazla iletişim kurarak görüntüyü inceleyen veya APK'ları çıkaran bir araçtır. Android SDK Platform Araçları web sitesinde mevcuttur.

Dahil edilme kanıtı doğrulayıcısı

Dahil edilme kanıtı doğrulayıcı, şeffaflık günlüğünü sorgulayan ve bir yapının günlüğe dahil edilip edilmediğini belirten bir Go modülüdür. https://github.com/android/android-binary-transparency/tree/main adresindeki android-binary-transparency GitHub deposunda yayınlanır.

AOSP avb deposunu klonlamak için:

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

android-binary-transparency GitHub deposunu klonlamak için:

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

AAPT2

AAPT2 (Android Öğe Paketleme Aracı), Android uygulamalarının kaynaklarını derlemek ve paketlemek için kullanılan bir derleme aracıdır. Android SDK Derleme Araçları'nın 26.0.2 ve sonraki sürümlerinde bağımsız bir araç olarak bulunabilir.

bundletool

bundletool, Android App Bundle (AAB) oluşturmak için kullanılan bir araçtır. APK kod imzalarını doğrulamak için de kullanılabilir. GitHub'dan indirilebilir.

wget veya curl

wget ve curl, internetten dosya almak veya indirmek için kullanılabilen araçlardır. Doğrulama komut dosyaları bu araçlardan birini kullanabileceğinden, bu araçlardan birinin yüklü olduğundan emin olun.

Avbtool

avbtool, fabrika ayarı görüntülerinin VBMeta özetini hesaplamak ve ikili programları doğrulamak için kullanılır. avb deposunu klonladıktan sonra (Dahil Etme Kanıtı doğrulayıcı bölümünde gösterildiği gibi) avbtool.py, klonlanan avb dizininde bulunabilir. Bu dizini $PATH ortam değişkeninize eklemeniz gerekir.

computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL

Fbpacktool

fbpacktool, Pixel'in bootloader.img dosyasındaki bağımsız bileşenleri açmak için kullanılan bir Python komut dosyasıdır. APK'ları doğruluyorsanız buna ihtiyacınız yoktur. Bu araç, avbtool.py uygulamasının doğrulama için gerekli resimleri bulmasını sağladığından önemlidir.

fbpacktool, Python 3.6 veya sonraki sürümleri ve PyYAML paketini gerektirir (ör. python3 -m pip install pyyaml).

Bu araçtan yararlanmak için aşağıdaki altı Python komut dosyasını avbtool.py dosyanızın bulunduğu dizine indirmeniz, fbpacktool.py dosyasını yürütülebilir hale getirmeniz ve kolaylık sağlamak için fbpacktool.py dosyasına fbpacktool adlı bir sembolik bağlantı oluşturmanız gerekir.

wget kullanıyorsanız:

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 kullanıyorsanız:

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, doğrulama iş akışında terminali kullanarak çeşitli kriptografik işlemler gerçekleştirmenize yardımcı olur. Sisteminizde yüklü olduğundan emin olun. Aşağıdaki komutu çalıştırıp döndürülen sonucun boş olmadığından emin olarak terminalinizi kontrol edebilirsiniz:

computer:~$ which openssl
/usr/bin/openssl

Doğrulama için yük oluşturma

Cihazınızdan çıkardığınız APK'nın iddialarımıza uygun olduğunu doğrulamak için APK'dan elde edilen bilgilerden bir günlük yükü oluşturmanız gerekir.

Başlamadan önce, cihazınızda adb hata ayıklamayı etkinleştirerek adb uygulamasının cihazınızda kullanılabildiğinden emin olun.

Ardından, APK'nın cihazınızda nerede yüklü olduğunu bulun. Bu kılavuzda, örnek olarak Android Sistemi Anahtar Doğrulayıcı APK'sını (com.google.android.contactkeys) kullanacağız.

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

Android Sistemi Anahtar Doğrulayıcı APK'sı cihazınızda yüklüyse yukarıdaki komut, cihazınızda yüklü olduğu yeri gösteren bir yol döndürür. Aksi takdirde herhangi bir çıkış göremezsiniz.

Ardından, şu komutu kullanarak APK'yı Android cihazınızdan çalıştığınız bilgisayara indirin (cihazınızdaki gerçek konumun ve APK dosya adının değişebileceğini unutmayın):

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

İndirdiğiniz APK'nın paket adını öğrenmek ve doğrulamak için öncelikle APK'nın sıkıştırmasını açmanız gerekir. APK, özel bir ZIP dosyası türüdür.

computer:/tmp/testdir$ mkdir extracted && unzip contactkeys_candidate.apk -d extracted/

Bu adım, APK'yı oluşturan tüm dosyaları açar. Paket adı ve sürümü, APK'nın manifest dosyasında bulunabilir. Bu dosya genellikle AndroidManifest.xml adlı bir dosyadır.

Ancak elde edilen manifesto dosyası, insanlar tarafından okunamayan ikili biçimdedir. İkili XML'i okunabilir bir biçime dönüştürmek için daha önce yüklenen aapt2 aracını kullanırız (ön koşul bölümünde yüklenmesi gerektiği belirtilmiştir).

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'

Yukarıdaki çıkıştan, bu APK'nın paket adının com.google.android.contactkeys ve sürüm numarasının (versionCode) 1413 olduğundan emin olabiliriz.

Şimdi APK'da kod şeffaflığı imzasını arayacağız. Bu, APK'dan çıkarılan diğer dosyalar arasında META-INF klasöründe bulunan code_transparency_signed.jwt adlı bir dosya olmalıdır.

computer:/tmp/testdir$ sha256sum extracted/META-INF/code_transparency_signed.jwt
1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11  code_transparency_signed.jwt

Bu karma dizeyle, Günlük İçeriği bölümünde açıklanan biçime göre bir günlük yükü oluşturmak için gereken her bilgiye sahibiz. Bu örnekte, ilgili günlük yükü aşağıdaki gibi görünmelidir:

1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11
SHA256(Signed Code Transparency JWT)
com.google.android.contactkeys
1143

Paket sürümünden sonraki yeni satır karakterine de dikkat edin.

İçeriği payload.txt gibi bir dosyaya kaydedebilirsiniz. Bu, daha sonra dahil etme kanıtı testi yaparken işinize yarayacaktır.

APK Kod İmzasının Özgünlüğünü Doğrulama

Şimdi APK'ya yerleştirilmiş kod imzalama jetonunun gerçekliğini doğrulamamız gerekiyor. Bunun için bundletool ve ilk başta imzalamak için kullanılan anahtar çiftinin ortak anahtarından yararlanırız. İlgili APK'ların her bölümünde yayınlanırlar. Ortak anahtar sertifikasını (ör. Android Sistemi Anahtar Doğrulayıcı için) signing_cert_pubkey.pem adlı bir dosyaya kaydettiğinizi varsayarsak kod imzası doğrulama işlemini gerçekleştirmek için aşağıdaki kılavuzu uygulayın.

Öncelikle bir ZIP arşivi oluşturmanız ve aday APK'yı ZIP arşivine eklemeniz gerekir.

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

Aday APK'ya yerleştirilmiş kod imzasının yayınlanan imzayla eşleşip eşleşmediğini doğrulamak için bundletool'ın check-transparency komutunu kullanmaya hazırız.

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.

Yukarıdaki komutun çıkışında hem kod şeffaflığı imzasının hem de kod şeffaflığının doğrulandığının belirtildiğinden emin olmanız gerekir. Eşleşmiyorsa (ör. Code transparency verification failed because the provided public key certificate does not match the transparency file gibi bir çıkış görüyorsanız) söz konusu APK'nın kod bütünlüğü ihlal edilmiş olabilir ve APK'ya güvenmemeniz gerekir. Doğru ortak anahtar sertifikasıyla doğrulama yaptığınızdan emin olmak için iki kez kontrol etmeyi unutmayın. Aksi takdirde, diğer her şey doğruysa bu, doğruladığınız APK için kod imzasının gerçekliğinin doğrulandığı anlamına gelir.

Paket Dahil Edilme Durumunu Doğrulama (Dahil Edilme Kanıtı)

Daha önce oluşturduğunuz yükü kullanarak söz konusu paketin şeffaflık günlüğüne dahil edilip edilmediğini test etmeye hazırsınız.

Android Açık Kaynak Projesi'ndeki avb depoda bir dahil etme kanıtı aracı yayınlandı. Çalıştırmak için:

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

Doğrulayıcı, APK yükünüzün şeffaflık günlüğünde olduğunu kontrol etmek için ilgili kontrol noktasını ve günlük içeriklerini (karolar dizininde bulunur) kullanarak APK'nın gerçekten Google tarafından yayınlandığını doğrular.

Komutun çıkışı stdout'a yazılır:

  • OK. inclusion check success! paketin kodu günlüğe dahil edilmişse,
  • Aksi takdirde FAILURE.