eSIM код активации (LPA)
QR-код в письме об активации eSIM от оператора, это код активации LPA (Local Profile Assistant) согласно GSMA SGP.22. Телефон сканирует его, подключается к серверу SM-DP+, скачивает зашифрованный профиль eSIM и устанавливает его, без того чтобы клиент что-либо вводил.
Canonical spec:GSMA SGP.22, Remote SIM Provisioning Architecture for Consumer Devices v3.0 (current, 2024). The activation-code format is defined in §4.1.1.
Native support: iOS 17.4+ (2024) and Android 13+ (2022) scan these directly from the camera app to provision eSIM profiles.
Native support: iOS 17.4+ (2024) and Android 13+ (2022) scan these directly from the camera app to provision eSIM profiles.
Что это такое
Полезная нагрузка кода активации, строка фиксированного формата с 3 или 4 частями, разделёнными символом $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, идентификатор схемы URI LPA + версия кода активации. Обязательный литерал.
- Адрес SM-DP+, FQDN сервера обеспечения оператора (например,
rsp.example.com). Без префиксаhttps://, только имя хоста. - Matching ID, уникальный идентификатор (обычно 16–32 буквенно-цифровых символа), который привязывает код активации к конкретному профилю eSIM на сервере SM-DP+.
- Confirmation Code (необязательный), дополнительный секрет, который пользователь должен ввести для авторизации загрузки. Используется некоторыми операторами в качестве второго фактора в процессе активации.
Канонические тестовые векторы
Это только примеры формы, реальный код активации LPA привязан к конкретному профилю на конкретном SM-DP+. Тестовые векторы кодируют формат, а не процесс сканирования и установки.
| Случай | Входные данные | Ожидаемая закодированная строка |
|---|---|---|
| Минимальный (без кода подтверждения) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| С кодом подтверждения | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Оператор с поддоменом | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Перенесённый рабочий процесс MSISDN | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Распространённые проблемы
- Префикс https:// в поле SM-DP+. SGP.22 §4.1.1 требует чистый FQDN. Телефоны, которые видят
https://rsp.example.comв этом поле, считают код активации некорректным и отказываются загружать. - Символы $ в Matching ID. Matching ID является буквенно-цифровым. Символ
$внутри него конфликтует с разделителем полей. Операторы, которые автоматически генерируют Matching ID, должны исключить$из алфавита. - Ожидание однократного использования. Большинство серверов SM-DP+ аннулируют Matching ID после первой успешной загрузки профиля. Повторная передача QR-кода после того, как клиент его отсканировал, не сработает.
- Повторная загрузка профиля. Если клиент выполнит сброс до заводских настроек или сменит телефон, он не сможет снова отсканировать старый QR. Ему придётся обратиться к оператору, который выдаст новый Matching ID и новый QR.
- Обеспечение Dual-SIM. iOS 17.4+ может хранить 8 профилей eSIM, но одновременно использовать только два. При сканировании ОС спрашивает пользователя, какой физический слот SIM заменить.
- Телефоны под управлением MDM. Apple Business Manager и Android Enterprise могут программно обеспечивать eSIM без шага QR. Если ваш парк управляется через MDM, используйте API вместо того, чтобы давать пользователям QR-коды.
Совместимость сканеров
| Устройство / ОС | Поддержка | Примечания |
|---|---|---|
| iOS 17.4+ | Нативная | Приложение камеры распознаёт полезные нагрузки LPA и предлагает установить профиль eSIM. |
| iOS 16.x–17.3 | Нативная через Настройки > Сотовая связь | Сканируйте из Настройки > Сотовая связь > Добавить eSIM вместо камеры. Поддержка сканирования камерой появилась в 17.4. |
| Android 13+ | Нативная | Настройки > Сеть и интернет > SIM-карты > Добавить eSIM > Сканировать QR. |
| Android 9–12 | Зависит от OEM | Samsung Galaxy, Google Pixel и некоторые OnePlus поддерживают сканирование камерой. Другие OEM требуют ручного ввода через Настройки. |
| Third-party camera apps | Не нативная | Они декодируют QR, но не запускают установку eSIM. Пользователям нужно вручную скопировать строку в Настройки. |
| Older / non-eSIM phones | Н/Д | Нет физического оборудования eSIM; полезная нагрузка декодируется, но ничего не происходит. |
Смотри также
- /esim-qr-code/, генератор с предварительно заполненным форматом LPA.
- /standards/, вернуться к индексу стандартов.
- GSMA SGP.22, авторитетная спецификация.