eSIM有効化コード（LPA）
キャリアのeSIMアクティベーションメールに含まれるQRは、GSMA SGP.22に準拠したLPA（ローカルプロファイルアシスタント）アクティベーションコードです。スマートフォンがスキャンしてSM-DP+サーバーに接続し、暗号化されたeSIMプロファイルをダウンロードしてインストールします, 顧客が何も入力する必要はありません。
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.
概要
アクティベーションコードのペイロードは、$で区切られた3または4つの部分からなる固定フォーマットの文字列です：
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, LPA URIスキーム識別子 + アクティベーションコードバージョン。必須リテラル。
- SM-DP+アドレス, キャリアのプロビジョニングサーバーのFQDN（例:
rsp.example.com）。https://プレフィックスなし, ホスト名のみ。 - Matching ID, SM-DP+サーバー上の特定のeSIMプロファイルにアクティベーションコードを紐付ける一意のID（通常16～32文字の英数字）。
- Confirmation Code（省略可能）, ダウンロードを承認するためにユーザーが入力する追加のシークレット。一部のキャリアがアクティベーションフローで2要素として使用。
正規テストベクター
これらは形式のみの例です, 実際のLPAアクティベーションコードは特定のSM-DP+上の特定のプロファイルに紐付けられています。テストベクターはフォーマットをエンコードするものであり、スキャン→インストールのフローではありません。
| ケース | 入力 | 期待されるエンコード文字列 |
|---|---|---|
| 最小（確認コードなし） | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| 確認コードあり | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| サブドメインのキャリア | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| ポートされたMSISDNワークフロー | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
よくある落とし穴
- SM-DP+フィールドのhttps://プレフィックス。 SGP.22 §4.1.1はベアFQDNを要求します。そのスロットで
https://rsp.example.comを見たスマートフォンはアクティベーションコードを不正形式と見なし、ダウンロードを拒否します。 - Matching IDの$文字。 Matching IDは英数字です。中に
$があるとフィールド区切り文字と衝突します。Matching IDを自動生成するキャリアはアルファベットから$を除外する必要があります。 - 一回限りの使用期待。 ほとんどのSM-DP+サーバーは最初のプロファイルダウンロード成功後にMatching IDを無効化します。顧客がスキャンした後にQRを再共有すると失敗し、顧客は壊れたQRをもらったと思います。
- プロファイルの再ダウンロード。 顧客が工場出荷時設定にリセットしたり機種変更した場合、古いQRを再スキャンできません。キャリアに連絡して新しいMatching IDと新しいQRを発行してもらう必要があります。
- デュアルSIMプロビジョニング。 iOS 17.4+は8つのeSIMプロファイルを保持できますが、同時に2つしか使用できません。スキャン時にOSはどの物理SIMスロットを置き換えるかユーザーに尋ねます。
- MDM管理下のスマートフォン。 Apple Business ManagerとAndroid EnterpriseはQRステップなしにプログラムでeSIMをプロビジョニングできます。フリートがMDM管理下にある場合は、ユーザーにQRコードを渡す代わりにAPIを使用してください。
スキャナー互換性
| デバイス / OS | 対応 | 備考 |
|---|---|---|
| iOS 17.4+ | ネイティブ | カメラアプリがLPAペイロードを認識し、eSIMプロファイルのインストールをインラインで提案します。 |
| iOS 16.x–17.3 | 設定 > モバイル通信からネイティブ | カメラではなく設定 > モバイル通信 > eSIMを追加からスキャンしてください。カメラスキャン対応は17.4で追加。 |
| Android 13+ | ネイティブ | 設定 > ネットワークとインターネット > SIM > eSIMを追加 > QRをスキャン。 |
| Android 9–12 | OEM固有 | Samsung Galaxy、Google Pixel、一部のOnePlus端末にはカメラスキャン対応があります。他のOEMは設定から手動入力が必要です。 |
| Third-party camera apps | ネイティブ非対応 | QRをデコードしますが、eSIMインストールはトリガーしません。ユーザーは手動で設定に文字列をコピーする必要があります。 |
| Older / non-eSIM phones | N/A | 物理的なeSIMハードウェアなし。ペイロードはデコードされますが何も起きません。 |
関連リンク
- /esim-qr-code/, LPAフォーマット入力済みのジェネレーター。
- /standards/, 規格一覧に戻る。
- GSMA SGP.22, 公式仕様。