アプレットのインストール環境構築¶
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 |
ソフトウェアの準備¶
- JDKをインストールします
- JDK-11以上が必要です
- ここでは Amazon Corretto-17 をインストールします
- GlobalPlatformProを作業用フォルダにダウンロードします
- v20.08.12以降が必須です
- 通常
gp.jar
というファイル名で保存されます - https://github.com/martinpaljak/GlobalPlatformPro/releases
- Appletインストール用の鍵情報を取得します
- こちら に鍵情報の掲載場所があります
- 鍵は三種類(
OEMENC Key
OEMMAC Key
OEMKEK Key
)、各々控えておきます
サンプルアプリを試作 し、作業用フォルダに配置します
インストール手順¶
- 作業用ディレクトリにて以下をシェルから実行します
- インストール可能なセキュリティドメインは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