eSIM-activatiecode (LPA)
De QR in de eSIM-activeringsmail van een provider is een LPA (Local Profile Assistant) activatiecode conform GSMA SGP.22. De telefoon scant hem, neemt contact op met de SM-DP+-server, downloadt het versleutelde eSIM-profiel en installeert het, zonder dat de klant iets hoeft in te typen.
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.
Wat het is
De activatiecode-payload is een vaste-formaat tekenreeks met 3 of 4 door $ gescheiden delen:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, de LPA URI-schema-identifier + activatiecodeversie. Verplicht literaal.
- SM-DP+-adres, de FQDN van de provisioningserver van de provider (bijv.
rsp.example.com). Geenhttps://-prefix, alleen de hostnaam. - Matching ID, een uniek ID (gewoonlijk 16–32 alfanumerieke tekens) dat de activatiecode koppelt aan één specifiek eSIM-profiel op de SM-DP+-server.
- Bevestigingscode (optioneel), een aanvullend geheim dat de gebruiker moet intypen om de download te autoriseren. Door sommige providers gebruikt als tweede factor in de activatiestroom.
Canonieke testvectoren
Dit zijn alleen vormvoorbeelden, een echte LPA-activatiecode is gebonden aan een specifiek profiel op een specifieke SM-DP+. Testvectoren coderen het formaat, niet een scan-en-installeer-stroom.
| Geval | Invoer | Verwachte gecodeerde tekenreeks |
|---|---|---|
| Minimaal (geen bevestigingscode) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Met bevestigingscode | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Provider met subdomein | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Overgezet MSISDN-werkstroom | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Veelvoorkomende valkuilen
- https://-prefix in het SM-DP+-veld. SGP.22 §4.1.1 verwacht de kale FQDN. Telefoons die
https://rsp.example.comin dat veld zien, behandelen de activatiecode als misvormd en weigeren te downloaden. - $-tekens in de Matching ID. De Matching ID is alfanumeriek. Een
$erin botst met het veldscheidingsteken. Providers die Matching ID's auto-genereren, moeten$uitsluiten van het alfabet. - Eenmalig gebruik verwacht. De meeste SM-DP+-servers maken de Matching ID ongeldig na de eerste succesvolle profieldownload. De QR opnieuw delen nadat de klant hem heeft gescand, zal mislukken.
- Profiel herladen. Als de klant de fabrieksinstellingen herstelt of van telefoon wisselt, kunnen ze de oude QR niet opnieuw scannen. Ze moeten contact opnemen met de provider, die een nieuwe Matching ID en een nieuwe QR uitgeeft.
- Dual-SIM-provisioning. iOS 17.4+ kan 8 eSIM-profielen bewaren maar slechts twee tegelijkertijd gebruiken. Bij het scannen vraagt het OS de gebruiker welke fysieke SIM-sleuf te vervangen.
- MDM-beheerde telefoons. Apple Business Manager en Android Enterprise kunnen eSIM's programmatisch inrichten zonder de QR-stap. Als uw vloot MDM-beheerd is, gebruik dan de API in plaats van gebruikers QR-codes te geven.
Scannercompatibiliteit
| Apparaat / OS | Ondersteuning | Opmerkingen |
|---|---|---|
| iOS 17.4+ | Ingebouwd | Camera-app herkent LPA-payloads en biedt aan het eSIM-profiel direct te installeren. |
| iOS 16.x–17.3 | Ingebouwd via Instellingen > Mobiel | Scan via Instellingen > Mobiel > eSIM toevoegen in plaats van camera. Camera-scanondersteuning in 17.4. |
| Android 13+ | Ingebouwd | Instellingen > Netwerk & internet > SIM-kaarten > eSIM toevoegen > QR scannen. |
| Android 9–12 | OEM-specifiek | Samsung Galaxy, Google Pixel en sommige OnePlus-apparaten hebben camerascanondersteuning. Andere OEM's vereisen handmatige invoer via Instellingen. |
| Third-party camera apps | Niet ingebouwd | Ze decoderen de QR maar activeren geen eSIM-installatie. Gebruikers moeten de tekenreeks handmatig naar Instellingen kopiëren. |
| Older / non-eSIM phones | N.v.t. | Geen fysieke eSIM-hardware; payload decoderen maar er gebeurt niets. |
Zie ook
- /esim-qr-code/, de generator met het LPA-formaat vooraf ingevuld.
- /standards/, terug naar de standaardenindex.
- GSMA SGP.22, de gezaghebbende specificatie.