Технические сведения о прозрачности двоичного кода Pixel

Журнал прозрачности исполняемых файлов Pixel использует технологию журнала прозрачности.

Полезность журналов прозрачности была доказана с помощью проверки сертификатов – интернет-протокола, который требует от центров сертификации публиковать выданные ими сертификаты в общедоступных журналах проверки сертификатов. Этот процесс значительно сократил количество неправильно выданных сертификатов, тем самым повысив безопасность интернета. Многие операторы журналов прозрачности сертификатов используют реализацию журналов прозрачности, доступную на сайте transparency.dev.

Журналы прозрачности реализованы с помощью деревьев Меркла. Предполагается, что вы знакомы с концепциями дерева Меркла и прозрачности двоичных файлов. Общие сведения о деревьях Меркла можно найти в статье Проверяемые структуры данных, а о прозрачности двоичных файлов – на целевой странице.

Реализация журналов

Журнал прозрачности исполняемого файла Pixel реализован как дерево Меркла на основе фрагментов. Корневой каталог содержимого фрагментов находится по адресу https://developers.google.com/android/binary_transparency/tile. Примечание. Это не обычная веб-страница. Записи в журнале, хранящиеся в ее подкаталогах, следует читать программно с помощью библиотеки Golang SumDB TLog, а не через браузер.

Подробное описание записей приведено в разделе Содержимое журналов.

Хеш корня дерева Меркла журнала, содержащийся в контрольной точке, доступен по адресу https://developers.google.com/android/binary_transparency/checkpoint.txt. Он представлен в формате контрольной точки. Листья этого дерева Меркла доступны по адресу 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-----

В ходе проверки контрольная точка и фрагменты с записями в журнале считываются из журнала.

Процесс проверки

Журнал прозрачности реализован с помощью дерева Меркла, состоящего из хешей. Листовой узел содержит данные, а родительский узел – хеш дочерних узлов.

Чтобы проверить, не были ли изменены журналы прозрачности, на дереве Меркла выполняются два вычисления: подтверждение включения и подтверждение согласованности. Первый доказывает, что в журнале есть запись, соответствующая версии образа. Запись журнала содержит дайджест VBMeta – хеш, представляющий образы ОС, которые можно получить с устройства. Последнее доказывает, что при добавлении новых записей в дерево новая контрольная точка соответствует предыдущей версии дерева.

Чтобы проверить образ Pixel, выполните проверку включения. Выполнять вычисления для проверки согласованности необязательно, поскольку это постоянно делают третьи стороны.

Если вы хотите ознакомиться с концепциями проверки в Pixel Binary Transparency, следуйте приведенным ниже инструкциям, чтобы использовать образ, запущенный на устройстве Pixel. Если вы хотите запустить встроенное ПО Pixel с максимальной степенью уверенности, ознакомьтесь с процессом проверки на странице Полная проверка прозрачности двоичного кода Pixel.

Что нужно, чтобы получить статус YouTube Live Verified

Прежде чем проверять, соответствует ли артефакт (встроенное ПО или APK) заявлению, убедитесь, что на подключенном к сети компьютере доступны следующие инструменты: В зависимости от цели проверки вам могут понадобиться не все из них.

Golang

Инструмент проверки написан на языке Go. Чтобы собрать его, установите Go 1.24 или более поздней версии с сайта Go.

Android Debug Bridge (ADB)

ADB – это инструмент, который взаимодействует с устройством Android, чтобы проверить изображение или извлечь APK-файлы. Он доступен на сайте Android SDK Platform Tools.

Inclusion Proof verifier

Проверяющее устройство доказательства включения – это модуль Go, который запрашивает журнал прозрачности и определяет, включен ли артефакт в журнал. Он опубликован в хранилище GitHub android-binary-transparency по адресу 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 Asset Packaging Tool) – это инструмент сборки, который используется для компиляции и упаковки ресурсов приложения Android. Его можно найти как отдельный инструмент в Android SDK Build Tools версии 26.0.2 и выше.

bundletool

bundletool – это инструмент для создания наборов Android App Bundle (AAB). Его также можно использовать для проверки подписей кода APK. Его можно скачать с сайта GitHub.

wget или curl;

wget и curl – это инструменты, которые можно использовать для получения или скачивания файлов из интернета. Убедитесь, что у вас установлен один из этих инструментов, так как скрипты проверки могут зависеть от них.

Avbtool

avbtool используется для вычисления дайджеста VBMeta заводских образов и проверки двоичных файлов. После клонирования репозитория avb (как показано в разделе "Проверка доказательства включения") файл avbtool.py можно найти в клонированном каталоге avb. Добавьте этот каталог в переменную среды $PATH.

computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL

Fbpacktool

fbpacktool – это скрипт Python, который используется для распаковки отдельных компонентов в bootloader.img Pixel. Если вы проверяете 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 Verified Boot. Этот инструмент вычисляет хеш записи в журнале-кандидате, извлекает другие хеши, необходимые для повторного вычисления контрольной точки из журнала, и сравнивает его с контрольной точкой, опубликованной журналом.

Выходные данные команды записываются в стандартный поток вывода:

  • OK, если изображение включено в журнал;
  • FAILURE, если это не так.

Доказательство согласованности (необязательно)

Поскольку Google периодически выпускает новые версии заводского образа Pixel, журнал прозрачности постоянно пополняется. Свидетель проверяет, что дерево растет в соответствии с предыдущими листьями. Свидетель отслеживает хеш корня дерева и вычисляет хеш следующего кандидата, запрашивая новые хеши листьев дерева. Чтобы журнал прозрачности был защищен от несанкционированного доступа, его необходимо постоянно проверять на согласованность.

Режим добавления в журнал прозрачности проверяется третьими сторонами, поэтому большинству пользователей не нужно делать это самостоятельно. Однако любой может отслеживать целостность журнала. Google опубликовал реализацию свидетеля с открытым исходным кодом в репозитории GitHub. Необходимо использовать конфигурацию, предназначенную для журнала прозрачности двоичного кода Pixel (PixelBT).