Le journal Pixel Binary Transparency exploite la technologie de journal de transparence.
L'utilité des journaux de transparence a été prouvée avec Certificate Transparency, un protocole Internet qui exige que les autorités de certification publient les certificats qu'elles émettent dans des journaux de transparence des certificats publics. Ce processus a considérablement réduit l'émission incorrecte de certificats, ce qui a renforcé la sécurité d'Internet. De nombreux opérateurs de journaux de transparence des certificats s'appuient sur une implémentation des journaux de transparence disponible sur transparency.dev.
Les journaux de transparence sont implémentés avec des arbres de Merkle. Cette page suppose une connaissance générale des arbres de Merkle et de la transparence binaire. Consultez Structures de données vérifiables pour obtenir une présentation des arbres de Merkle et la page de destination pour une présentation de la transparence binaire.
Implémentation du journal
Le journal Pixel Binary Transparency est implémenté sous la forme d'un
arbre de Merkle basé sur des tuiles. La racine du contenu des tuiles est diffusée sur https://developers.google.com/android/binary_transparency/tile. Remarque : Il ne s'agit
pas d'une page Web ordinaire. Les entrées de journal contenues dans ses sous-répertoires doivent
être lues par programmation avec la bibliothèque Golang SumDB
TLog, et non via un
navigateur.
Consultez Contenu du journal pour obtenir une description du contenu des entrées.
Le hachage racine de l'arbre de Merkle d'un journal, contenu dans un point de contrôle, est diffusé sur https://developers.google.com/android/binary_transparency/checkpoint.txt. Il est présenté au format de point de contrôle. Les feuilles de cet arbre de Merkle sont diffusées sur https://developers.google.com/android/binary_transparency/image_info.txt. La signature du point de contrôle peut être vérifiée avec la clé publique suivante :
-----BEGIN CERTIFICATE-----
MIICPDCCAeOgAwIBAgIVAPooxISw/nFF/dPwmCUaV36Z4s3hMAoGCCqGSM49BAMCMHQxCzAJBgNV
BAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYD
VQQKEwtHb29nbGUgSW5jLjEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDAgFw0y
MTA3MTkyMjQxNDFaGA8yMDUxMDcxOTIyNDE0MVowdDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNh
bGlmb3JuaWExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC0dvb2dsZSBJbmMuMRAw
DgYDVQQLEwdBbmRyb2lkMRAwDgYDVQQDEwdBbmRyb2lkMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcD
QgAEU83uXNUiTYE53c2TfdWmqpW20bBXy4KEf5Ff8dV8GLKlVAXKHyjw3Lp9J3E0yCRJ/39XKeuA
AMF7KzSvhD248KNQME4wDAYDVR0TBAUwAwEB/zAdBgNVHQ4EFgQUHRpvuNkzjtBY213BWgUyWWHm
3VYwHwYDVR0jBBgwFoAUHRpvuNkzjtBY213BWgUyWWHm3VYwCgYIKoZIzj0EAwIDRwAwRAIgZsZb
CNBXRkCKLS+LG/41VWj1cTszt9QCdJQNuy7aT94CIDPgn7v5b1ykBVUTuLgRSofxAzHg9R4dg1oA
7tTFAuDg
-----END CERTIFICATE-----
Le processus de validation lit le point de contrôle et les tuiles contenant les entrées de journal du journal.
Procédure de validation
Un journal de transparence est implémenté avec un arbre de Merkle composé de hachages. Un nœud feuille contient des données, et un nœud parent contient le hachage de ses enfants.
Deux calculs sont effectués sur l'arbre de Merkle pour vérifier la propriété d'inviolabilité des journaux de transparence : la preuve d'inclusion et la preuve de cohérence. La première prouve que le journal inclut une entrée correspondant à une image de l'OS, c'est-à-dire. L'entrée de journal inclut le condensé VBMeta, un hachage qui représente les images de l'OS, qui peuvent être renvoyées à partir d'un appareil. La seconde prouve que lorsque de nouvelles entrées sont ajoutées à l'arborescence, le nouveau point de contrôle est cohérent avec la version précédente de l'arborescence.
Pour vérifier votre image Pixel, effectuez la preuve d'inclusion. L'exécution du calcul de la preuve de cohérence est facultative, car des tiers le font en permanence.
Si vous souhaitez vous familiariser avec les concepts de validation dans la transparence binaire Pixel, vous pouvez suivre les instructions ci-dessous pour utiliser l'image exécutée sur votre appareil Pixel. Si vous souhaitez exécuter le micrologiciel Pixel avec le plus haut degré de confiance, consultez la procédure de validation sur Validation complète de la transparence binaire Pixel.
Conditions préalables pour la validation
Avant de vérifier que l'artefact (micrologiciel ou APK) est conforme à la revendication, assurez-vous que les outils suivants sont disponibles sur un ordinateur connecté au réseau. Selon la cible de validation, vous n'aurez peut-être pas besoin de tous ces outils.
Golang
L'outil de validation est écrit en Go. Pour le créer, installez Go 1.24 ou une version ultérieure à partir du site Go.
Android Debug Bridge (ADB)
ADB est un outil qui communique avec un appareil Android pour inspecter l'image ou extraire des APK. Il est disponible sur le site Web SDK Android Platform Tools website.
Outil de validation de la preuve d'inclusion
L'outil de validation de la preuve d'inclusion est un module Go qui interroge le journal de transparence et indique si un artefact est inclus dans le journal.
Il est publié dans le dépôt GitHub android-binary-transparency à l'adresse
https://github.com/android/android-binary-transparency/tree/main.
Pour cloner le dépôt AOSP avb :
computer:~$ git clone https://android.googlesource.com/platform/external/avb
Pour cloner le dépôt GitHub android-binary-transparency :
computer:~$ git clone https://github.com/android/android-binary-transparency
AAPT2
AAPT2 (Android Asset Packaging Tool) est un outil de compilation utilisé pour compiler et empaqueter les ressources d'une application Android. Il est disponible en tant qu'outil autonome dans les outils de compilation du SDK Android version 26.0.2 et versions ultérieures.
bundletool
bundletool est un outil utilisé pour créer un Android App Bundle (AAB). Il peut également être utilisé pour vérifier les signatures de code APK.
Il peut être téléchargé depuis GitHub.
wget ou curl
wget et curl sont des outils qui peuvent être utilisés pour récupérer ou télécharger des fichiers depuis Internet. Assurez-vous que l'un de ces outils est installé, car les scripts de validation peuvent en dépendre.
Avbtool
avbtool
est utilisé pour calculer le condensé VBMeta des images d'usine et la validation des
binaires.
Après avoir cloné le dépôt avb (comme indiqué dans la section Outil de validation de la preuve d'inclusion
), avbtool.py se trouve dans le répertoire avb cloné.
Vous devez ajouter ce répertoire à votre variable d'environnement $PATH.
computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL
Fbpacktool
fbpacktool
est un script Python utilisé pour décompresser des composants individuels dans Pixel's
bootloader.img.
Vous n'en avez pas besoin si vous validez des APK.
Cet outil est important, car il permet à avbtool.py de découvrir les images requises pour la validation.
fbpacktool nécessite Python 3.6 ou une version ultérieure et le
PyYAML
(par exemple, python3 -m pip install pyyaml).
Pour utiliser cet outil, vous devez télécharger les six scripts Python suivants
dans le répertoire où se trouve votre avbtool.py,
rendre fbpacktool.py exécutable,
et créer un lien symbolique nommé fbpacktool vers fbpacktool.py pour plus de commodité.
Si vous disposez de 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
Si vous disposez de 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 permet d'effectuer diverses opérations de chiffrement à l'aide du terminal dans le workflow de validation. Assurez-vous qu'il est installé sur votre système. Vous pouvez vérifier sur votre terminal en exécutant la commande suivante et en vous assurant que le résultat renvoyé n'est pas vide :
computer:~$ which openssl
/usr/bin/openssl
Preuve d'inclusion
Un propriétaire de Pixel peut vérifier que son image se trouve dans le journal en extrayant d'abord les métadonnées pertinentes, puis en comparant le hachage racine recalculé avec le hachage racine contenu dans le point de contrôle publié. S'ils correspondent, le propriétaire de Pixel peut être assuré de certaines protections illustrées dans le modèle de menace.
Pour vérifier que l'image d'un appareil Pixel se trouve dans le journal de transparence, connectez-vous à l'appareil avec adb, puis exécutez les commandes suivantes :
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
La première strophe récupère les métadonnées d'un appareil Pixel au format d'une entrée de journal et les enregistre dans /tmp/log_payload.txt.
La deuxième strophe exécute l'outil de validation de la preuve d'inclusion publié dans le dépôt Android Verified Boot. Cet outil calcule le hachage de l'entrée de journal candidate, récupère les autres hachages nécessaires pour recalculer le point de contrôle à partir du journal et le compare au point de contrôle publié par le journal.
Le résultat de la commande est écrit dans stdout :
OKsi l'image est incluse dans le journal,FAILUREsi ce n'est pas le cas.
Preuve de cohérence (facultatif)
Étant donné que Google publie régulièrement de nouvelles versions de l'image d'usine Pixel, le journal de transparence ne cesse de croître. Un témoin vérifie que l'arborescence se développe de manière cohérente avec ses feuilles précédentes. Le témoin suit le hachage racine de l'arborescence et calcule le hachage racine candidat suivant en demandant les nouveaux hachages de feuilles à l'arborescence. Pour qu'un journal de transparence soit inviolable, il doit être vérifié en permanence pour s'assurer de sa cohérence.
Le comportement d'ajout uniquement du journal de transparence est activement vérifié par des tiers. La plupart des utilisateurs n'ont donc pas besoin de le faire eux-mêmes, mais tout le monde peut surveiller la cohérence du journal. Google a publié une implémentation Open Source d'un témoin dans ce dépôt GitHub. Il est nécessaire d' utiliser la configuration spécifique au journal Pixel Binary Transparency (PixelBT).