eSIM-aktiveringskode (LPA)
QR-koden i en operatørs eSIM-aktiveringsmail er en LPA (Local Profile Assistant) aktiveringskode i henhold til GSMA SGP.22. Telefonen scanner den, kontakter SM-DP+-serveren, downloader den krypterede eSIM-profil og installerer den, uden at kunden skal taste noget.
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.
Hvad det er
Aktiveringskodens payload er en streng med fast format med 3 eller 4 $-adskilte dele:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, LPA URI-skemaidentifikator + aktiveringskodeversion. Obligatorisk literal.
- SM-DP+-adresse, FQDN for operatørens provisioneringsserver (f.eks.
rsp.example.com). Ingenhttps://-præfiks, kun værtsnavn. - Matching ID, et unikt ID (typisk 16–32 alfanumeriske tegn), der binder aktiveringskoden til én specifik eSIM-profil på SM-DP+-serveren.
- Bekræftelseskode (valgfri), en ekstra hemmelighed, som brugeren skal indtaste for at godkende download. Bruges af nogle operatører som en anden faktor i aktiveringstrinnene.
Kanoniske testvektorer
Disse er kun formeksempler, en rigtig LPA-aktiveringskode er bundet til en specifik profil på en specifik SM-DP+. Testvektorer koder formatet, ikke et scan-til-installer-flow.
| Tilfælde | Input | Forventet kodet streng |
|---|---|---|
| Minimal (ingen bekræftelseskode) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Med bekræftelseskode | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operatør med underdomæne | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Porteret MSISDN-workflow | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Almindelige faldgruber
- https://-præfiks i SM-DP+-feltet. SGP.22 §4.1.1 ønsker det bare FQDN. Telefoner, der ser
https://rsp.example.comi den plads, behandler aktiveringskoden som misdannet og afviser at downloade. - $-tegn i Matching ID. Matching ID er alfanumerisk. Et
$i den kolliderer med feltadskilleren. Operatører, der auto-genererer Matching ID'er, skal udelukke$fra alfabetet. - Forventning om engangsbrug. De fleste SM-DP+-servere ugyldiggør Matching ID efter den første vellykkede profildownload. Deling af QR-koden igen efter at kunden har scannet den, vil mislykkes.
- Profil-re-download. Hvis kunden nulstiller fabriksindstillinger eller skifter telefon, kan de ikke gen-scanne den gamle QR. De skal kontakte operatøren, der udsteder et nyt Matching ID og en ny QR.
- Dual-SIM-provisionering. iOS 17.4+ kan holde 8 eSIM-profiler, men kun bruge to samtidigt. Ved scanning spørger OS brugeren, hvilken fysisk SIM-slot der skal erstattes.
- MDM-administrerede telefoner. Apple Business Manager og Android Enterprise kan provisionere eSIM programmatisk uden QR-trinnet. Hvis din flåde er MDM-administreret, brug API'en i stedet for at give brugerne QR-koder.
Scannere kompatibilitet
| Enhed / OS | Support | Noter |
|---|---|---|
| iOS 17.4+ | Nativ | Kameraappen genkender LPA-payloads og tilbyder at installere eSIM-profilen direkte. |
| iOS 16.x–17.3 | Nativ via Indstillinger > Mobil | Scan fra Indstillinger > Mobil > Tilføj eSIM i stedet for kamera. Kamerascanning ankom i 17.4. |
| Android 13+ | Nativ | Indstillinger > Netværk og internet > SIM-kort > Tilføj eSIM > Scan QR. |
| Android 9–12 | OEM-specifik | Samsung Galaxy, Google Pixel og nogle OnePlus-enheder har kamerascanning. Andre OEM'er kræver manuel indtastning via Indstillinger. |
| Third-party camera apps | Ikke nativt | De dekoder QR'en, men udløser ikke eSIM-installation. Brugere skal manuelt kopiere strengen til Indstillinger. |
| Older / non-eSIM phones | N/A | Ingen fysisk eSIM-hardware; payload dekodes, men intet sker. |
Se også
- /esim-qr-code/, generatoren med LPA-formatet udfyldt på forhånd.
- /standards/, tilbage til standardindekset.
- GSMA SGP.22, den autoritative specifikation.