Pixel バイナリ透明性の技術詳細ページ

Google Pixel のバイナリ透明性ログは、透明性ログ技術を活用しています。

透明性ログの有用性は、 Certificate Transparency で証明されています。Certificate Transparency は、認証局が発行した証明書を Certificate Transparency 公開ログに公開することを義務付けるインターネット プロトコルです。このプロセスにより、証明書の誤発行が大幅に減少し、インターネットのセキュリティが向上しました。多くの Certificate Transparency ログ オペレーターは、 透明性ログの実装に依存しています。これは、transparency.dev にあります。

透明性ログは、マークルツリーを使用して実装されます。このページでは、マークルツリーとバイナリ透明性に関する一般的な知識があることを前提としています。マークルツリーの概要については、 検証可能なデータ構造 をご覧ください。バイナリ 透明性の概要については、 ランディング ページをご覧ください。

ログの実装

Google 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-----

検証プロセスでは、チェックポイントとログエントリを含むタイル がログから読み取られます。

検証プロセス

透明性ログは、ハッシュで構成されるマークルツリーを使用して実装されます。リーフノードにはデータが含まれ、親ノードには子ノードのハッシュが含まれます。

マークルツリーに対して 2 つの計算を実行して、透明性ログの改ざん防止プロパティを検証します。インクルージョン証明と整合性証明です。前者は、ログにイメージ バージョンに対応するエントリが含まれていることを証明します。ログエントリには、デバイスから返される OS イメージを表すハッシュである VBMeta ダイジェストが含まれます。後者は、新しいエントリがツリーに追加されたときに、新しいチェックポイントがツリーの以前のバージョンと整合していることを証明します。

Google Pixel のイメージを検証するには、インクルージョン証明を実行します。整合性証明の計算は、サードパーティが継続的に行っているため、省略可能です。

Google Pixel のバイナリ透明性の検証のコンセプトに慣れるには、次の手順に沿って Google Pixel デバイスで実行されているイメージを使用します。Google Pixel ファームウェアを高い 信頼度で実行する場合は、 Google Pixel のバイナリ透明性の完全検証の検証プロセスをご覧ください。

検証の前提条件

アーティファクト(ファームウェアまたは APK)がクレームに準拠していることを検証する前に、ネットワークに接続されたパソコンで次のツールが使用可能であることを確認してください。 検証対象によっては、すべてが必要ない場合があります。

Golang

検証ツール は Go で記述されています。ビルドするには、Go サイトから Go 1.24 以降をインストールします。 Go サイトからインストールします。

Android Debug Bridge(ADB)

ADB は、Android デバイスと通信してイメージを検査したり、 APK を抽出したりするツールです。Android SDK Platform Tools のウェブサイトで入手できます。

インクルージョン証明検証ツール

インクルージョン証明検証ツールは、透明性ログにクエリを実行し、アーティファクトがログに含まれているかどうかを出力する Go モジュールです。 android-binary-transparency GitHub リポジトリ( 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 リポジトリのクローンを作成すると、クローンされた avb ディレクトリ内に avbtool.py があります。 このディレクトリを $PATH 環境変数に追加する必要があります。

computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL

Fbpacktool

fbpacktool は、Google Pixel bootloader.img の個々のコンポーネントを解凍するために使用される Python スクリプトです。 APK を検証する場合は必要ありません。 このツールは、avbtool.py が検証に必要なイメージを検出できるようにするため、重要です。

fbpacktool には、Python 3.6 以降と PyYAML パッケージ (python3 -m pip install pyyaml など)が必要です。

このツールを使用するには、次の 6 つの 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

インクルージョン証明

Google Pixel の所有者は、まず関連する メタデータを抽出し、再計算したルートハッシュを公開されたチェックポイント に含まれるルートハッシュ と比較することで、イメージがログに含まれていることを確認できます。 一致する場合、Google Pixel の所有者は、脅威モデル に示されている 保護を確信できます。

Google 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

最初のスタンザは、ログエントリの形式で Google Pixel デバイスからメタデータを取得し、/tmp/log_payload.txt に保存します。

2 つ目のスタンザは、 Android 確認付きブート リポジトリで公開されているインクルージョン証明検証ツールを実行します。このツールは、候補のログエントリのハッシュを計算し、チェックポイントをログから再計算するために必要な他のハッシュを取得して、ログによって公開されたチェックポイントと比較します。

コマンドの出力は stdout に書き込まれます。

  • イメージがログに含まれている場合は OK
  • 含まれていない場合は FAILURE

整合性証明(省略可)

Google は Google Pixel のファクトリー イメージの新しいバージョンを定期的にリリースするため、透明性ログは継続的に増加しています。witness は、ツリーが以前のリーフと整合した方法で増加していることを確認します。 witness はツリーのルートハッシュを追跡し、ツリーから新しいリーフハッシュをリクエストして、次の候補のルートハッシュを計算します。透明性ログが改ざん防止されるためには、整合性を継続的に確認する必要があります。

透明性ログの追加専用の動作はサードパーティによって積極的にチェックされるため、ほとんどのユーザーは自分でこれを行う必要はありませんが、誰でもログの整合性をモニタリングできます。Google は、この GitHub リポジトリで witness のオープンソース 実装を公開しています。Google Pixel のバイナリ透明性(Google Pixel BT)ログに固有の 構成 を使用する 必要があります。

特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。

最終更新日 2026-10-16 UTC。