Codice di attivazione eSIM (LPA)
Il QR nell'e-mail di attivazione eSIM di un operatore è un codice di attivazione LPA (Local Profile Assistant) secondo GSMA SGP.22. Il telefono lo scansiona, contatta il server SM-DP+ (Subscription Manager, Data Preparation Plus), scarica il profilo eSIM cifrato e lo installa, il tutto senza che il cliente digiti nulla.
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.
Cos'è
Il payload del codice di attivazione è una stringa a formato fisso con 3 o 4 parti separate da $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, l'identificatore dello schema URI LPA + versione del codice di attivazione. Letterale obbligatorio.
- Indirizzo SM-DP+, l'FQDN del server di provisioning dell'operatore (es.
rsp.example.com). Nessun prefissohttps://, solo il nome host. - Matching ID, un ID univoco (di solito 16–32 caratteri alfanumerici) che collega il codice di attivazione a uno specifico profilo eSIM sul server SM-DP+.
- Codice di conferma (opzionale), un segreto aggiuntivo che l'utente deve digitare per autorizzare il download. Usato da alcuni operatori come secondo fattore nel flusso di attivazione.
Vettori di test canonici
Questi sono esempi di forma soltanto, un vero codice di attivazione LPA è legato a un profilo specifico su un SM-DP+ specifico. I vettori di test codificano il formato, non un flusso di scansione per installare.
| Caso | Input | Stringa codificata attesa |
|---|---|---|
| Minimale (nessun codice di conferma) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Con codice di conferma | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operatore con sottodominio | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Flusso MSISDN portato | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Insidie comuni
- Prefisso https:// nel campo SM-DP+. SGP.22 §4.1.1 vuole l'FQDN nudo. I telefoni che vedono
https://rsp.example.comin quel campo trattano il codice di attivazione come malformato e si rifiutano di scaricare. - Caratteri $ nel Matching ID. Il Matching ID è alfanumerico. Un
$al suo interno si scontra con il separatore di campo. Gli operatori che auto-generano Matching ID devono escludere$dall'alfabeto. - Aspettativa di uso singolo. La maggior parte dei server SM-DP+ invalida il Matching ID dopo il primo download di profilo riuscito. Ricondividere il QR dopo che il cliente lo ha scansionato fallirà, e il cliente penserà che gli hai dato un QR rotto.
- Re-download del profilo. Se il cliente esegue un reset di fabbrica o cambia telefono, non può rescansionare il vecchio QR. Deve contattare l'operatore che emette un nuovo Matching ID e un nuovo QR. Costruisci il tuo flusso di supporto clienti attorno a questo.
- Provisioning dual SIM. iOS 17.4+ può ospitare 8 profili eSIM ma usarne solo due contemporaneamente. Durante la scansione, il SO chiede all'utente quale slot SIM fisico sostituire. Gli operatori enterprise spesso scansionano in uno slot secondario per impostazione predefinita.
- Telefoni gestiti da MDM. Apple Business Manager e Android Enterprise possono eseguire il provisioning degli eSIM in modo programmatico senza il passaggio QR. Se la tua flotta è gestita da MDM, usa l'API anziché consegnare QR agli utenti.
Compatibilità scanner
| Dispositivo / OS | Supporto | Notas |
|---|---|---|
| iOS 17.4+ | Nativo | L'app Fotocamera riconosce i payload LPA e offre di installare il profilo eSIM inline. |
| iOS 16.x–17.3 | Nativo via Impostazioni > Cellulare | Scansiona da Impostazioni > Cellulare > Aggiungi eSIM invece che dalla Fotocamera. Il supporto scan dalla fotocamera è arrivato in 17.4. |
| Android 13+ | Nativo | Impostazioni > Rete e internet > SIM > Aggiungi eSIM > Scansiona QR. |
| Android 9–12 | Specifico OEM | Samsung Galaxy, Google Pixel e alcuni OnePlus hanno il supporto scan dalla fotocamera. Altri OEM richiedono inserimento manuale tramite Impostazioni. |
| App fotocamera di terze parti | Non nativamente | Decodificano il QR ma non attivano l'installazione eSIM. Gli utenti devono copiare la stringa in Impostazioni manualmente. |
| Telefoni più vecchi / senza eSIM | N/A | Nessun hardware eSIM fisico; il payload si decodifica ma non succede nulla. |
Vedi anche
- /esim-qr-code/, il generatore con il formato LPA precompilato.
- /standards/, torna all'indice degli standard.
- GSMA SGP.22, la specifica di riferimento.