パッケージ jp.co.osstech.libjeid

クラス ResidenceCardAP

java.lang.Object
jp.co.osstech.libjeid.ResidenceCardAP
public class ResidenceCardAP extends Object
第1世代在留カード等(在留カード・特別永住者証明書)APを操作するオブジェクトです。

第2世代はResidenceCard2APを使用してください。世代は MF/EF02(カード種別)の データ長で判別されます(JeidReader.detectCardType())。

  • コンストラクタの詳細

    • ResidenceCardAP

      public ResidenceCardAP(JeidReader reader)
      コンストラクタ
      パラメータ:
      reader - JeidReader

  • メソッドの詳細

    • startAC

      public void startAC(RCKey rckey) throws InvalidACKeyException, IOException
      アクセスコントロール(AC)を開始します。
      以降の端末とカード間の通信はセキュアメッセージング(SM)により適宜暗号化されます。在留カード等番号による認証も行われます。
      startBAC(RCKey) + verifySM(RCKey)に相当します。
      パラメータ:
      rckey - 在留カード等番号から作成したRCKeyオブジェクト
      例外:
      IOException - IOエラー
      InvalidACKeyException - 鍵が正しくありません

    • startBAC

      public void startBAC(RCKey rckey) throws InvalidBACKeyException, IOException
      推奨されていません。
      startAC(RCKey)に置き換えられます。
      セキュアメッセージング(SM)を開始します。
      以降の端末とカード間の通信はSMにより適宜暗号化されます。 鍵交換の手順はパスポートのBACと同形式ですが、コマンドのラップ形式は 第1世代在留カード等の独自方式です(RC1SecureMessaging参照)。 このメソッドはstartAC(RCKey)に置き換えられます。 互換性維持のために引き続き使用できますが、非推奨となります。
      パラメータ:
      rckey - 在留カード等番号から作成したRCKeyオブジェクト
      例外:
      IOException - IOエラー
      InvalidBACKeyException - 鍵が正しくありません

    • startBAC

      public void startBAC(RCKey rckey, boolean adjust, boolean sm) throws InvalidBACKeyException, IOException
      推奨されていません。
      startAC(RCKey)に置き換えられます。
      セキュアメッセージング(SM)を開始します。
      以降の端末とカード間の通信はSMにより適宜暗号化されます。 鍵交換の手順はパスポートのBACと同形式ですが、コマンドのラップ形式は 第1世代在留カード等の独自方式です(RC1SecureMessaging参照)。 このメソッドはstartAC(RCKey)に置き換えられます。 互換性維持のために引き続き使用できますが、非推奨となります。
      パラメータ:
      rckey - 在留カード等番号から作成したRCKeyオブジェクト
      adjust - falseを指定してください
      sm - falseを指定してください
      例外:
      IOException - IOエラー
      InvalidBACKeyException - 鍵が正しくありません

    • verifySM

      public void verifySM(RCKey rckey) throws IOException
      推奨されていません。
      startAC(RCKey)に置き換えられます。
      在留カード等番号による認証を行います。
      startBAC(RCKey)が事前に実行されている必要があります。 このメソッドはstartAC(RCKey)に置き換えられます。 互換性維持のために引き続き使用できますが、非推奨となります。
      パラメータ:
      rckey - 在留カード等番号から作成したRCKeyオブジェクト
      例外:
      IOException - IOエラー

    • readFiles

      public RCFiles readFiles() throws IOException
      第1世代在留カード等AP内のすべてのデータを読み出します。
      戻り値:
      第1世代在留カード等AP内のすべてのデータ
      例外:
      IOException - IOエラー

    • readCommonData

      public RCCommonData readCommonData() throws IOException
      共通データ要素を取得します。
      戻り値:
      共通データ要素
      例外:
      IOException - IOエラー

    • readCardType

      public RCCardType readCardType() throws IOException
      カード種別を取得します。
      戻り値:
      カード種別
      例外:
      IOException - IOエラー

    • readCardEntries

      public RCCardEntries readCardEntries() throws IOException
      券面（表）イメージを取得します。
      戻り値:
      券面（表）イメージ
      例外:
      IOException - IOエラー

    • readPhoto

      public RCPhoto readPhoto() throws IOException
      顔画像を取得します。
      戻り値:
      顔画像
      例外:
      IOException - IOエラー

    • readAddress

      public RCAddress readAddress() throws IOException
      住居地（裏面追記）を取得します。
      戻り値:
      住居地（裏面追記）
      例外:
      IOException - IOエラー

    • readComprehensivePermission

      public RCComprehensivePermission readComprehensivePermission() throws IOException
      裏面資格外活動包括許可欄を取得します。
      戻り値:
      裏面資格外活動包括許可欄
      例外:
      IOException - IOエラー

    • readIndividualPermission

      public RCIndividualPermission readIndividualPermission() throws IOException
      裏面資格外活動個別許可欄を取得します。
      戻り値:
      裏面資格外活動個別許可欄
      例外:
      IOException - IOエラー

    • readUpdateStatus

      public RCUpdateStatus readUpdateStatus() throws IOException
      裏面在留期間等更新申請欄を取得します。
      戻り値:
      裏面在留期間等更新申請欄
      例外:
      IOException - IOエラー

    • readSignature

      public RCSignature readSignature() throws IOException
      チェックコード，公開鍵証明書を取得します。
      戻り値:
      チェックコード，公開鍵証明書
      例外:
      IOException - IOエラー