SpecifiedResidenceCardAP

特定在留カード等（特定在留カード・特定特別永住者証明書）を操作するクラス

特定在留カード等番号

特定在留カード等は暗証番号として在留カード等番号を使用します。 在留カード等番号の仕様は、英大文字2桁＋数字8桁+英大文字2桁 で、例えば、AA12345678BB などです。

暗証番号の正規化

在留カード等番号は、仕様上英小文字が使用されることがないため、入力された小文字を大文字に変換してカードに送信します。

暗証番号誤りに起因する例外

暗証番号の照合を行い、不一致であった場合にはCommandExecutionExceptionが発生します。 このとき、CommandExecutionException.statusはCommandResponseStatus.IncorrectPasswordとなります。

拡張APDU

セキュアメッセージングを伴う読み取りには拡張APDUへの対応が必須です。 端末（NFCリーダー）が拡張APDUに対応していない場合、セキュアメッセージング確立（SET SESSION KEY 送信）前に ExtendedLengthApduNotSupportedExceptionが発生します。 APの有無確認・カード種別の読み出しは平文のみで完結するため、拡張APDU非対応の端末でも実行できます。

対応するカード種別

特定在留カード（カード種別コード 07）・特定特別永住者証明書（カード種別コード 08）に対応しています。 ただし、資格外活動許可欄・在留期間更新等申請欄は特定在留カードにのみ存在するため、 特定特別永住者証明書に対してこれらの読み出しを行った場合はUnsupportedCardTypeExceptionが発生します。

署名の検証

このSDKによって取得したデータは、PocketSign CardInfo Verify APIによって検証することができます。

詳しくはVerify CardInfo APIリファレンスをご参照ください。

トークンの管理

PocketSign Verify APIの利用は、必ずSP事業者が管理するサーバを経由して行ってください。 APIトークンをアプリケーションに含めて配布することは、Verify APIの不正利用につながるため、絶対に行わないでください。