メインコンテンツまでスキップ

モック環境

ポケットサイン社が開発するモック環境向けのデータを使用する環境です。

FeliCa カード(交通系 IC カード、Edy、WAON など)や、 ISO/IEC 14443-4 Type-A カード(クレジットカードなど)を利用して動作検証を行うことができます。 Verify SDK は、これらのカードをタッチすると、運転免許証や在留カードのシミュレートを行い、モック環境向けのデータを読み出します。 Verify CardInfo API は、これらのデータのパース・電子署名の検証を行います。

iOS 26 以降での動作について

iOS 26 において、モック環境用の Verify SDK でカードを読み取る際に iOS 25 以前のバージョンでは反応していた一部カード(クレジットカード等)が反応しない事象が確認されています。

交通系 IC カード などの FeliCa カードは従来通り反応することを確認しています。 モック環境用 Verify SDK を使用して動作確認を行う場合は、FeliCa カード(交通系 IC カード等)をご利用ください。

検証対象のカード

SDK は、FeliCa カード(交通系 IC カード、Edy、WAON など)や、 ISO/IEC 14443-4 Type-A カード(クレジットカードなど)のカード識別子をもとにモック環境向けのデータを自動生成します。 実際の運転免許証や在留カードは利用できません。

モック環境の Verify CardInfo API は上記のデータのパース・検証を行います。 実際の運転免許証や在留カードから読み出したデータのパース・検証は行えません。

本番環境との差異

デフォルトで生成されるデータのうち、顔写真などの画像データはカードに関わらず同じ画像データを生成するようになっています。

以下にカードごとの差異を記載します。

運転免許証

モック環境で運転免許証のシミュレートを行いデータを読み出す場合、 顔写真は読み出すカードに関わらず同じ画像が読み出されます。

また、読み出される電子署名は、ポケットサイン社が発行する秘密鍵による電子署名となります。

第一世代在留カード

モック環境で第一世代在留カードのシミュレートを行いデータを読み出す場合、 顔写真・券面表面画像は読み出すカードに関わらず同じ画像が読み出されます。

また、読み出される電子証明書と電子署名は、ポケットサイン社が発行する証明書となります。

iOS アプリ開発で必要となる設定

モック環境用 Verify SDK を 使用して iOS アプリを開発する場合、開発で用いる FeliCa カードと通信するために Info.plist に以下のように設定を行う必要があります。

Info.plist にキー ISO18092 system codes for NFC Tag Reader Session を追加し、使用するカードに応じて、以下を追加してください。

  • 0003 (交通系 IC カード)
  • FE00 (電子マネー)
  • 88B4 (FeliCa Lite-S)

モック環境の利用方法

Verify CardInfo API のモック環境を利用するには、以下のように設定を行う必要があります。

Verify CardInfo API

モック環境における Verify CardInfo API のエンドポイントは https://verify.mock.p8n.app です。

例えば、在留カードから読み出した電子署名の検証・データのパースを行う場合の URL は、 https://verify.mock.p8n.app/pocketsign.cardinfo.v1.ResidenceCardService/ParseFrontSideContent となります。

Verify SDK

モック環境と本番環境で異なる PocketSign Verify SDK が用意されており、利用するためのパッケージ名が異なります。 モック環境向け SDK の組み込み方は、Getting Startedをご参照ください。