eSIM kod aktywacyjny (LPA)
QR w e-mailu aktywacyjnym eSIM operatora to kod aktywacyjny LPA (Local Profile Assistant) zgodny z GSMA SGP.22. Telefon skanuje go, łączy się z serwerem SM-DP+, pobiera zaszyfrowany profil eSIM i instaluje go, bez konieczności wpisywania czegokolwiek przez klienta.
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.
Co to jest
Ładunek kodu aktywacyjnego to ciąg o stałym formacie z 3 lub 4 częściami oddzielonymi $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, identyfikator schematu LPA URI + wersja kodu aktywacyjnego. Obowiązkowy literał.
- Adres SM-DP+, FQDN serwera provisioningowego operatora (np.
rsp.example.com). Bez prefiksuhttps://, tylko nazwa hosta. - Matching ID, unikalny identyfikator (zazwyczaj 16–32 znaki alfanumeryczne), który wiąże kod aktywacyjny z konkretnym profilem eSIM na serwerze SM-DP+.
- Kod potwierdzający (opcjonalny), dodatkowy sekret, który użytkownik musi wpisać, aby autoryzować pobieranie. Stosowany przez niektórych operatorów jako drugi składnik w procesie aktywacji.
Kanoniczne wektory testowe
To tylko przykłady kształtu, prawdziwy kod aktywacyjny LPA jest powiązany z konkretnym profilem na konkretnym SM-DP+. Wektory testowe kodują format, nie przepływ skanowania i instalacji.
| Przypadek | Dane wejściowe | Oczekiwany zakodowany ciąg |
|---|---|---|
| Minimalny (bez kodu potwierdzającego) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Z kodem potwierdzającym | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operator z subdomeną | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Przeniesiony przepływ MSISDN | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Typowe pułapki
- Prefiks https:// w polu SM-DP+. SGP.22 §4.1.1 oczekuje czystego FQDN. Telefony, które widzą
https://rsp.example.comw tym miejscu, traktują kod aktywacyjny jako nieprawidłowy i odmawiają pobrania. - Znaki $ w Matching ID. Matching ID jest alfanumeryczne.
$wewnątrz koliduje z separatorem pól. Operatorzy automatycznie generujący Matching ID muszą wykluczyć$z alfabetu. - Oczekiwanie jednorazowego użycia. Większość serwerów SM-DP+ unieważnia Matching ID po pierwszym udanym pobraniu profilu. Ponowne udostępnienie QR po zeskanowaniu przez klienta nie powiedzie się.
- Ponowne pobieranie profilu. Jeśli klient przywróci ustawienia fabryczne lub zmieni telefon, nie może ponownie zeskanować starego QR. Musi skontaktować się z operatorem, który wydaje nowy Matching ID i nowy QR.
- Provisionowanie dual-SIM. iOS 17.4+ może przechowywać 8 profili eSIM, ale używać jednocześnie tylko dwóch. Podczas skanowania system operacyjny pyta użytkownika, który fizyczny slot SIM zastąpić.
- Telefony zarządzane przez MDM. Apple Business Manager i Android Enterprise mogą programowo provisionować eSIM bez kroku QR. Jeśli Twoja flota jest zarządzana przez MDM, używaj API zamiast dawać użytkownikom kody QR.
Kompatybilność skanerów
| Urządzenie / OS | Wsparcie | Uwagi |
|---|---|---|
| iOS 17.4+ | Natywny | Aplikacja aparatu rozpoznaje ładunki LPA i oferuje zainstalowanie profilu eSIM. |
| iOS 16.x–17.3 | Natywny przez Ustawienia > Sieć komórkowa | Skanuj z Ustawień > Sieć komórkowa > Dodaj eSIM zamiast aparatu. Obsługa skanowania aparatem pojawiła się w 17.4. |
| Android 13+ | Natywny | Ustawienia > Sieć i Internet > Karty SIM > Dodaj eSIM > Skanuj QR. |
| Android 9–12 | Specyficzne dla OEM | Samsung Galaxy, Google Pixel i niektóre OnePlus mają obsługę skanowania aparatem. Inne OEM wymagają ręcznego wprowadzania przez Ustawienia. |
| Third-party camera apps | Nie natywnie | Dekodują QR, ale nie wywołują instalacji eSIM. Użytkownicy muszą ręcznie skopiować ciąg do Ustawień. |
| Older / non-eSIM phones | Nie dotyczy | Brak fizycznego sprzętu eSIM; ładunek jest dekodowany, ale nic się nie dzieje. |
Zobacz też
- /esim-qr-code/, generator z wypełnionym formatem LPA.
- /standards/, powrót do indeksu standardów.
- GSMA SGP.22, autorytatywna specyfikacja.