ステップ 2: サンドボックスでテスト ID を作成する

テスト ID を使用すると、実際の政府機関発行の身分証明書を必要とせずに、完全な提示フローを実行し、サービスが Google ウォレットのレスポンスを受け入れて検証することを確認できます。テスト ID を作成するには、サンドボックス デバイスで Google ウォレットに模擬 ePassport をスキャンします。

このページの手順

ステップ A: 2 台の Android デバイスをセットアップする

2 台の Android デバイスが必要です。1 台目のデバイスは ePassport をシミュレートし、2 台目のデバイスはシミュレートされた ePassport から派生した ID パスを追加するデバイスです。

NFC 搭載の 2 台の Android スマートフォンを使用して、Utopia のテスト用 ID パスを Google ウォレットに追加する 3 つのステップのプロセス

要件 デバイス 1: Passport シミュレーター デバイス 2: テスト用の Google ウォレット
職務 NFC ePassport をシミュレートする Google ウォレットにテスト用 ID パスを保持している
設定手順
  1. Utopia ePassport Simulator アプリをインストールします。
  2. アプリを開き、新しいパスポート エントリを追加します。このエントリはステップ B でスキャンします。
  1. Google Play ストアから Google ウォレット アプリをインストールまたは更新します。
  2. Google Play 開発者サービスがバージョン 24.38.xx 以降であることを確認します(確認方法)。
  3. デバイスがデバッグ デバイスまたはユーザーに root 権限のあるデバイスではないことを確認します。
  4. Google ウォレットをサンドボックス環境に切り替えます(個人のデバイスでこの操作を行うと、既存の本番環境データが削除されます)。
  5. @gmail.com の Google アカウントでログインします。

ステップ B: テスト ID をウォレットに追加する

  1. デバイス 2 で Google ウォレット アプリを開き、[ウォレットに追加] をタップします。
  2. [ID] > [ID パス] を選択します。
  3. 画面上の手順に沿って操作を完了します。
    1. MRZ スキャン: デバイス 1 で、シミュレータ アプリで先ほど作成したエントリをタップし、デバイス 2 でパスポートの詳細を手動で入力します。
    2. NFC スキャン: NFC スキャン中に、デバイス 1(シミュレータ アプリの MRZ ページが開いている状態)をデバイス 2 の背面に近づけます。

ステップ C: ウォレットで詳細を確認する

  1. ID パスが Google ウォレットに保存されたら、右上にあるその他メニューをタップし、[ID パスの情報] を選択します。
  2. 表示されたオプションをタップして、想定どおりに動作することを確認します。特に、カードの詳細セクションを開いて、属性が作成したエントリと一致することを確認します。

ステップ 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 つの段階でテストします。

  1. ウェブ検証ツールによるクイック チェック: デバイス 2(またはクロスデバイス QR テスト用のパソコンのブラウザ)で verifier.multipaz.org を開き、ID パスをリクエストします。これにより、独自のコードをテストする前に、デバイスとテスト ID パスが機能していることを確認できます。
  2. 独自のサービスに対してテストする: ステップ 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 パスを削除します。

次のステップ