Mã kích hoạt eSIM (LPA)
QR trong email kích hoạt eSIM của nhà mạng là mã kích hoạt LPA (Local Profile Assistant) theo GSMA SGP.22. Điện thoại quét nó, liên hệ máy chủ SM-DP+, tải xuống hồ sơ eSIM đã mã hóa và cài đặt nó, mà không cần khách hàng nhập gì.
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.
Nó là gì
Tải trọng mã kích hoạt là chuỗi định dạng cố định với 3 hoặc 4 phần được phân tách bởi $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, nhận dạng lược đồ LPA URI + phiên bản mã kích hoạt. Ký tự bắt buộc.
- Địa chỉ SM-DP+, FQDN của máy chủ cung cấp nhà mạng (ví dụ
rsp.example.com). Không có tiền tốhttps://, chỉ tên máy chủ. - Matching ID, ID duy nhất (thường là 16–32 ký tự chữ-số) liên kết mã kích hoạt với một hồ sơ eSIM cụ thể trên máy chủ SM-DP+.
- Confirmation Code (tùy chọn), bí mật bổ sung mà người dùng phải nhập để ủy quyền tải xuống. Được một số nhà mạng sử dụng làm yếu tố thứ hai trong quy trình kích hoạt.
Vector kiểm tra chuẩn
Đây chỉ là các ví dụ về hình dạng, mã kích hoạt LPA thực được gắn với một hồ sơ cụ thể trên SM-DP+ cụ thể. Các vector kiểm tra mã hóa định dạng, không phải quy trình quét và cài đặt.
| Trường hợp | Đầu vào | Chuỗi mã hóa dự kiến |
|---|---|---|
| Tối thiểu (không có mã xác nhận) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Có mã xác nhận | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Nhà mạng có tên miền phụ | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Quy trình MSISDN được chuyển đổi | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Lỗi thường gặp
- Tiền tố https:// trong trường SM-DP+. SGP.22 §4.1.1 muốn FQDN đơn giản. Điện thoại thấy
https://rsp.example.comtrong ô đó coi mã kích hoạt là không hợp lệ và từ chối tải xuống. - Ký tự $ trong Matching ID. Matching ID là chữ-số. Dấu
$bên trong xung đột với dấu phân cách trường. Nhà mạng tự động tạo Matching ID phải loại trừ$khỏi bảng chữ cái. - Kỳ vọng sử dụng một lần. Hầu hết máy chủ SM-DP+ vô hiệu hóa Matching ID sau lần tải xuống hồ sơ thành công đầu tiên. Chia sẻ lại QR sau khi khách hàng đã quét sẽ thất bại.
- Tải xuống lại hồ sơ. Nếu khách hàng đặt lại về cài đặt gốc hoặc đổi điện thoại, họ không thể quét lại QR cũ. Họ phải liên hệ nhà mạng để nhận Matching ID mới và QR mới.
- Cung cấp Dual-SIM. iOS 17.4+ có thể lưu giữ 8 hồ sơ eSIM nhưng chỉ sử dụng hai đồng thời. Khi quét, OS hỏi người dùng thay thế khe SIM vật lý nào.
- Điện thoại được quản lý MDM. Apple Business Manager và Android Enterprise có thể cung cấp eSIM theo chương trình mà không cần bước QR. Nếu đội thiết bị của bạn được MDM quản lý, hãy dùng API thay vì đưa mã QR cho người dùng.
Khả năng tương thích máy quét
| Thiết bị / OS | Hỗ trợ | Ghi chú |
|---|---|---|
| iOS 17.4+ | Gốc | Ứng dụng máy ảnh nhận dạng tải trọng LPA và đề nghị cài đặt hồ sơ eSIM trực tiếp. |
| iOS 16.x–17.3 | Gốc qua Cài đặt > Di động | Quét từ Cài đặt > Di động > Thêm eSIM thay vì máy ảnh. Hỗ trợ quét bằng máy ảnh có từ 17.4. |
| Android 13+ | Gốc | Cài đặt > Mạng và internet > SIM > Thêm eSIM > Quét QR. |
| Android 9–12 | Theo OEM | Samsung Galaxy, Google Pixel và một số OnePlus có hỗ trợ quét máy ảnh. OEM khác yêu cầu nhập thủ công qua Cài đặt. |
| Third-party camera apps | Không gốc | Chúng giải mã QR nhưng không kích hoạt cài đặt eSIM. Người dùng phải sao chép chuỗi thủ công vào Cài đặt. |
| Older / non-eSIM phones | Không áp dụng | Không có phần cứng eSIM vật lý; tải trọng được giải mã nhưng không có gì xảy ra. |
Xem thêm
- /esim-qr-code/, trình tạo với định dạng LPA được điền sẵn.
- /standards/, quay lại danh mục tiêu chuẩn.
- GSMA SGP.22, đặc tả có thẩm quyền.