戻る  | 前へ | 次へ

アプレットのインストール環境構築

AppletをSIMにインストールする手順を記します


ハードウェア/OSの準備

  • SIMカード
    • ハードウェアシリアル番号が 022 から始まるSIMカード
  • PC
    • Windows10(x64)、などJavaやICカードリーダが動作する環境
  • ICカードリーダ
    • SIMカードを装着し、Appletをインストールするために用います
  • 動作実績

種別 動作確認
SIMカード 刻印が**022** から始まるSIMカード
OS Windows10(X64) など
ICカードリーダ NTTコミュニケーションズ SCR3310v2.0
  NTTコミュニケーションズ CLOUD2700-NTTCom
  Omnikey CardMan 3121 USB CCID interface

ソフトウェアの準備

  1. JDKをインストールします
    • JDK-11以上が必要です
    • ここでは Amazon Corretto-17 をインストールします
  2. GlobalPlatformProを作業用フォルダにダウンロードします
  3. Appletインストール用の鍵情報を取得します
    • こちら に鍵情報の掲載場所があります
    • 鍵は三種類( OEMENC Key OEMMAC Key OEMKEK Key )、各々控えておきます
  4. サンプルアプリを試作 し、作業用フォルダに配置します


インストール手順

  1. 作業用ディレクトリにて以下をシェルから実行します
    • インストール可能なセキュリティドメインはOEM-SSDになります
    • SSDのAIDについては、こちら をご確認ください
    SSD=A0000001156000000000000000011001
    
    # 'C9': Application Specific Parameters
    INSTALL_PARAMS=c903000000
    # 'EF': System specific parameters (GPCS v2.3)
    INSTALL_PARAMS+=ef08c7020100c8020100
    # 'EA': UICC_SYSTEM_SPECIFIC_PARAMETERS (ETSI TS 102226)
    INSTALL_PARAMS+=EA
    INSTALL_PARAMS+=2C # EAパラメータの桁数
    INSTALL_PARAMS+=${EAパラメータ値}
    
    ENC=${取得したOEMENC Key}
    MAC=${取得したOEMMAC Key}
    DEK=${取得したOEMDEK Key}
    java -jar gp.jar -d \
            --connect ${SSD} \
            --key-enc ${ENC} --key-mac ${MAC} --key-dek ${DEK} \
            --install out.cap --params ${INSTALL_PARAMS}
    

アンインストール手順

方法1

インスタンス、パッケージの順で削除します

PACKAGE_AID=${Appletのpackage AID}
INSTANCE_AID=${Appletのinstance AID}
java -jar gp.jar -d \
    --connect ${SSD} \
    --key-enc ${ENC} --key-mac ${MAC} --key-dek ${DEK} \
    --delete ${INSTANCE_AID}

java -jar gp.jar -d \
    --connect ${SSD} \
    --key-enc ${ENC} --key-mac ${MAC} --key-dek ${DEK} \
    --delete ${PACKAGE_AID}

方法2

方法1が正しく動作しない場合、方法2でアンインストールできます

java -jar gp.jar -d \
    --connect ${SSD} \
    --key-enc ${ENC} --key-mac ${MAC} --key-dek ${DEK} \
    --uninstall out.cap

状態確認方法

java -jar gp.jar -d \
    --connect ${OEM_SSD} \
    --key-enc ${ENC} --key-mac ${MAC} --key-dek ${DEK} \
    --list