Code d'activation eSIM (LPA)
Le QR dans l'e-mail d'activation eSIM d'un opérateur est un code d'activation LPA (Local Profile Assistant) selon GSMA SGP.22. Le téléphone le scanne, contacte le serveur SM-DP+ (Subscription Manager, Data Preparation Plus), télécharge le profil eSIM chiffré et l'installe, sans que le client ne saisisse quoi que ce soit.
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.
Ce que c'est
Le payload du code d'activation est une chaîne de format fixe avec 3 ou 4 parties séparées par $ :
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, l'identifiant du schéma URI LPA + version du code d'activation. Littéral obligatoire.
- Adresse SM-DP+, le FQDN du serveur de provisionnement de l'opérateur (ex.
rsp.example.com). Sans préfixehttps://, uniquement le nom d'hôte. - Matching ID, un ID unique (généralement 16–32 alphanumériques) qui lie le code d'activation à un profil eSIM spécifique sur le serveur SM-DP+.
- Code de confirmation (optionnel), un secret supplémentaire que l'utilisateur doit saisir pour autoriser le téléchargement. Utilisé par certains opérateurs comme second facteur dans le flux d'activation.
Vecteurs de test canoniques
Ce sont des exemples de forme uniquement, un vrai code d'activation LPA est lié à un profil spécifique sur un SM-DP+ spécifique. Les vecteurs de test encodent le format, pas un flux scan-pour-installer.
| Cas | Entrées | Chaîne encodée attendue |
|---|---|---|
| Minimal (sans code de confirmation) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Avec code de confirmation | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Opérateur avec sous-domaine | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Workflow MSISDN porté | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Pièges courants
- Préfixe https:// dans le champ SM-DP+. SGP.22 §4.1.1 attend le FQDN nu. Les téléphones qui voient
https://rsp.example.comdans ce champ traitent le code d'activation comme malformé et refusent le téléchargement. - Caractères $ dans le Matching ID. Le Matching ID est alphanumérique. Un
$dedans entre en collision avec le séparateur de champ. Les opérateurs qui auto-génèrent les Matching IDs doivent exclure$de l'alphabet. - Expectative d'usage unique. La plupart des serveurs SM-DP+ invalident le Matching ID après le premier téléchargement de profil réussi. Repartager le QR après que le client l'a scanné échouera, et le client pensera que vous lui avez donné un QR cassé.
- Re-téléchargement du profil. Si le client réinitialise ou change de téléphone, il ne peut pas rescanner l'ancien QR. Il doit contacter l'opérateur qui émet un nouveau Matching ID et un nouveau QR. Construisez votre flux de support client autour de ça.
- Provisionnement double SIM. iOS 17.4+ peut héberger 8 profils eSIM mais n'en utiliser que deux simultanément. Lors du scan, l'OS demande à l'utilisateur quel slot SIM physique remplacer. Les opérateurs entreprise scannent souvent dans un slot secondaire par défaut.
- Téléphones gérés par MDM. Apple Business Manager et Android Enterprise peuvent provisionner des eSIMs par programme sans l'étape QR. Si votre parc est géré par MDM, utilisez l'API plutôt que de donner des QR aux utilisateurs.
Compatibilité des scanners
| Appareil / OS | Support | Notes |
|---|---|---|
| iOS 17.4+ | Natif | L'app Caméra reconnaît les payloads LPA et propose d'installer le profil eSIM en ligne. |
| iOS 16.x–17.3 | Natif via Réglages > Données mobiles | Scannez depuis Réglages > Données mobiles > Ajouter eSIM plutôt que depuis la Caméra. Le scan depuis la caméra est arrivé en 17.4. |
| Android 13+ | Natif | Paramètres > Réseau et internet > SIMs > Ajouter eSIM > Scanner QR. |
| Android 9–12 | Spécifique OEM | Samsung Galaxy, Google Pixel et certains OnePlus ont le scan caméra. D'autres OEM nécessitent la saisie manuelle via Paramètres. |
| Apps caméra tierces | Pas nativement | Elles décodent le QR mais ne déclenchent pas l'installation eSIM. Les utilisateurs doivent copier la chaîne dans Paramètres manuellement. |
| Téléphones anciens / sans eSIM | N/A | Pas de matériel eSIM physique ; le payload se décode mais rien ne se passe. |
Voir aussi
- /esim-qr-code/, le générateur avec le format LPA pré-rempli.
- /standards/, retour à l'index des standards.
- GSMA SGP.22, la spec de référence.