テスト ID を使用すると、実際の政府機関発行の身分証明書を必要とせずに、完全な提示フローを実行し、サービスが Google ウォレットのレスポンスを受け入れて検証することを確認できます。テスト ID を作成するには、サンドボックス デバイスで Google ウォレットに模擬 ePassport をスキャンします。
コースを選択 RP、VR、または対面式
このページの手順
ステップ A: 2 台の Android デバイスをセットアップする
2 台の Android デバイスが必要です。1 台目のデバイスは ePassport をシミュレートし、2 台目のデバイスはシミュレートされた ePassport から派生した ID パスを追加するデバイスです。

| 要件 | デバイス 1: Passport シミュレーター | デバイス 2: テスト用の Google ウォレット |
|---|---|---|
| 職務 | NFC ePassport をシミュレートする | Google ウォレットにテスト用 ID パスを保持している |
| 設定手順 |
|
ステップ B: テスト ID をウォレットに追加する
- デバイス 2 で Google ウォレット アプリを開き、[ウォレットに追加] をタップします。
- [ID] > [ID パス] を選択します。
- 画面上の手順に沿って操作を完了します。
- MRZ スキャン: デバイス 1 で、シミュレータ アプリで先ほど作成したエントリをタップし、デバイス 2 でパスポートの詳細を手動で入力します。
- NFC スキャン: NFC スキャン中に、デバイス 1(シミュレータ アプリの MRZ ページが開いている状態)をデバイス 2 の背面に近づけます。
ステップ C: ウォレットで詳細を確認する
- ID パスが Google ウォレットに保存されたら、右上にあるその他メニューをタップし、[ID パスの情報] を選択します。
- 表示されたオプションをタップして、想定どおりに動作することを確認します。特に、カードの詳細セクションを開いて、属性が作成したエントリと一致することを確認します。
ステップ D: リクエストでテスト ID を使用する
サンドボックス テスト ID は ID パスです。Google ウォレットが一致して提示するには、OpenID4VP dcql_query が ID パスのドキュメント タイプをリクエストする必要があります。
com.google.wallet.idcard.1(ID パス)org.iso.23220.photoid.1(ISO 写真付き身分証明書ドキュメント タイプを使用した ID パス)
モバイル運転免許証(org.iso.18013.5.1.mDL)のみをリクエストするリクエストは、ユートピア テスト ID パスと一致しません。対象となる認証情報を受け入れるには、ステップ 3.A: リクエストの形式を設定するのマルチ認証情報 dcql_query サンプルを使用し、利用可能なクレームパスについてはサポートされている認証情報と属性を確認してください。
新しい ID パスを次の 2 つの段階でテストします。
- ウェブ検証ツールによるクイック チェック: デバイス 2(またはクロスデバイス QR テスト用のパソコンのブラウザ)で verifier.multipaz.org を開き、ID パスをリクエストします。これにより、独自のコードをテストする前に、デバイスとテスト ID パスが機能していることを確認できます。
- 独自のサービスに対してテストする: ステップ 3 を完了したら、サンドボックス テストキー(証明書利用者)またはサンドボックス ルート CA(検証者登録機関)で署名されたリクエストを送信し、Utopia サンドボックス証明書に対して
issuerAuthを検証するようにサーバーを構成します。
トラブルシューティング
| 問題 | 確認ポイント |
|---|---|
| [設定] に [TapAndPay Environment] が表示されない | お使いの Google アカウントは、まだサンドボックスの許可リストに登録されていません。ステップ 1.A: サンドボックスへのアクセスをリクエストするをご覧ください。 |
| [ウォレットに追加] に [ID パス] オプションが表示されない | デバイス 2 がサンドボックス モード(ステップ 1.C)で、@gmail.com アカウントでログインしており、root 権限取得済み/デバッグではなく、Google Play 開発者サービス 24.38.xx 以降を実行していることを確認します。 |
| リクエストのテスト時に「デジタル ID を利用できません」と表示される | リクエストに com.google.wallet.idcard.1 または org.iso.23220.photoid.1 が含まれていること、およびデバイス 2 がまだサンドボックス モードであることを確認します。 |
| Google ウォレットの同意画面の前にリクエストが失敗する | JWS 署名、x5c 証明書ヘッダー、client_id(x509_hash)、gw_rp_metadata_bytes を確認します。 |
ウォレットからテスト用 ID パスを削除する
ID 画面の右上にあるその他メニューをタップして [削除] を選択し、画面上の指示に沿ってテスト用 ID パスを削除します。