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, 唯一标识符(通常为16–32个字母数字字符),将激活码绑定到SM-DP+服务器上的特定eSIM配置文件。
- Confirmation Code(可选), , 用户授权下载时需要输入的额外密码。某些运营商将其用作激活流程中的第二因素。
规范测试向量
这些仅是格式示例, , 真实的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。他们必须联系运营商,运营商会发放新的Matching ID和新的QR。
- 双SIM配置。 iOS 17.4+可以保存8个eSIM配置文件,但同时只能使用两个。扫描时,系统会询问用户替换哪个物理SIM卡槽。
- MDM管理的手机。 Apple Business Manager和Android Enterprise可以在没有QR步骤的情况下以编程方式配置eSIM。如果您的设备群由MDM管理,请使用API而不是给用户二维码。
扫描仪兼容性
| 设备 / 操作系统 | 支持 | 备注 |
|---|---|---|
| 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 | 不适用 | 没有物理eSIM硬件;有效载荷被解码但什么都不会发生。 |
另见
- /esim-qr-code/, 预填了LPA格式的生成器。
- /standards/, 返回标准索引。
- GSMA SGP.22, 权威规范。