Il log di trasparenza binaria di Pixel sfrutta la tecnologia dei log di trasparenza.
L'utilità dei log di trasparenza è stata dimostrata con Certificate Transparency, un protocollo internet che richiede alle autorità di certificazione di pubblicare i certificati che emettono nei log di trasparenza dei certificati pubblici. Questa procedura ha ridotto notevolmente l'emissione errata di certificati, aumentando così la sicurezza di internet. Molti operatori di log di Certificate Transparency si affidano a un'implementazione dei log di trasparenza disponibile all'indirizzo transparency.dev.
I log di trasparenza vengono implementati con gli alberi di Merkle. Questa pagina presuppone una conoscenza generale degli alberi di Merkle e della trasparenza binaria. Consulta Strutture di dati verificabili per una panoramica degli alberi di Merkle e la pagina di destinazione per una panoramica della trasparenza binaria.
Implementazione dei log
Il log di trasparenza binaria di Pixel viene implementato come un
albero di Merkle basato su riquadri. La radice dei contenuti dei riquadri viene pubblicata all'indirizzo https://developers.google.com/android/binary_transparency/tile. Nota: questa non è una normale pagina web; le voci di log contenute nelle relative sottodirectory devono essere lette a livello di programmazione con la libreria SumDB
TLog di Golang e non tramite un browser.
Consulta Contenuti dei log per una descrizione dei contenuti delle voci.
L'hash della radice dell'albero di Merkle di un log, contenuto in un checkpoint, viene pubblicato all'indirizzo https://developers.google.com/android/binary_transparency/checkpoint.txt. Viene presentato nel formato del checkpoint. Le foglie di questo albero di Merkle vengono pubblicate all'indirizzo https://developers.google.com/android/binary_transparency/image_info.txt. La firma del checkpoint può essere verificata con la seguente chiave pubblica:
-----BEGIN CERTIFICATE-----
MIICPDCCAeOgAwIBAgIVAPooxISw/nFF/dPwmCUaV36Z4s3hMAoGCCqGSM49BAMCMHQxCzAJBgNV
BAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYD
VQQKEwtHb29nbGUgSW5jLjEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDAgFw0y
MTA3MTkyMjQxNDFaGA8yMDUxMDcxOTIyNDE0MVowdDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNh
bGlmb3JuaWExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC0dvb2dsZSBJbmMuMRAw
DgYDVQQLEwdBbmRyb2lkMRAwDgYDVQQDEwdBbmRyb2lkMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcD
QgAEU83uXNUiTYE53c2TfdWmqpW20bBXy4KEf5Ff8dV8GLKlVAXKHyjw3Lp9J3E0yCRJ/39XKeuA
AMF7KzSvhD248KNQME4wDAYDVR0TBAUwAwEB/zAdBgNVHQ4EFgQUHRpvuNkzjtBY213BWgUyWWHm
3VYwHwYDVR0jBBgwFoAUHRpvuNkzjtBY213BWgUyWWHm3VYwCgYIKoZIzj0EAwIDRwAwRAIgZsZb
CNBXRkCKLS+LG/41VWj1cTszt9QCdJQNuy7aT94CIDPgn7v5b1ykBVUTuLgRSofxAzHg9R4dg1oA
7tTFAuDg
-----END CERTIFICATE-----
La procedura di verifica legge il checkpoint e i riquadri contenenti le voci di log dal log.
Procedura di verifica
Un log di trasparenza viene implementato con un albero di Merkle costituito da hash. Un nodo foglia contiene dati e un nodo padre contiene l'hash dei relativi figli.
Sull'albero di Merkle vengono eseguiti due calcoli per verificare la proprietà di rilevamento delle manomissioni dei log di trasparenza: la prova di inclusione e la prova di coerenza. La prima dimostra che il log include una voce corrispondente a una versione dell'immagine, ovvero. La voce di log include il digest VBMeta, un hash che rappresenta le immagini del sistema operativo, che può essere restituito da un dispositivo. La seconda dimostra che quando vengono aggiunte nuove voci all'albero, il nuovo checkpoint è coerente con la versione precedente dell'albero.
Per verificare l'immagine di Pixel, esegui la prova di inclusione. L'esecuzione del calcolo della prova di coerenza è facoltativa, perché le terze parti lo fanno continuamente.
Se vuoi familiarizzare con i concetti di verifica della trasparenza binaria di Pixel, puoi seguire le istruzioni riportate di seguito per utilizzare l'immagine in esecuzione sul tuo dispositivo Pixel. Se vuoi eseguire il firmware di Pixel con il massimo grado di affidabilità, consulta la procedura di verifica nella sezione Verifica completa della trasparenza binaria di Pixel.
Prerequisiti di verifica
Prima di procedere alla verifica della conformità dell'artefatto (firmware o APK) alla dichiarazione, assicurati che i seguenti strumenti siano disponibili su un computer connesso alla rete. A seconda della destinazione della verifica, potresti non aver bisogno di tutti.
Golang
Lo strumento di verifica è scritto in Go. Per crearlo, installa Go 1.24 o versioni successive dal sito di Go.
Android Debug Bridge (ADB)
ADB è uno strumento che comunica con un dispositivo Android per ispezionare l'immagine o estrarre gli APK, disponibile sul sito web degli strumenti della piattaforma SDK Android website.
Verificatore della prova di inclusione
Il verificatore della prova di inclusione è un modulo Go che esegue query sul log di trasparenza e indica se un artefatto è incluso nel log.
Viene pubblicato nel repository GitHub android-binary-transparency all'indirizzo
https://github.com/android/android-binary-transparency/tree/main
Per clonare il repository avb di AOSP:
computer:~$ git clone https://android.googlesource.com/platform/external/avb
Per clonare il repository GitHub android-binary-transparency:
computer:~$ git clone https://github.com/android/android-binary-transparency
AAPT2
AAPT2 (Android Asset Packaging Tool) è uno strumento di compilazione utilizzato per compilare e creare pacchetti delle risorse di un'app per Android. Può essere trovato come strumento autonomo in SDK Android Build Tools versione 26.0.2 e successive.
bundletool
bundletool è uno strumento utilizzato per creare un Android App Bundle (AAB). Può essere utilizzato anche per verificare le firme del codice APK.
Può essere scaricato da GitHub.
wget o curl
wget e curl sono strumenti che possono essere utilizzati per recuperare o scaricare file da internet. Assicurati di aver installato uno di questi strumenti, poiché gli script di verifica potrebbero dipendere da essi.
Avbtool
avbtool
viene utilizzato per calcolare il digest VBMeta delle immagini del produttore e la verifica dei
file binari.
Dopo aver clonato il repository avb (come mostrato nella sezione Verificatore della prova di inclusione
), avbtool.py si trova nella directory avb clonata.
Devi aggiungere questa directory alla variabile di ambiente $PATH.
computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL
Fbpacktool
fbpacktool
è uno script Python utilizzato per decomprimere i singoli componenti in Pixel's
bootloader.img.
Non è necessario se stai verificando gli APK.
Questo strumento è importante perché consente a avbtool.py di scoprire le immagini richieste per la verifica.
fbpacktool richiede Python 3.6 o versioni successive e il
PyYAML
(ad es. python3 -m pip install pyyaml).
Per utilizzare questo strumento, scarica i seguenti sei script Python
nella directory in cui si trova avbtool.py,
rendi eseguibile fbpacktool.py,
e crea un link simbolico denominato fbpacktool a fbpacktool.py per comodità.
Se hai 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
Se hai 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 consente di eseguire varie operazioni di crittografia utilizzando il terminale nel flusso di lavoro di verifica. Assicurati che sia installato sul tuo sistema. Puoi controllare il terminale eseguendo il seguente comando e assicurandoti che il risultato restituito non sia vuoto:
computer:~$ which openssl
/usr/bin/openssl
Prova di inclusione
Un proprietario di Pixel può verificare che la sua immagine sia nel log estraendo prima i metadati pertinenti, quindi confrontando l'hash della radice ricalcolato con l'hash della radice contenuto nel checkpoint pubblicato. Se corrispondono, il proprietario di Pixel può essere certo di alcune protezioni esemplificate nel modello di minaccia.
Per verificare che l'immagine su un dispositivo Pixel sia nel log di trasparenza, connettiti al dispositivo con adb, quindi esegui i seguenti comandi:
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 prima sezione recupera i metadati da un dispositivo Pixel nel formato di una voce di log e li salva in /tmp/log_payload.txt.
La seconda sezione esegue il verificatore della prova di inclusione pubblicato nel repository Android Avvio verificato. Questo strumento calcola l'hash della voce di log candidata, recupera gli altri hash necessari per ricalcolare il checkpoint dal log e lo confronta con il checkpoint pubblicato dal log.
L'output del comando viene scritto in stdout:
OKse l'immagine è inclusa nel log,FAILUREin caso contrario.
Prova di coerenza (facoltativa)
Poiché Google rilascia periodicamente nuove versioni dell'immagine del produttore di Pixel, il log di trasparenza è in continua crescita. Un testimone verifica che l'albero cresca in modo coerente con le foglie precedenti. Il testimone tiene traccia dell'hash della radice dell'albero e calcola l'hash della radice candidato successivo richiedendo gli hash delle nuove foglie dall'albero. Affinché un log di trasparenza sia a prova di manomissione, deve essere continuamente controllato per verificarne la coerenza.
Il comportamento di aggiunta solo del log di trasparenza viene controllato attivamente da terze parti, quindi la maggior parte degli utenti non deve farlo da sola, ma chiunque può monitorare la coerenza del log. Google ha pubblicato un'implementazione open source di un testimone in questo repository GitHub. È necessario utilizzare la configurazione specifica del log di trasparenza binaria di Pixel (PixelBT).