eSIM aktivační kód (LPA)
QR v aktivačním e-mailu eSIM operátora je aktivační kód LPA (Local Profile Assistant) dle GSMA SGP.22. Telefon ho naskenuje, kontaktuje server SM-DP+ (Subscription Manager, Data Preparation Plus), stáhne zašifrovaný profil eSIM a nainstaluje ho, aniž by zákazník cokoliv zadával.
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 je
Payload aktivačního kódu je řetězec pevného formátu se 3 nebo 4 částmi oddělenými $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, identifikátor schématu LPA URI + verze aktivačního kódu. Povinný literál.
- Adresa SM-DP+, FQDN provizního serveru operátora (např.
rsp.example.com). Bez předponyhttps://, pouze hostname. - Matching ID, jedinečné ID (obvykle 16–32 alfanumerických znaků), které váže aktivační kód k jednomu konkrétnímu profilu eSIM na serveru SM-DP+.
- Potvrzovací kód (volitelný), dodatečné tajemství, které musí uživatel zadat k autorizaci stahování. Některými operátory používán jako druhý faktor v aktivačním postupu.
Kanonické testovací vektory
Toto jsou příklady pouze tvaru, skutečný aktivační kód LPA je vázán na konkrétní profil na konkrétním SM-DP+. Testovací vektory kódují formát, nikoliv postup skenování a instalace.
| Případ | Vstupy | Očekávaný kódovaný řetězec |
|---|---|---|
| Minimální (bez potvrzovacího kódu) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| S potvrzovacím kódem | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operátor se subdoménou | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Přenesený postup MSISDN | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Časté problémy
- Předpona https:// v poli SM-DP+. SGP.22 §4.1.1 vyžaduje prosté FQDN. Telefony, které v tomto poli vidí
https://rsp.example.com, považují aktivační kód za chybně formátovaný a odmítají stáhnout. - Znaky $ v Matching ID. Matching ID je alfanumerické.
$v něm koliduje s oddělovačem polí. Operátoři, kteří automaticky generují Matching ID, musí$ze sady znaků vyloučit. - Očekávání jednorázového použití. Většina serverů SM-DP+ zneplatní Matching ID po prvním úspěšném stažení profilu. Sdílení QR znovu poté, co ho zákazník naskenoval, selže, a zákazník si bude myslet, že jste mu dali nefunkční QR.
- Opětovné stažení profilu. Pokud zákazník resetuje zařízení nebo přejde na jiný telefon, nemůže starý QR znovu skenovat. Musí kontaktovat operátora, který vydá nové Matching ID a nový QR.
- Provizování dual-SIM. iOS 17.4+ může uchovávat 8 profilů eSIM, ale současně používat pouze dva. Při skenování se OS ptá uživatele, který fyzický slot SIM nahradit.
- Telefony spravované MDM. Apple Business Manager a Android Enterprise mohou programově provizovat eSIM bez kroku QR. Pokud je vaše flotila spravována MDM, použijte API místo předávání QR kódů uživatelům.
Kompatibilita skenerů
| Zařízení / OS | Podpora | Poznámky |
|---|---|---|
| iOS 17.4+ | Nativní | Aplikace fotoaparátu rozpozná LPA payloady a nabídne instalaci profilu eSIM přímo. |
| iOS 16.x–17.3 | Nativní přes Nastavení > Mobilní data | Skenujte z Nastavení > Mobilní data > Přidat eSIM místo z fotoaparátu. Podpora skenování fotoaparátem přibyla v 17.4. |
| Android 13+ | Nativní | Nastavení > Síť a internet > SIM karty > Přidat eSIM > Skenovat QR. |
| Android 9–12 | Specifické pro OEM | Samsung Galaxy, Google Pixel a některá OnePlus zařízení mají podporu skenování fotoaparátem. Ostatní OEM vyžadují ruční zadání přes Nastavení. |
| Third-party camera apps | Nenativně | Dekódují QR, ale nespustí instalaci eSIM. Uživatelé musí řetězec ručně zkopírovat do Nastavení. |
| Older / non-eSIM phones | N/A | Žádný fyzický hardware eSIM; payload se dekóduje, ale nic se nestane. |
Viz také
- /esim-qr-code/, generátor s předvyplněným formátem LPA.
- /standards/, zpět na index standardů.
- GSMA SGP.22, závazná specifikace.