Miks sinu reisi-eSIM-i QR-kood ei tööta: SM-DP+, sobitus-ID, kinnituskoodid ja aktiveerimise ajastus

Reisi-eSIM-i QR-kood, mis „ei tööta“, on harva lihtsalt katkine piksliruut. Sagedamini loeb kaamera koodi korralikult välja, kuid telefoni Local Profile Assistant (LPA) takerdub kusagil GSMA tarbijatele mõeldud Remote SIM Provisioning protsessis: aktiveerimisandmed on valed või juba kasutatud, puudub ühendus SM-DP+ serveriga, kinnituskood ei ühti, Bound Profile Package'i allalaadimine katkeb või seade ei saa veel üht profiili vastu võtta.

Tarbijaseadmete jaoks on see protsess määratletud dokumendis GSMA SGP.22 (RSP tehniline spetsifikatsioon). QR-kood on ainult aktiveerimiskoodi edastamise vorm. Kui mõistad, mida see kood sisaldab ja mis peab pärast skannimist juhtuma, muutuvad ebamäärased teated „vigane aktiveerimiskood“ etappideks, mille probleeme saab diagnoosida.

See artikkel keskendub tarbijatele mõeldud RSP-paigaldusele ja aktiveerimisele: sellele, kuidas profiile tellitakse, lunastatakse ja alla laaditakse. See ei ole SGP.32 IoT selgitus ega mitme IMSI-ga lahenduste levikaartide põhjalik käsitlus.

Mis tegelikult toimub, kui skannid reisi-eSIM-i QR-koodi #

Üldjoontes koosneb tarbijatele mõeldud eSIM-i seadistamine kolmest eri toimingust, mida inimesed nimetavad kõnekeeles „aktiveerimiseks“:

1. Taotlemine / allalaadimine, LPA võtab ühendust SM-DP+ serveriga, autentib ja laadib seotud profiilipaketi eUICC-sse.
2. Paigaldamine, eUICC salvestab profiili (kasutuseks vajalikud identimisteabe andmed ISD-P-s).
3. Võrgus kasutamise lubamine, profiil lülitatakse sisse ja modem ühendub külastatava võrgu või koduvõrguga (paketi reeglid, levi ja esmakordse ühendamise ajastus erinevad olenevalt väljastajast).

GSMA tarbijaseadmete RSP-arhitektuuri keskmes on SM-DP+ (Subscription Manager, Data Preparation +): roll, mis valmistab ette profiilipaketid, kaitseb neid, võib määrata need kindlatele EID-dele, seob kaitstud profiilipaketi konkreetse eUICC-ga ja edastab seotud profiilipaketi turvaliselt seadme LPA-le (SGP.22 v2.7 ülevaade; SGP.22 v2.7 PDF).

Sinu telefon ei „muutu SIM-iks“, lugedes QR-koodi võrguühenduseta. QR-kood (või sisestatud aktiveerimisstring) ütleb LPA-le, kuhu pöörduda ja millist ootel tellimust lunastada. Profiili baidid peavad endiselt liikuma interneti kaudu SM-DP+ serverist LPA-sse ja seejärel eUICC-sse.

Apple'i enda seadistusjuhised ütlevad ühenduse eeltingimuse otse välja: tavapärasel juhul vajab iPhone eSIM-i seadistamiseks Wi-Fi-võrku või kuumkohta (Apple Support, teave eSIM-i kohta iPhone'is; Apple Support, kui sa ei saa eSIM-i seadistada).

Aktiveerimiskood: SM-DP+ aadress, sobitus-ID ja valikuline kinnituse lipp #

GSMA SGP.22 määratleb aktiveerimiskoodi teabena, mille operaator või teenusepakkuja väljastab, et lõppkasutaja saaks taotleda profiili allalaadimist ja paigaldamist. QR-kujul on selle ees prefiks LPA:; sisu on märgiga $ eraldatud string (SGP.22 v1.2 §4.1; struktuur on jätkuvalt dokumenteeritud aktiveerimiskoodi / sobitus-ID all ka hilisemates SGP.22 versioonides, sealhulgas v2.7).

Põhimõtteliselt (näitlik struktuur, mitte tegelik autentimisvahend):

``text LPA:1$smdp.example.com$MATCHING-ID-TOKEN[$SM-DP+-OID][$1] ``

Valdkonnas kasutatavad parserid kirjeldavad kokkuvõtlikult sama tarbijaseadmete vormingut: LPA:1$SM-DP+-address$token, millele võivad lisanduda valikuline OID ja kinnituskoodi lipp (iot.cardsi märkused aktiveerimiskoodi parseri kohta). Käsitsi sisestamise kuval on samad väljad lihtsalt eraldi: SM-DP+ aadress, aktiveerimiskood (sobitus-ID) ja valikuline kinnituskood (SM-DP+ käsitsi sisestamise selgitused; SimFinderi käsitsi koodi sisestamise juhend).

Sobitus-ID võrreldes kinnituskoodiga (need ei ole sama asi) #

• Matching ID / Activation Code Token tuvastab SM-DP+ serveris *ootel allalaadimistellimuse*. SGP.22 käsitleb MatchingID-d arhitektuuridokumentides kirjeldatud Activation Code Tokeniga samaväärsena; see peab olema operaatori/SM-DP+ piires kordumatu, et server töötleks ainult teadaolevaid kehtivaid lunastamistaotlusi (SGP.22 v1.2 §4.1.1).
• Kinnituskood, valikuline lõppkasutaja saladus, mida kasutatakse siis, kui operaator nõuab enne profiili väljastamist SM-DP+ serverist tugevamat kinnitust. SGP.22 sätestab, et kinnituskoodi kasutamisel TULEKS see edastada aktiveerimiskoodist eraldi (SGP.22 v1.2 §3.1.1.3). LPA arvutab sinu sisestusest räsi ja SM-DP+ kontrollib seda allalaadimise autentimise ajal.

Nende väljade segiajamine või kinnituskoodi väljamõtlemine siis, kui seda pole väljastatud, on tüüpiline viis jõuda veateateni „Vigane aktiveerimiskood“.

Reisi-eSIM-i QR-koodi ja paigaldamise levinud tõrked #

Veateated ei ole universaalne GSMA olekusõnavara. Apple, Google, seadmetootjad ja väljastajad sõnastavad sama algpõhjusega tõrke erinevalt. Käsitle tabelit RSP toimemehhanismidel ja avaliku toe korduvatel juhtumitel põhinevate esmase tõrkeotsingu kategooriatena, mitte lubadusena, et iga kaubamärk kasutab täpselt sama sõnastust (eSIM Ready QR-koodi tõrkeotsing; Apple'i toe tõrkeotsing).

Märkused tõrgete kohta, mida reisijatele suunatud kaubamärgid korduvalt näevad #

Vale või aegunud QR-kood. Kuvatõmmised tihendavad koodi mooduleid. Vestluses edasi saadetud piltidel kärbitakse koodi ümbritsevaid tühje alasid. Vana e-kiri võib viidata tühistatud Matching ID-le. Eelista väljastaja praegust tellimuse lehte või algset manust.

Allalaadimiseks on vaja võrguühendust. Skannimine toimub kohapeal; ES9+ liiklus SM-DP+ serverisse mitte. Lennurežiim, kus raadioliidesed on välja lülitatud, hotelli sisselogimisportaalid, mille tingimusi pole veel aktsepteeritud, või ebastabiilne lennujaama Wi-Fi katkestavad protsessi sageli pärast edukat skannimist (Apple'i ühenduse eeltingimus; arendajatele suunatud märkused SM-DP+ kaudu seadistamise kohta).

Profiili allalaadimine katkes. SGP.22 kirjeldab allalaadimist mitmeetapilise seansina SM-DP+, LPA ja eUICC vahel. Siderike võib jätta serveri olekusse, kus uuesti proovimine on võimalik või võimatu, olenevalt sellest, kui kaugele sidumine jõudis; reisijatele suunatud kaubamärgid näevad osalise õnnestumise järel sageli teadet „juba kasutatud“. Enne uue QR-koodi nõudmist kontrolli, kas profiil on juba nähtav (SGP.22 allalaadimise ja paigaldamise protseduurid; väljastajast sõltumatu esmane tõrkeotsing).

Kinnituskood ei ühti. Kui aktiveerimiskoodi kinnituse lipp on seatud, peab LPA küsima kinnituskoodi; SM-DP+ kontrollib kinnitusteabest arvutatud räsi. SM-DP+ võib liiga paljude valede sisestuste korral piirata katsete sagedust (SGP.22 mainib allalaadimisprotsessis kaitset liiga paljude valede kinnituskoodi sisestuste eest).

Ajastus: paigaldamine enne reisi võrreldes paigaldamisega sihtkohas #

Omavahel aetakse segi kaks ajastust:

1. RSP-allalaadimise ajastus, millal LPA saab SM-DP+ serveriga ühenduse luua ja paigaldamise lõpetada.
2. Paketi kehtivuse ajastus, millal algab *paketi tasuline kasutusperiood* (paigaldamise ajal, esmakordsel võrguühendusel või kindlal kalendrikuupäeval, määravad väljastaja tingimused).

Avalikud reisijuhised jõuavad esimese ajastuse puhul ühele praktilisele järeldusele: paigalda eSIM ajal, mil sul on veel usaldusväärne Wi-Fi-ühendus, kodus või enne pardaleminekut, et sa ei peaks pärast maandumist ilma mobiilse internetita SM-DP+ kättesaadavuse probleeme lahendama (iPhone'i reisieelse seadistamise juhised; QR-koodi tõrgete diagnostika).

Miks see on tehniliselt oluline:

• Profiili allalaadimine vajab IP-ühendust SM-DP+ täieliku domeeninimega (FQDN) aadressile (HTTPS/TLS), olenemata sellest, kas reisi-eSIM-i liin on juba sisse lülitatud.
• Lennujaamade ja hotellide Wi-Fi nõuab sageli sisselogimisportaali kasutamist; lõpeta sisselogimine *enne* toimingu „Lisa eSIM“ alustamist.
• Pärast paigaldamist jätavad paljud reisijad reisiprofiili kuni saabumiseni paigaldatuks, kuid väljalülitatuks (või ei vali seda andmesideliiniks), et hoida lahus „baidid eUICC-s“ ja „kehtivusaja kulumise algus“. Loe alati paketi kehtivusaja alguse reeglit; mõne toote puhul algab see paigaldamisel, teistel esmakordsel ühendamisel.

Paigaldamine sihtkohas võib siiski toimida, kui sul on töötav kuumkoht, teine andmesideliin või tasuta Wi-Fi, kuid nii lisanduvad RSP keerukusele ajavahest tingitud väsimus, sisselogimisportaalid ja toe viivitused. Lennueelne paigaldamine vähendab seda koormat.

Käsitsi sisestamine, kui probleem on QR-koodis (mitte profiilis) #

Kui ruudukujulist koodi ei saa skannida, kuid väljastaja on trükkinud SM-DP+ aadressi ja aktiveerimisandmed:

1. Ava süsteemi toiming „Lisa eSIM“ / „Lisa mobiilsidepakett“ (mitte juhuslik QR-rakendus).
2. Vali „Sisesta üksikasjad käsitsi“.
3. Kleebi SM-DP+ aadress täieliku domeeninimena (FQDN), ilma eesliidete või muu lisata.
4. Kleebi Matching ID / aktiveerimistoken aktiveerimiskoodi väljale.
5. Sisesta kinnituskood ainult siis, kui väljastaja edastas selle eraldi.

Apple kirjeldab kinnituskoodi küsimist QR-koodiga seadistamise ajal, kui operaator seda nõuab (Apple, eSIM-i seadistamine / teave eSIM-i kohta). Androidi menüüteed erinevad seadmetootjati, kuid sisaldavad samu kolme sisulist välja.

Ära kogu suvalistest blogidest „SM-DP+ aadresside loendeid“. Õige aadress on see, mis on seotud *sinu* ootel tellimusega.

Mida reisijad peaksid meeles pidama #

• QR-kood sisaldab aktiveerimiskoodi, mitte profiili ennast.
• SM-DP+ aadress = kuhu; sobitus-ID = milline tellimus; kinnituskood = valikuline teine tegur, tavaliselt eraldi.
• Allalaadimiseks vajad stabiilset internetiühendust isegi siis, kui kavatsed liini hiljem sisse lülitada.
• Enne „juba kasutatud“ koodi uuesti skannimist otsi profiili, mis on juba seadmesse jõudnud.
• Paigalda eSIM enne reisi usaldusväärse Wi-Fi kaudu, kui paketi tingimused seda lubavad; seejärel halda saabumisel sisselülitamist ja andmesideliini valikut.
• Salvesta toe jaoks täpne veatekst, seadme mudel/operatsioonisüsteem ja katse aeg; ära kunagi postita avalikesse foorumitesse täielikke LPA-stringe ega QR-koodi pilte.

Mida reisi-eSIM-i kaubamärgid ja operaatorid peaksid meeles pidama #

• Väljasta aktiveerimiskoodid, mida saab korrektselt parsida (LPA:1$…), ning lisa samasse tellimuse e-kirja varuvariandina käsitsi sisestatavad väljad.
• Kui kinnituskoodid on nõutavad, edasta need eraldi ja märgista väljad üheselt (SGP.22 juhised).
• Dokumenteeri, kas kehtivus algab paigaldamisel, esmakordsel võrguühendusel või kindlal kalendrikuupäeval; segadus ajastuse osas põhjustab ekslikke tugipöördumisi teemal „aktiveerimine ebaõnnestus“.
• Koolita kliendituge küsima: kas probleem on skannimises, allalaadimises, installimises või võrguga ühendumises; kas profiil on juba olemas?; kas kasutusel on Wi-Fi või sisselogimisportaal?; kas kinnitusmärge ja Matching ID on segi aetud.
• Eelista uuesti väljastamise töövooge, mis kontrollivad SM-DP+ tellimuse olekut enne, kui iga uue katsega uus Matching ID ära kulutatakse.
• Käsitle seadmetootjate LPA eripärasid ja operaatori seadete uuendusi täisväärtuslike tegevusjuhenditena, mitte erandjuhtudena.

Esmalt teadmised standarditest: tarbijatele mõeldud RSP koostalitlusvõime tuleneb standardi SGP.22 kohasest SM-DP+, LPA ja eUICC toimimisest. Brändi kasutajakogemus seisneb selles, kui selgelt sa neid etappe väravas B17 ootavale väsinud reisijale selgitad.

Sõbralik märkus Roamifylt #

Roamify avaldab reisiaegse ühenduvuse kohta harivat sisu, et installimistõrkeid saaks diagnoosida ja need ei jääks mõistatuseks. Kui hindad mõnda reisi-eSIM-i (sealhulgas meie oma), eelista selgeid aktiveerimisjuhiseid, ausat teavet kehtivusaja alguse kohta ja kliendituge, mis oskab rääkida SM-DP+ ja Matching ID teemadel ilma funktsioone välja mõtlemata. Kasuta alati aktiveerimiskoodi ja ajastusreegleid, mis on sinu tellimuses tegelikult antud.

---

Reisi-eSIM-i QR-koodi tõrked ei tähenda tavaliselt „vigaseid vöötkoode“. QR-kood sisaldab GSMA SGP.22 aktiveerimiskoodi: SM-DP+ aadress (kust alla laadida) + Matching ID (milline ootel profiil) + valikuline kinnituskoodi nõude märge.

Telefoni LPA vajab siiski stabiilset internetiühendust, et Bound Profile Package alla laadida. Levinud tõrked: SM-DP+ aadressi väljale kleebitud https://, uuesti kasutatud või aegunud Matching ID, segadus kinnituskoodidega, sisselogimisportaaliga Wi-Fi, katkestatud allalaadimised, mis näivad „juba kasutatuna“, ning paigaldamine alles pärast maandumist ilma mobiilse internetita.

Kui paketi tingimused seda lubavad, installi enne lendu usaldusväärse Wi-Fi kaudu ja lülita liin sisse pärast saabumist.

Loe lähemalt: https://www.getroamify.com/en/blogs/sm-dp-plus-travel-esim-activation-failures

• https://www.gsma.com/solutions-and-impact/technologies/esim/gsma_resources/sgp-22-v2-7/
• https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2026/04/SGP.22-v2.7-.pdf
• https://www.gsma.com/newsroom/wp-content/uploads/SGP.22_v1.2.pdf
• https://support.apple.com/en-us/118669
• https://support.apple.com/en-us/102478
• https://iot.cards/en/resources/tools/esim-activation-code-parser
• https://roamless.com/blog/sm-dp-address
• https://sim-finder.com/en/guides/manual-code/
• https://esim.chatgpt.org.uk/en/guides/esim-qr-code-not-working/
• https://dev.to/purasim/esim-activation-qr-lpa-and-sm-dp-provisioning-for-developers-2980
• https://zenroam.co/blog/how-to-activate-an-esim-on-iphone