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

モック環境

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

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/ParseContent となります。

Verify SDK​

モック環境と本番環境で異なる PocketSign Verify SDK が用意されており、利用するためのパッケージ名が異なります。 SDKの組み込みで示す方法がモック環境用の設定ですので、記載通りに進めてください。