eSIM-Aktivierungscode (LPA)
Der QR in der eSIM-Aktivierungs-E-Mail eines Carriers ist ein LPA (Local Profile Assistant)-Aktivierungscode gemäß GSMA SGP.22. Das Telefon scannt ihn, kontaktiert den SM-DP+-Server (Subscription Manager, Data Preparation Plus), lädt das verschlüsselte eSIM-Profil herunter und installiert es, ohne dass der Kunde irgendetwas eintippen muss.
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.
Was es ist
Das Aktivierungscode-Payload ist eine Zeichenfolge mit festem Format und 3 oder 4 durch $ getrennten Teilen:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, der LPA-URI-Schema-Bezeichner + Aktivierungscode-Version. Pflichtliteral.
- SM-DP+-Adresse, der FQDN des Provisioning-Servers des Carriers (z. B.
rsp.example.com). Keinhttps://-Präfix, nur der Hostname. - Matching ID, eine eindeutige ID (üblicherweise 16–32 alphanumerische Zeichen), die den Aktivierungscode an ein bestimmtes eSIM-Profil auf dem SM-DP+-Server bindet.
- Bestätigungscode (optional), ein zusätzliches Geheimnis, das der Nutzer eingeben muss, um den Download zu autorisieren. Von manchen Carriers als zweiter Faktor im Aktivierungsflow verwendet.
Kanonische Testvektoren
Dies sind nur Form-Beispiele, ein echter LPA-Aktivierungscode ist an ein bestimmtes Profil auf einem bestimmten SM-DP+ gebunden. Testvektoren kodieren das Format, nicht einen Scan-to-Install-Flow.
| Fall | Eingaben | Erwartete kodierte Zeichenfolge |
|---|---|---|
| Minimal (kein Bestätigungscode) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Mit Bestätigungscode | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Carrier mit Subdomain | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Portierter MSISDN-Workflow | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Häufige Fallstricke
- https://-Präfix im SM-DP+-Feld. SGP.22 §4.1.1 erwartet den FQDN ohne Präfix. Telefone, die
https://rsp.example.comin diesem Feld sehen, behandeln den Aktivierungscode als fehlerhaft und verweigern den Download. - $-Zeichen in der Matching ID. Die Matching ID ist alphanumerisch. Ein
$darin kollidiert mit dem Feldtrenner. Carrier, die Matching IDs auto-generieren, müssen$aus dem Alphabet ausschließen. - Einmalverwendungserwartung. Die meisten SM-DP+-Server invalidieren die Matching ID nach dem ersten erfolgreichen Profil-Download. Den QR nach dem Scannen des Kunden erneut zu teilen wird scheitern, und der Kunde wird denken, Sie hätten ihm einen kaputten QR gegeben.
- Profil-Re-Download. Wenn der Kunde das Gerät zurücksetzt oder das Telefon wechselt, kann er den alten QR nicht erneut scannen. Er muss den Carrier kontaktieren, der eine neue Matching ID und einen neuen QR ausstellt. Gestalten Sie Ihren Kundensupport-Flow entsprechend.
- Dual-SIM-Bereitstellung. iOS 17.4+ kann 8 eSIM-Profile halten, aber nur zwei gleichzeitig nutzen. Beim Scannen fragt das OS den Nutzer, welchen physischen SIM-Slot es ersetzen soll. Enterprise-Carrier scannen standardmäßig in einen sekundären Slot.
- MDM-verwaltete Telefone. Apple Business Manager und Android Enterprise können eSIMs programmatisch ohne den QR-Schritt bereitstellen. Wenn Ihre Flotte MDM-verwaltet ist, verwenden Sie die API statt Nutzern QR-Codes auszuhändigen.
Scanner-Kompatibilität
| Gerät / OS | Unterstützung | Hinweise |
|---|---|---|
| iOS 17.4+ | Nativ | Kamera-App erkennt LPA-Payloads und bietet an, das eSIM-Profil direkt zu installieren. |
| iOS 16.x–17.3 | Nativ über Einstellungen > Mobilfunk | Von Einstellungen > Mobilfunk > eSIM hinzufügen scannen statt aus der Kamera. Kamera-Scan-Unterstützung kam in 17.4. |
| Android 13+ | Nativ | Einstellungen > Netzwerk & Internet > SIMs > eSIM hinzufügen > QR scannen. |
| Android 9–12 | OEM-spezifisch | Samsung Galaxy, Google Pixel und einige OnePlus-Geräte haben Kamera-Scan-Unterstützung. Andere OEMs erfordern manuelle Eingabe über Einstellungen. |
| Drittanbieter-Kamera-Apps | Nicht nativ | Sie dekodieren den QR, aber lösen keine eSIM-Installation aus. Nutzer müssen die Zeichenfolge manuell in Einstellungen kopieren. |
| Ältere / nicht-eSIM-Telefone | N/A | Keine physische eSIM-Hardware; Payload wird dekodiert, aber nichts passiert. |
Siehe auch
- /esim-qr-code/, der Generator mit dem LPA-Format vorausgefüllt.
- /standards/, zurück zum Standards-Index.
- GSMA SGP.22, die maßgebliche Spec.