catarrh/otaman
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
51820db9ded4fb579f786cc58e995d2aa985cdb4
otaman/README_RUS.md
T

12 KiB
Raw Blame History

OTAMan — APDU Helper & Secured Packet Builder, SIM OTA в PWA

Автономный offline-инструмент на HTML/JS для создания APDU-команд для SIM, USIM и GlobalPlatform RAM, сборки защищённых пакетов по ETSI TS 102 225 и построения BER-TLV скриптов по ETSI TS 102 226.

Откройте index.html в любом современном браузере. Сервер не требуется.

Демо: otaman.atroshin.ru

Сборка

Для стилей используется Tailwind CSS. После клонирования пересоберите CSS:

npm install
npm run build

Интерфейс

Шесть вкладок, каждая с формой и кнопкой «Generate APDU».

Вкладка SIM RFM

CLA = A0 (GSM 11.11 / ISO 7816-4).

Команды

Команда INS Описание
SELECT A4 Выбор EF/DF по FID, пути, dfname или цепочке
UPDATE RECORD DC Обновление записи
UPDATE BINARY D6 Обновление бинарных данных
READ RECORD B2 Чтение записи
READ BINARY B0 Чтение бинарных данных
ERASE BINARY 0E Стирание бинарных данных
ACTIVATE FILE 44 Активация файла
DEACTIVATE FILE 04 Деактивация файла
VERIFY PIN 20 Проверка PIN1 или PIN2
CHANGE PIN 24 Смена PIN1 или PIN2

Методы SELECT

Метод P1 P2 Ввод
By FID 00 00 FID (4 hex)
By full path from MF 08 00 Полный путь от MF
By DF name / AID 04 00 AID
ADF RFM chain 00 00 FID через запятую

Опции

  • Start with SELECT — добавить SELECT перед командой.
  • Selection mode (P2) — для record-команд: Absolute (04), Next (06), Previous (02).
  • Record size — дополнить/обрезать данные до указанного размера.
  • Allow P1/P2 editing — ручное редактирование P1/P2.

Боковая панель конвертации

Поддерживает IMSI, MSISDN, ICCID, SPN, PLMN, Nibble swap.

Ссылки

  • ISO/IEC 7816-4: Organization, security and commands for interchange
  • ETSI TS 102 226: Remote APDU structure for UICC based applications
  • GSM 11.11: SIM-ME Interface

Вкладка USIM RFM

CLA = 00 (ETSI TS 102 221). Те же команды, что и SIM, но SELECT использует P1=09, P2=0C.

Ссылки

  • ETSI TS 102 221: UICC-Terminal Interface
  • ETSI TS 102 226: Remote APDU structure

Вкладка BER-TLV

Построение Expanded Remote Application data format по ETSI TS 102 226 §5.2.1.

Формат

  • Definite (AA): AA + длина + Command TLV
  • Indefinite (AE): AE + 80 + Command TLV + 00 00

Command TLV

Тип Тег Описание
C-APDU 22 APDU
Immediate Action 81 Proactive-команда или action indicator
Error Action 82 Proactive-команда при ошибке
Script Chaining 83 Данные для многопакетных скриптов

Сборщик Immediate Action

  • Action indicator: 81 / 82
  • Proactive command: REFRESH, DISPLAY TEXT, PLAY TONE
  • Custom hex: ручной ввод

Ссылки

  • ETSI TS 102 226 §5.2.1
  • ETSI TS 102 223: Card Application Toolkit
  • ETSI TS 101 220: BER-TLV tag assignments

Вкладка RAM

CLA = 80 (GlobalPlatform v2.3.1). Команды удалённого управления приложениями.

Команды

Команда INS P1 Описание
INSTALL [for load] E6 02 Регистрация загружаемого файла
INSTALL [for install] E6 0C Установка приложения или SD
INSTALL [for make selectable] E6 10 Сделать приложение выбираемым
INSTALL [for registry update] E6 01 Обновление реестра
INSTALL [for extradition] E6 04 Перемещение между SD
LOAD E8 00 Загрузка кода
DELETE E4 00/80 Удаление приложения или SD
GET STATUS F2 80/40/20/10 Статус карты
GET DATA CA tag Чтение объектов данных
STORE DATA E2 00/40/80/C0 Запись данных
SET STATUS F0 80/40/60 Управление жизненным циклом
EXTERNAL AUTHENTICATE 82 00 Аутентификация SCP
INTERNAL AUTHENTICATE 88 00 Challenge-response

Привилегии (INSTALL)

Три байта привилегий по GP Spec Tables 11-7, 11-8, 11-9.

Байт 1:

Бит Привилегия
b8 Security Domain
b7 DAP Verification
b6 Delegated Management
b5 Card Lock
b4 Card Terminate
b3 Card Reset
b2 CVM Management

Байт 2:

Бит Привилегия
b8 Trusted Path
b7 Authorized Management
b6 Token Verification
b5 Global Delete
b4 Global Lock
b3 Global Registry
b2 Final Application

Байт 3:

Бит Привилегия
b8 Receipt Generation

Параметры SIM/UICC Toolkit

  • Tag CA (SIM Toolkit): Priority, Timers, Text Length, Menu Entries, Positions, Channels, MSL, TAR, Access Domain
  • Tag 80 (UICC Toolkit, внутри EA): те же поля без Access Domain

MSL (Minimum Security Level):

Значение Описание
00 Нет проверки
11 RC/CC/DS
12 RC/DS/CC
15 RC/DS/CC + MAC
16 RC/DS/CC + MAC + Cipher
19 RC/DS/CC + MAC + Cipher + DS

GET STATUS P1

Значение Описание
80 Issuer Security Domain (ISD)
40 Applications и SSD
20 Executable Load Files
10 ELF и модули

GET STATUS P2

Значение Описание
40 Первые/все, GP TLV (по умолчанию)
42 Следующие, GP TLV
00 Первые/все, старый формат (deprecated)
02 Следующие, старый формат (deprecated)

GET DATA теги

Тег Объект данных
42 Issuer Identification Number (IIN)
45 Card Image Number (CIN)
66 Card Data / SD Management Data
67 Card Capability Information
E0 Key Information Template
D3 Current Security Level
2F00 List of Applications
FF21 Extended Card Resources Info
5F50 SD Manager URL
C1 Sequence Counter (SCP02/03)
C2 Confirmation Counter
7F21 Certificate (SD public key)
5031 Certificate info (EF.OD)

DELETE P1

Значение Описание
00 Только AID
80 AID и связанные объекты

STORE DATA P1

Значение Описание
00 Последний блок, без шифрования
40 Ещё блоки, без шифрования
80 Последний блок, с шифрованием
C0 Ещё блоки, с шифрованием

SET STATUS

P1: 80 = ISD, 40 = Приложение или SSD, 60 = SD и его приложения

P2: 00 = Разблокировать, 80 = Заблокировать (LOCKED)

Ссылки

  • GlobalPlatform Card Specification v2.3.1
  • ETSI TS 102 226 §8.2.1.3.2: Параметры SIM/UICC Toolkit

Вкладка Secured Packet

Сборка защищённых пакетов по ETSI TS 102 225.

Структура пакета

Поле Размер Описание
CPI 1 Command Packet Identifier (02)
CPL 1 Command Packet Length
CHI 1 Command Header Identifier (01)
CHL 1 Command Header Length
SPI 2 Security Parameter Indicator
KIc 1 Key Identifier для шифрования
KID 1 Key Identifier для MAC
TAR 3 Toolkit Application Reference
CNTR 5 Счётчик повторов
PCNTR 1 Padding counter
RC/CC/DS 8 Контрольная сумма / MAC
Secured Data переменная APDU (с шифрованием при необходимости)

SPI1 (Уровень безопасности)

Значение Безопасность Шифрование Счётчик
00 Нет Нет Нет
01 RC Нет Нет
02 CC/MAC Нет Нет
06 CC/MAC Да Нет
12 CC/MAC Нет Available
16 CC/MAC Да Available
22 CC/MAC Нет Check higher
26 CC/MAC Да Check higher
32 CC/MAC Нет Check +1
36 CC/MAC Да Check +1

SPI2 (PoR)

Значение Режим
00 No PoR
01 PoR required, no security
05 PoR required, RC
09 PoR required, CC
0D PoR required, DS
11 PoR required, ciphered
02 PoR on error, no security
06 PoR on error, RC

Крипто

  • 3DES-CBC шифрование, ключи 8/16/24 байт
  • Retail MAC (ISO 9797-1 MAC algorithm 3)
  • Padding byte: 00 (по умолчанию) или FF

Ссылки

  • ETSI TS 102 225 V13.0.0
  • ETSI TS 102 226
  • ISO 9797-1

Конвертация (боковые панели SIM/USIM)

IMSI → EF.IMSI

15-значный IMSI → 9 байт EF.IMSI.

MSISDN → BCD

Удаление +, добавление f, обмен полубайтов.

ICCID → hex

Обмен полубайтов строки ICCID.

Provider Name → SPN

По 3GPP TS 31.102 §4.2.5. Три варианта кодирования:

  1. GSM 7-bit packed
  2. UCS2 non-BMP
  3. UCS2 BMP non-GSM7

PLMN → EF_PLMNsel / PLMNwAcT

3-байтное BCD-кодирование + опциональный Access Technology.

Nibble swap

Обмен полубайтов hex-строки.

Ссылки

  • 3GPP TS 31.102
  • 3GPP TS 23.038
  • ETSI TS 102 225
  • pySim: enc_imsi()

PWA

OTAMan — Progressive Web App. Можно установить для offline-использования через кнопку INSTALL PWA или через браузер.

  • Service worker кеширует все ресурсы при первом посещении
  • Иконки 192×192 и 512×512

Тема

Тёмная тема поддерживается. Следует системной теме, переключается вручную кнопкой (🌙/☀️). Выбор сохраняется в localStorage.

Локализация

Интерфейс на английском с поддержкой русского языка. Язык определяется из navigator.language. Кнопка переключения (EN/RU) в заголовке сохраняет выбор в localStorage.

Совместимость версий

PWA (OTAMan) Сервер Статус
1.x.x 1.x.x ✅ Совместимы
1.x.x 0.x.x ❌ Сервер устарел
1.x.x 2.x.x+ ⚠️ Сервер новее — обновите PWA

PWA проверяет версию сервера при подключении через GET /api/version.

Reference in New Issue View Git Blame Copy Permalink