eSIM-aktivointikoodi (LPA)
QR operaattorin eSIM-aktivointisähköpostissa on LPA (Local Profile Assistant) -aktivointikoodi GSMA SGP.22:n mukaisesti. Puhelin skannaa sen, ottaa yhteyttä SM-DP+-palvelimeen, lataa salatun eSIM-profiilin ja asentaa sen, ilman että asiakas kirjoittaa mitään.
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.
Mitä se on
Aktivointikoodin hyötykuorma on kiinteämuotoinen merkkijono, jossa on 3 tai 4 $-erotettua osaa:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, LPA URI -skeeman tunniste + aktivointikoodin versio. Pakollinen literaali.
- SM-DP+-osoite, operaattorin provisiointipalvelimen FQDN (esim.
rsp.example.com). Eihttps://-etuliitettä, vain isäntänimi. - Matching ID, yksilöllinen tunnus (yleensä 16–32 aakkosnumeerista merkkiä), joka sitoo aktivointikoodin yhteen tiettyyn eSIM-profiiliin SM-DP+-palvelimella.
- Vahvistuskoodi (valinnainen), lisäsalaisuus, jonka käyttäjän on kirjoitettava latauksen valtuuttamiseksi. Joidenkin operaattorien käyttämä toisena tekijänä aktivointiprosessissa.
Kanononiset testivektorit
Nämä ovat pelkästään muoto-esimerkkejä, todellinen LPA-aktivointikoodi on sidottu tiettyyn profiiliin tietyllä SM-DP+:lla. Testivektorit koodaavat muodon, eivät skannaus-ja-asennusvirtaa.
| Tapaus | Syötteet | Odotettu koodattu merkkijono |
|---|---|---|
| Minimaalinen (ei vahvistuskoodia) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Vahvistuskoodilla | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operaattori alidomainilla | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Siirretty MSISDN-työnkulku | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Yleisiä sudenkuoppia
- https://-etuliite SM-DP+-kentässä. SGP.22 §4.1.1 haluaa pelkän FQDN:n. Puhelimet, jotka näkevät
https://rsp.example.comsiinä paikassa, pitävät aktivointikoodia virheellisenä ja kieltäytyvät lataamasta. - $-merkit Matching ID:ssä. Matching ID on aakkosnumeerinen. Sen sisällä oleva
$törmää kenttäerottimeen. Operaattorien, jotka automaattisesti luovat Matching ID:itä, on suljettava$aakkostosta pois. - Kertakäyttöodotus. Useimmat SM-DP+-palvelimet mitätöivät Matching ID:n ensimmäisen onnistuneen profiilillatauksen jälkeen. QR:n uudelleenjakaminen sen jälkeen kun asiakas on skannannut sen epäonnistuu.
- Profiilin uudelleenlataus. Jos asiakas palauttaa tehdasasetukset tai vaihtaa puhelinta, hän ei voi skannata vanhaa QR:ää uudelleen. Hänen on otettava yhteyttä operaattoriin, joka myöntää uuden Matching ID:n ja uuden QR:n.
- Dual-SIM-provisiointi. iOS 17.4+ voi pitää 8 eSIM-profiilia mutta käyttää vain kahta samanaikaisesti. Skannattaessa OS kysyy käyttäjältä, mikä fyysinen SIM-paikka korvataan.
- MDM-hallitut puhelimet. Apple Business Manager ja Android Enterprise voivat provisionoida eSIM-kortteja ohjelmallisesti ilman QR-vaihetta. Jos laivaston puhelimet ovat MDM-hallittuja, käytä API:a QR-koodien antamisen sijaan.
Skanneriyhteensopivuus
| Laite / OS | Tuki | Muistiinpanot |
|---|---|---|
| iOS 17.4+ | Natiivi | Kamerasovellus tunnistaa LPA-hyötykuormat ja tarjoutuu asentamaan eSIM-profiilin suoraan. |
| iOS 16.x–17.3 | Natiivi Asetukset > Matkapuhelin kautta | Skannaa Asetukset > Matkapuhelin > Lisää eSIM -kohdasta kameran sijaan. Kameraskannaus tuli versiossa 17.4. |
| Android 13+ | Natiivi | Asetukset > Verkko ja internet > SIM-kortit > Lisää eSIM > Skannaa QR. |
| Android 9–12 | OEM-kohtainen | Samsung Galaxy-, Google Pixel- ja joillakin OnePlus-laitteilla on kameraskannaus. Muut valmistajat vaativat manuaalisen syötön Asetusten kautta. |
| Third-party camera apps | Ei natiivisti | Ne purkavat QR:n, mutta eivät käynnistä eSIM-asennusta. Käyttäjien on kopioitava merkkijono manuaalisesti Asetuksiin. |
| Older / non-eSIM phones | Ei sovellettavissa | Ei fyysistä eSIM-laitteistoa; hyötykuorma puretaan, mutta mitään ei tapahdu. |
Katso myös
- /esim-qr-code/, generaattori LPA-muodolla esitäytettynä.
- /standards/, takaisin standardien hakemistoon.
- GSMA SGP.22, auktoritatiivinen spesifikaatio.