UICC HOTP: генерируем одноразовые пароли на SIM-карте
Всем привет!
В прошлых статьях речь шла о возможностях смарт-карты, которые не получают должного освещения в публикациях, а именно: работа с ISD, создание своего SSD, сторонние библиотеки и криптография. Эти темы лишь часть огромного массива, который можно исследовать до самой китайской пасхи, а ведь хочется идти дальше, посмотреть, что еще интересного таит "Вселенная Java Card".
По этой причине я решил долго здесь не задерживаться и идти к новым горизонтам. Итак, встречайте - UICC HOTP!
В этой статье:
Демо: UI/UX;
UICC апплет;
Нюансы параметров инсталляции;
Гоняем тесты в консоли.
Исходники: апплет UICC HOTP, FunGP.
Демо: UI/UX
Дамы и господа, внимание на экран:
На видео следующий сюжет: в 12:04 по полудню пользователь дважды выбирает опцию "Сгенерировать HOTP" и получает один и тот же код "227806". Затем, в 12:05 направляет еще два запроса, но значение уже другое, "859878".
Жизнь пароля быстра и скоротечна: короткая минута но яркое мгновение, за которое он свершает свое предназначение, свой "Opus magnum". А затем забвение, тлен и небытие.
Мда, кажется, мне надо поменьше слушать ALI перед сном. Но отставить меланхолию, продолжаем повествование.
Вшивая HOTP в SIM-карту мы получаем такие преимущества, как доверенный источник, двух-факторая аутентификация "из коробки" и кросс-платформенность - от Нокиа 3310 до Айфона последней модели - UX везде будет одинаковым.
Так, с вводной частью покончили. Огромная благодарность всем, кто пришел за быстрым дофамином, надеюсь вам понравилось!
Остальных же я попрошу остаться. Еще на одну минуту...
UICC апплет
Для данного проекта понадобилась более навороченная железяка:
В России ее хрен достанешь, потому пришлось нехило так повозиться и потратиться, прежде чем мой комплект попал ко мне в руки. Несколько экземпляров готов выставить на продажу (дорого, бартер/интим не предлагать), так что если кому надо - пишите в личку.
Начнем разбирать наш апплет на части. Первым идет конструктор:
public UICC_HOTP(byte[] install_params, short offset, byte length)
{
length = install_params[offset++]; // instance AID length
offset += length;
length = install_params[offset++]; // Control info length
offset += length;
length = install_params[offset++]; // Grab the length of HMAC key
secret_key = new byte[length];
Util.arrayCopyNonAtomic(install_params, offset, secret_key, _00, length);
try {
hmac_key = (HMACKey)KeyBuilder.buildKey(KeyBuilder.ALG_TYPE_HMAC, JCSystem.MEMORY_TYPE_TRANSIENT_RESET, (short)(length * 8), false);
hmac_sign = Signature.getInstance(MessageDigest.ALG_SHA_256, Signature.SIG_CIPHER_HMAC, Cipher.PAD_NULL, true);
} catch (CryptoException e) {
ISOException.throwIt((short)(SW_CRYPTO_EXCEPTION + 1));
}
}Как и в предыдущих проектах, здесь мы сохраняем байты HMAC-ключа в массиве secret_key. Далее в блоке try-catch создаем экземпляры HMACKey и Signature с параметром SIG_CIPHER_HMAC. В целом схема действий такая:
Обратите внимание, что в конструкторе пропущен шаг №3.
Тут, конечно, у меня знатно подгорело. Дело в том, что изначально я не хотел никакого 'secret_key', а сразу же сохранить байты в ключе, однако после долгой отладки выяснилось, что на моих картах (как обстоят дела с другими - не знаю) механизм хранения ключа в постоянной памяти не работает. Может в общем механизм кривой, а может конкретно HMACKey косячит - не знаю, не ведаю, но чтобы воспроизвести проблему надо:
На этапе инсталляции создать ключ HMACKey с типом памяти JCSystem.MEMORY_TYPE_PERSISTENT;
Там же в конструкторе вызвать HMACKey.setKey( /* ключевой материал */ );
После инсталляции (в рабочем режиме) вызов Signature.init(HMACKey) упадет с CryptoException.UNINITIALIZED_key.
Обойти эту проблему пришлось посредством создания HMAC-ключа в переменной памяти, который инициализируется значением из буфера 'secret_key' каждый раз при вызове.
Также будьте внимательны с параметром "KeyLength" метода KeyBuilder.buildKey() т.к. в нем надо задавать длину ключа в битах, не байтах.
Далее идет install():
public static void
install(byte[] install_params, short offset, byte length)
{
UICC_HOTP applet = new UICC_HOTP(install_params, offset, length);
applet.register();
applet.reg = ToolkitRegistrySystem.getEntry();
applet.iid_sim_hotp = applet.reg.initMenuEntry(strings, STR_ALPHA_ID_OFF, STR_ALPHA_ID_LEN, PRO_CMD_SELECT_ITEM, false, (byte)_00, _00);
}Первое, что надо запомнить это последовательность вызовов: сначала Applet.register(), а потом ToolkitRegistrySystem.getEntry(). UICC API for Java Card REL-15 гласит, что в противном случае последний вернет null.
Метод ToolkitRegistry.initMenuEntry() - выполняет две важные задачи:
создает запись "SIM HOTP" в STK-меню телефона и возвращает ее идентификатор на сохранность;
подписывает апплет на событие "EVENT_MENU_SELECTION".
Вообще, тут требуется небольшое отступление с описанием архитектуры фреймворка UICC. В отличии от классической Java Card, SIM-апплет никогда не селектируется (потому-то метод process() остается в виде заглушки). На карте их может быть с десяток, подписанные на различные события (смена локации, поступление звонка/SMS и прочие).
Есть события точечные, например SMS-ка: даже если подписаны все 10 апплетов, операционка дернет тот апплет, чей TAR (Toolkit Application Reference, три байта) указан в метаданных сообщения.
А есть события массовые, например, таймер или запрос STK-меню, по наступлению которых ОС дернет всех подписантов.
Так вот, ToolkitRegistry.initMenuEntry(), подписывает нас на событие, связанное с входом пользователя в STK-меню. Обработка оного осуществляется в методе processToolkit():
public void
processToolkit(short event)
{
EnvelopeHandler env_hdlr;
byte item_id;
try {
switch (event) {
case EVENT_MENU_SELECTION: {
env_hdlr = EnvelopeHandlerSystem.getTheHandler();
item_id = env_hdlr.getItemIdentifier();
if (item_id == iid_sim_hotp) {
hotp_submenu();
}
} break;
default: return;
}
}
catch (ArrayIndexOutOfBoundsException exc) {error_logger(SW_ARRAY_BOUNDARY_EXCEPTION);}
catch (NullPointerException exc) {error_logger(SW_NULL_PTR_EXCEPTION);}
catch (ISOException exc) {error_logger(exc.getReason());}
catch (ToolkitException exc) {error_logger((short)(SW_TOOLKIT_EXCEPTION | exc.getReason()));}
catch (CryptoException exc) {error_logger((short)(SW_CRYPTO_EXCEPTION | exc.getReason()));}
catch (SystemException exc) {error_logger((short)(SW_SYSTEM_EXCEPTION | exc.getReason()));}
catch (Exception exc) {error_logger(SW_UNKNOWN_EXCEPTION);}
}Как было сказано ранее, EVENT_MENU_SELECTION - массовое событие, а потому апплет должен позаботиться о том, чтобы отреагировать только в том случае, если пользователь выбрал именно его. Для этого он сравнивает идентификатор выбранного пункта меню со своим, присвоенным на этапе вызова initMenuEntry() в методе install(). У нас-то простой случай, всего один пункт, а гляньте, что происходит в STK-меню Билайна:
Причем необязательно, чтобы под каждый пункт был свой апплет: метод initMenuEntry() можно вызвать несколько раз, тем самым создав вышепредставленную структуру.
Если пользователь выбрал наш пункт, то processToolkit() передает управление сюда:
protected void
hotp_submenu()
{
byte tag = (byte)(TAG_ITEM | TAG_SET_CR);
ProactiveHandler pro_hdlr = ProactiveHandlerSystem.getTheHandler();
ProactiveResponseHandler pro_resp_hdlr = ProactiveResponseHandlerSystem.getTheHandler();
pro_hdlr.init(PRO_CMD_SELECT_ITEM, (byte)_00, DEV_ID_TERMINAL);
pro_hdlr.appendTLV(TAG_ALPHA_IDENTIFIER, strings, STR_ALPHA_ID_OFF, STR_ALPHA_ID_LEN);
pro_hdlr.appendTLV(tag, ITEM_ID_HOTP, strings, STR_MENU_1_OFF, STR_MENU_1_LEN);
pro_hdlr.appendTLV(tag, ITEM_ID_HELP, strings, STR_MENU_2_OFF, STR_MENU_2_LEN);
if (RES_CMD_PERF != pro_hdlr.send()) {
return;
}
switch (pro_resp_hdlr.getItemIdentifier()) {
case ITEM_ID_HOTP:
option_totp(pro_hdlr, pro_resp_hdlr);
break;
case ITEM_ID_HELP:
option_help(pro_hdlr, pro_resp_hdlr);
break;
}
}где, формируется и посылается проактивная команда "SELECT ITEM" с последующим ожиданием ответа системы. Если команда выполнилась успешно, то пользователь увидит это:
Метод ProactiveResponseHandler.getItemIdentifier() является блокирующим и вернется только после того, как пользователь клацнет на одну из возможных опций. Кликнув на первую поток исполнения перейдет в целевой метод:
private void
option_totp(ProactiveHandler pro_hdlr, ProactiveResponseHandler pro_resp_hdlr)
{
short len;
int dbc = 0;
int divisor = 1000000;
byte[] global_buff;
pro_hdlr.init(PRO_CMD_PROVIDE_LOCAL_INFORMATION, QLFR_DATE_TIME_INFO, DEV_ID_TERMINAL);
if (pro_hdlr.send() != RES_CMD_PERF) {
ISOException.throwIt((short)(SW_TOOLKIT_EXCEPTION | 0x13));
}
if (pro_resp_hdlr.findTLV(TAG_DATE_TIME_AND_TIME_ZONE, (byte)_01) == TLV_NOT_FOUND) {
ISOException.throwIt((short)(SW_TOOLKIT_EXCEPTION | 0x14));
}
global_buff = UICCPlatform.getTheVolatileByteArray();
len = (short)(pro_resp_hdlr.getValueLength() - 2); // truncate seconds and time zone
pro_resp_hdlr.copyValue(_00, global_buff, _00, len);
hmac_key.setKey(secret_key, _00, (short)secret_key.length);
hmac_sign.init(hmac_key, Signature.MODE_SIGN);
len = hmac_sign.sign(global_buff, _00, len, global_buff, _00);
if (len != _32) {
ISOException.throwIt(ISO7816.SW_DATA_INVALID);
}
len = (short)((short)global_buff[31] & (short)0x000F);
dbc = get_int(global_buff, len);
// 4. Generate DBC (Dynamic Binary Code)
dbc %= divisor;
int_to_dec_str(dbc, global_buff, _00, _06);
pro_hdlr.initDisplayText((byte)0x81, (byte)_04, global_buff, _00, _06);
pro_hdlr.send();
}Давайте разберем его на части.
Метод pro_hdlr.init(PRO_CMD_PROVIDE_LOCAL_INFORMATION) формирует запрос текущей даты и времени, затем вызывается pro_hdlr.send() который непосредственно шлет его. Если телефон поддерживает такую фичу, то апплету надо дернуть метод pro_resp_hdlr.findTLV(), чтобы получить приблизительно такую строку:
"26 07 620152212595 21" , где:
26 - тег DATE TIME параметра;
07 - длина данных;
62.01.52 21:25:95 - YY.MM.DD HH:MM:SS в формате BCD. Ниблы надо развернуть и тогда получим 26.10.25 12:52:59.
21 - кодировка часового пояса. Также надо развернуть и получим "12". Согласно ETSI 123 040, часовые пояса кодируются с интервалом 15 минут к UTC за единицу измерения. Таким образом: 12 единиц * 15 минут = 180 минут = +3 часа к UTC.
Обратите внимание на этот блок кода:
global_buff = UICCPlatform.getTheVolatileByteArray();
len = (short)(pro_resp_hdlr.getValueLength() - 2); // truncate seconds and time zone
pro_resp_hdlr.copyValue(_00, global_buff, _00, len);На первой строке мы берем указатель на глобальный буфер. Очень удобная штука, избавляет нас от необходимости создавать свой. В него мы кладем байты даты и времени но отсекаем секунды и часовой пояс. Секунды отсекаем, чтобы код обновлялся лишь раз в минуту, а не каждую секунду, а часовой пояс в данной реализации не требуется. В конце, в соответствии с RFC 4226 генерируем одноразовый пароль. Нюансы реализации я оставлю за скобками.
Завершает процедуру вызов pro_hdlr.initDisplayText(), который выведет на дисплей шесть цифр одноразового пароля.
Собрать .cap-файл необходимо командой ant:
Нюансы параметров инсталляции
Традиционно для тестирования воспользуемся библиотекой FunGP. Скачайте (или подтяните обновления), установите (README.md в помощь) и создайте в корневой директории папку 'resources' - в нее надо поместить апплет UICC_HOTP.cap и .json-файл с ключами от сим-карты. Если с апплетом все понятно, то .json-файл требует объяснения.
На скрине изображен рабочий проект. В папке 'resources' лежат .cap-файлы и sysmocom-cards.json, хранящий записи вида "IMSI, счетчик, ключи, идентификатор ключей, ICCID". Карта, вставленная в ридер будет однозначно идентифицирована по полю IMSI. Такое решение обусловлено наличием хреновой кучи тестовых карт и нежеланием вручную сопоставлять ICCID и ключи.
Переходим к первому скрипту: tests/UICC_HOTP/01_install.py
from fun_gp import Reader, SmartCard, CCM, UICC, InstallParams, \
SIMParams, UICCParams, SCP80, SCP80Params,\
RESOURCES_DIR
from fun_gp import lv_hex, encode_bcd
import time
card_deck_path = RESOURCES_DIR / "sysmocom-cards.json"
path_to_applet = RESOURCES_DIR / 'UICC_HOTP.cap'
sys_params = UICCParams(msl='16', tar='46554E', text_length='14', menu_entries='010100')
install_params = InstallParams(
app_params =
'01020304050607000010203040506070 01020304050607000010203040506070\
01020304050607000010203040506070 01020304050607000010203040506070',
sim_params=sys_params
)
def main():
with Reader() as reader:
scp80 = SCP80(card_deck_path, reader.plain_apdu)
scp80.set_params(SCP80Params(spi='0621', tar='000000', kic=0x05, kid=0x05))
uicc = UICC(reader.plain_apdu, scp80)
uicc.terminal_profile()
startTime = time.time()
uicc.install_app_scp80(path_to_applet, install_params)
duration = time.time() - startTime
print(f'duration: {str(round(duration, 2))}\n')
main()Надеюсь его лаконичный вид это не мое субъективное восприятие, а общепризнаваемый факт. Давайте по-порядку:
Объект UICCParams() реализует спецификацию ETSI 102 226, в частности, параметры команды install (п. 8.2.1.3). Учтите, что они разнятся для SIM и UICC:
Экземпляр UICCParams(), вместе с 64-байтовым ключом HMAC передается в InstallParams(), который, в свою очередь, будет передан командой install[for install & make selectable]. Но это в самом конце, сейчас же надо разобраться с SCP80Params().
class SCP80Params:
def __init__(self, spi:str='1621', tar:str='000000', kic:int=0x00, kid:int=0x00, por:int=0x00):
self.spi = hex_to_bytes(spi)
self.kic = kic
self.kid = kid
self.tar = hex_to_bytes(tar)
self.por = por
def _build_list(self):
return self.spi + [self.kic] + [self.kid] + self.tar + [self.por]
def __getitem__(self, index):
return self._build_list()[index]
def __len__(self):
return len(self._build_list())Этот класс имплементирует параметры коммуникации по SCP80 в соответствии с ETSI 102 225:
SPI - определяет уровень накладываемой криптографии. По дефолту требуется инкремент счетчика, шифрование и имитовставка, PoR (Подтверждение получения SMS) только в случае возникновения ошибки.
TAR - по дефолту мы обращаемся к ISD. Вообще, стандартизированные TAR'ы можно посмотреть в ETSI 102 220, annex D.
KIc - параметры шифрования сообщений.
KID - параметры выработки имитовставки.
Конкретно в нашем случае применимы следующие значения:
SPI = 0621: счетчик не инкрементировать (не надо ушатывать flash).
KIc = 0x05: шифруем на 3DES-CBC с двумя ключами.
KID = 0x05: имитовставка на 3DES-CBC с двумя ключами.
Имейте в виду, что есть карты, где длина ключей 24 байта, тогда KIc/KID будут 0x09.
Ну и под конец вызывается install_app_scp80(), который в процессе работы выводит следующий лог:
Лог команды install_app_scp80
(.venv) PS C:\Users\tislamov\develop\FunGP\tests\UICC_HOTP> .\01_install.py
Connecting to 'ACS ACR39U ICC Reader 0' reader
Command: select MF
>> 00A4 000C 02 3F00
<< 9000 [OK ]
duration: 0.0
Command: select DF GSM
>> 00A4 000C 02 7F20
<< 9000 [OK ]
duration: 0.01
Command: select EF IMSI
>> 00A4 000C 02 6F07
<< 9000 [OK ]
duration: 0.0
Command: read IMSI
>> 00B0 0000 00
<< 6c09 [Response bytes still available (CAT) (9 bytes remaining)]
Repeat command with Le set to 09
>> 00B0 0000 09
<< 089999070000818304
<< 9000 [OK ]
duration: 0.0
IMSI: 809999700000183840
Command: Terminal Profile
>> 8010 0000 0A FFFFFFFFFFFFFFFFFFFF
<< 9000 [OK ]
duration: 0.0
Command: Envelope [SCP80] INSTALL(for load)
>> 80C2 0000 5C D15A8202838106038121438B4F600A8110325476987FF6622081410200213D0270000038150621151500000035A18D9948078ACEF8984857C41E4E19B7F749C22DC45034A7F8A116F67B57D96B28AE1E2AB1D5CDFA8653F31F724DA0
<< 9134 [To be classified ]
duration: 0.05
Command: Fetch
>> 8012 0000 34
<< D032810301130082028183050086038121438B2041000A81103254769800F614027100000F0A0000000000000005000002900000
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : SEND SHORT MESSAGE
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : Network
Alpha identifier:
Address : 1234
SMS type : SMS-SUBMIT
Message ref : 00
number length : 10
TON/NPI : 81
dest address : 0123456789
PID : 00
DCS : f6
TP-ValPeriod : 14
TP-UDL : 2
TP-UD : 7100000F0A0000000000000005000002900000
Command: Terminal response
>> 8014 0000 0C 810301130082028281830100
<< 9000 [OK ]
duration: 0.0
Command: Envelope [SCP80] LOAD
>> 80C2 0000 AD D181AA8202838106038121438B819E600A8110325476987FF6622081410200218C070003010201700000E8150621151500000054323ADCDD870EA6A3E2DB8513CC56E95EC17FEEC3CB08B9A27F5A416887CA11CDA378FEE97F401F5BF0244340FBB1D6AFF6D1ECC3DCF8C435776375FA92C66D9283939F9896B5C539538923A031FC0C6683AA259666213AB16608DB052A5545AAFD30C99F9105F4967E1AE659549D4B87903A1FB8E4E69F818A
<< 9000 [OK ]
duration: 0.02
Command: Envelope [SCP80] LOAD
>> 80C2 0000 8C D181898202838106038121438B7E600A8110325476987FF6622081410200216C0500030102022976BE30F472A38FAA979794B8CD2EE990B3A0B3D367AF2903E4A9A142F0AFFF2EBA45C4ECFDCD9D9CAAF011CCF89FDFEC4CC521595DC8C170054F52F9D72FD01FBDE2C9FEFAD8FD965507545522B9882EF59B286C10943B1EA4B5B78607AD7C5C64213AFB91
<< 9134 [To be classified ]
duration: 0.38
Command: Fetch
>> 8012 0000 34
<< D032810301130082028183050086038121438B2041000A81103254769800F614027100000F0A0000000000000005000002900000
<< 9000 [OK ]
duration: 0.01
command number: 01
command type : SEND SHORT MESSAGE
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : Network
Alpha identifier:
Address : 1234
SMS type : SMS-SUBMIT
Message ref : 00
number length : 10
TON/NPI : 81
dest address : 0123456789
PID : 00
DCS : f6
TP-ValPeriod : 14
TP-UDL : 2
TP-UD : 7100000F0A0000000000000005000002900000
Command: Terminal response
>> 8014 0000 0C 810301130082028281830100
<< 9000 [OK ]
duration: 0.0
////////// ДЛИННАЯ ЦЕПОЧКА ИЗ КОМАНД LOAD //////////
Command: Envelope INSTALL[for install and make selectable]
>> 80C2 0000 AD D181AA8202838106038121438B819E600A8110325476987FF6622081410200218C070003010201700000B01506211515000000AE74094D203F1349F0CF4075C2A1359072E95D4ED473A804D054BA3C6651ACEB18CD19289C295C7ED41435C7BD73487EB4F359EB86D8AF0514BC06AB35302D935DBCBC89BCDBFBBBED065A02E23BD9FA4336528CE167FF38DAA1ACF21F20669DAFF1A07EA75990070FDD23C7DB31C2733E37BCCAD45A54A03CDE
<< 9000 [OK ]
duration: 0.02
Command: Envelope INSTALL[for install and make selectable]
>> 80C2 0000 53 D1518202838106038121438B46600A8110325476987FF6622081410200213405000301020255B8A0704C82295D4917C58FDFE44E3F4E64FED95B179A02C34BF700338BA8276A062049F5A3F5AE2A82C0003C38
<< 9134 [To be classified ]
duration: 0.59
Command: Fetch
>> 8012 0000 34
<< D032810301130082028183050086038121438B2041000A81103254769800F614027100000F0A0000000000000005000002900000
<< 9000 [OK ]
duration: 0.02
command number: 01
command type : SEND SHORT MESSAGE
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : Network
Alpha identifier:
Address : 1234
SMS type : SMS-SUBMIT
Message ref : 00
number length : 10
TON/NPI : 81
dest address : 0123456789
PID : 00
DCS : f6
TP-ValPeriod : 14
TP-UDL : 2
TP-UD : 7100000F0A0000000000000005000002900000
Command: Terminal response
>> 8014 0000 0C 810301130082028281830100
<< 912a [To be classified ]
duration: 0.0
Command: Fetch
>> 8012 0000 2A
<< D028810301250082028182850C53544B2053657276696365738F0C8081080853494D20484F5450180124
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : SET UP MENU
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : ME
Alpha identifier: TK Services
item 80: SIM HOTP (plain hex: 8081080853494D20484F5450)
Command: Terminal response
>> 8014 0000 0C 810301250082028281830100
<< 9000 [OK ]
duration: 0.01
***** CAP-file parameters *****
Package AID: A000000087
Applet AID: A0000000875549434320484F5450
Applet size: 1520 bytes.
Total SMS sent: 9
duration: 3.42
Reader: context has been released.
JSON file has been updated.
(.venv) PS C:\Users\tislamov\develop\FunGP\tests\UICC_HOTP>Я добавил в FunGP модуль "proactive_parser.py", который худо-бедно приводит байты в человеко-читаемые строки, но он требует доработки. Этот же парсер поможет нам отлаживаться в консоли. Поехали!
Гоняем тесты в консоли
Переключаемся на скрипт 03_display_hotp.py:
def main():
with Reader() as reader:
scp80 = SCP80(card_deck_path, reader.plain_apdu)
scp80.set_params(SCP80Params(spi='0621', tar='46554E', kic=0x05, kid=0x05))
uicc = UICC(reader.plain_apdu, scp80)
uicc.terminal_profile()
event_menu_selection(uicc, 0x80, 0x01)В методе main() инициализируем ридер и карту точно такими же параметрами, что использовались на этапе инсталляции. затем вызываем event_menu_selection():
def event_menu_selection(uicc:UICC, menu_id:int, item_id:int):
event = MenuSelection(menu_id)
add_info_select = [0x10, 0x01, item_id]
curr_time = datetime.now()
curr_time = encode_bcd(curr_time.strftime("%y%m%d%H%M%S"))
add_info_date_time = hex_to_bytes(f'26 07 {curr_time}21')
resp, sw1, sw2 = uicc.envelope(event[0:], cmd_name=f'[EVENT DOWNLOAD] SELECT HOTP option')
while sw1 == 0x91:
uicc.gen_res.add_info = []
resp, _, _ = uicc.fetch(sw2)
cmd_type = uicc.parser.parse(resp)
if cmd_type[3] == 0x26: # DATE/TIME
uicc.gen_res.add_info = add_info_date_time
elif cmd_type[3] == 0x24: # SELECT ITEM
uicc.gen_res.add_info = add_info_select
_, sw1, sw2 = uicc.terminal_response(cmd_type, uicc.gen_res)
print(f"\ncurrent date: {curr_time}\n")Создаем экземпляр класса MenuSelection, реализующий требования п. 7.2 ETSI 102 223, далее запрашиваем текущую дату и время и формируем TLV-структуру "DATE TIME".
Теперь главное - симулируем телефон: шлем на карту команду ENVELOPE типа "пользователь вошел в STK-меню":
Command: Envelope [EVENT DOWNLOAD] SELECT HOTP option
>> 80C2 0000 09 D30782020181900180
<< 9142 [To be classified ]
duration: 0.0Как только ToolkitRegistry передаст его нашему апплету, тот сразу же обработает его и скажет, что у него есть '42 (66) байт проактивной команды':
Command: Fetch
>> 8012 0000 42
<< D040810301240082028182050B81080853494D20484F54508F1601811208A1B3B5BDB5C0B8C0BEB2B0C2CC20484F54508F1002810C089DC3B6BDB020BFBEBCBEC9CC
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : SELECT ITEM
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : ME
Alpha ID : SIM HOTP
item 01: Сгенерировать HOTP (plain hex: 01811208A1B3B5BDB5C0B8C0BEB2B0C2CC20484F5450)
item 02: Нужна помощь (plain hex: 02810C089DC3B6BDB020BFBEBCBEC9CC)В этот самый момент на экране высвечивается наше меню. На эту команду наш скрипт отвечает здесь:
while sw1 == 0x91:
uicc.gen_res.add_info = []
resp, _, _ = uicc.fetch(sw2)
cmd_type = uicc.parser.parse(resp)
if cmd_type[3] == 0x26: # DATE/TIME
uicc.gen_res.add_info = add_info_date_time
elif cmd_type[3] == 0x24: # SELECT ITEM
uicc.gen_res.add_info = add_info_select <<<==== вот тут отвечаетCommand: Terminal response
>> 8014 0000 0F 810301240082028281830100100101
<< 910b [To be classified ]
duration: 0.01В ответе Терминал говорит: пользователь выбрал пункт №1. На что карта парирует: "тогда у меня еще "0B (11) байт проактивной команды":
Command: Fetch
>> 8012 0000 0B
<< D009810301260382028182
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : PROVIDE LOCAL INFORMATION
qualifier : 03 (see ETSI 102 223, c. 8.6)
from : UICC
to : MEЗдесь карта непосредственно запрашивает текущую дату и время. На эту команду ответ формируется здесь:
while sw1 == 0x91:
uicc.gen_res.add_info = []
resp, _, _ = uicc.fetch(sw2)
cmd_type = uicc.parser.parse(resp)
if cmd_type[3] == 0x26: # DATE/TIME
uicc.gen_res.add_info = add_info_date_time <<<==== вот тут отвечает
elif cmd_type[3] == 0x24: # SELECT ITEM
uicc.gen_res.add_info = add_info_selectCommand: Terminal response
>> 8014 0000 15 810301260382028281830100260762016211916221
<< 9114 [To be classified ]
duration: 0.1Получив запрашиваемые данные, наш апплет формирует команду DISPLAY TEXT:
Command: Fetch
>> 8012 0000 14
<< D0128103012181820281028D0704323137393734
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : DISPLAY TEXT
qualifier : 81 (see ETSI 102 223, c. 8.6)
from : UICC
to : Display
DCS : 04
Message : 217974В последней строке как раз получаем шесть цифр одноразового пароля.
Полный лог скрипта
(.venv) PS C:\Users\tislamov\develop\FunGP\tests\UICC_HOTP> .\03_display_hotp.py
Connecting to 'ACS ACR39U ICC Reader 0' reader
Command: select MF
>> 00A4 000C 02 3F00
<< 9000 [OK ]
duration: 0.0
Command: select DF GSM
>> 00A4 000C 02 7F20
<< 9000 [OK ]
duration: 0.01
Command: select EF IMSI
>> 00A4 000C 02 6F07
<< 9000 [OK ]
duration: 0.0
Command: read IMSI
>> 00B0 0000 00
<< 6c09 [Response bytes still available (CAT) (9 bytes remaining)]
Repeat command with Le set to 09
>> 00B0 0000 09
<< 089999070000818304
<< 9000 [OK ]
duration: 0.0
IMSI: 809999700000183840
Command: Terminal Profile
>> 8010 0000 0A FFFFFFFFFFFFFFFFFFFF
<< 912a [To be classified ]
duration: 0.01
Command: Fetch
>> 8012 0000 2A
<< D028810301250082028182850C53544B2053657276696365738F0C8081080853494D20484F5450180124
<< 9000 [OK ]
duration: 0.01
command number: 01
command type : SET UP MENU
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : ME
Alpha ID : TK Services
item 80: SIM HOTP (plain hex: 8081080853494D20484F5450)
Command: Terminal response
>> 8014 0000 0C 810301250082028281830100
<< 9000 [OK ]
duration: 0.01
Command: Envelope [EVENT DOWNLOAD] SELECT HOTP option
>> 80C2 0000 09 D30782020181900180
<< 9142 [To be classified ]
duration: 0.01
Command: Fetch
>> 8012 0000 42
<< D040810301240082028182050B81080853494D20484F54508F1601811208A1B3B5BDB5C0B8C0BEB2B0C2CC20484F54508F1002810C089DC3B6BDB020BFBEBCBEC9CC
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : SELECT ITEM
qualifier : 00 (see ETSI 102 223, c. 8.6)
from : UICC
to : ME
Alpha ID : SIM HOTP
item 01: Сгенерировать HOTP (plain hex: 01811208A1B3B5BDB5C0B8C0BEB2B0C2CC20484F5450)
item 02: Нужна помощь (plain hex: 02810C089DC3B6BDB020BFBEBCBEC9CC)
Command: Terminal response
>> 8014 0000 0F 810301240082028281830100100101
<< 910b [To be classified ]
duration: 0.01
Command: Fetch
>> 8012 0000 0B
<< D009810301260382028182
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : PROVIDE LOCAL INFORMATION
qualifier : 03 (see ETSI 102 223, c. 8.6)
from : UICC
to : ME
Command: Terminal response
>> 8014 0000 15 810301260382028281830100260762016211916221
<< 9114 [To be classified ]
duration: 0.1
Command: Fetch
>> 8012 0000 14
<< D0128103012181820281028D0704323137393734
<< 9000 [OK ]
duration: 0.0
command number: 01
command type : DISPLAY TEXT
qualifier : 81 (see ETSI 102 223, c. 8.6)
from : UICC
to : Display
DCS : 04
Message : 217974
Command: Terminal response
>> 8014 0000 0C 810301218182028281830100
<< 9000 [OK ]
duration: 0.0На этом все, дорогой читатель, надеюсь, этот материал кому-нибудь да подсобит в преодолении кривой обучаемости столько витиеватого направления, именуемого "Java Card".
KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.