SecondGenerationResidenceCard

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

第一世代の在留カード・特別永住者証明書はResidenceCard、マイナンバーカードに搭載される 特定在留カード等APはSpecifiedResidenceCardAPが対象です。

在留カード等番号

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

暗証番号の正規化

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

試行可能回数

在留カード等番号の照合に試行回数の制限はありません。

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

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

対応するカード種別

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

署名の検証

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

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

トークンの管理

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