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

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


ハードウェア/OSの準備

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

  • 動作実績

種別 動作確認
SIMカード HSN022 から始まるSIMカード
OS Windows10(X64) など
ICカードリーダ NTTコミュニケーションズ SCR3310v2.0
  NTTコミュニケーションズ CLOUD2700-NTTCom

ソフトウェアの準備

  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