رمز تفعيل eSIM (LPA)
رمز الاستجابة السريعة في بريد تفعيل eSIM الخاص بالمزود هو رمز تفعيل LPA (المساعد المحلي للملف الشخصي) وفق GSMA SGP.22. يقوم الهاتف بمسحه، ثم يتصل بخادم 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 حرفًا أبجديًا رقميًا) يربط رمز التفعيل بملف eSIM محدد على خادم SM-DP+.
- رمز التأكيد (اختياري), رمز سري إضافي يجب على المستخدم إدخاله للسماح بالتنزيل. تستخدمه بعض المزودين كعامل ثانٍ في تدفق التفعيل.
متجهات الاختبار القياسية
هذه أمثلة شكلية فقط, رمز تفعيل 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 |
المشكلات الشائعة
- بادئة https:// في حقل SM-DP+. تطلب SGP.22 §4.1.1 اسم النطاق الكامل FQDN فقط. الهواتف التي ترى
https://rsp.example.comفي هذا الحقل تعتبر رمز التفعيل مشوهاً وترفض التنزيل. - أحرف $ في Matching ID. Matching ID أبجدية رقمية. وجود
$فيها يتعارض مع فاصل الحقول. يجب على المزودين الذين يُنشئون Matching IDs تلقائياً استبعاد$من النطاق. - توقع الاستخدام لمرة واحدة. معظم خوادم SM-DP+ تُبطل Matching ID بعد أول تنزيل ناجح للملف. إعادة مشاركة رمز QR بعد مسح العميل له ستفشل, وسيظن العميل أنك أعطيته رمزاً معطلاً.
- إعادة تنزيل الملف. إذا أعاد العميل ضبط المصنع أو غيّر هاتفه، فلا يمكنه إعادة مسح رمز QR القديم. يجب عليه الاتصال بالمزود الذي يُصدر Matching ID جديداً ورمز QR جديداً. أنشئ تدفق دعم العملاء الخاص بك حول ذلك.
- تزويد SIM المزدوج. يمكن لـ iOS 17.4+ الاحتفاظ بـ 8 ملفات eSIM لكن استخدام اثنين فقط في وقت واحد. عند المسح، يسأل نظام التشغيل المستخدم عن فتحة SIM الفعلية التي سيستبدلها. غالباً ما تقوم مزودات المؤسسات بالمسح إلى فتحة ثانوية بشكل افتراضي.
- الهواتف المُدارة بـ MDM. يمكن لـ Apple Business Manager وAndroid Enterprise تزويد eSIMs برمجياً دون خطوة QR. إذا كانت أسطولك مُدار بـ MDM، استخدم API بدلاً من تسليم المستخدمين رموز QR.
توافق الماسحات
| الجهاز / نظام التشغيل | الدعم | ملاحظات |
|---|---|---|
| iOS 17.4+ | أصلي | تتعرف تطبيق الكاميرا على حمولات LPA وتعرض تثبيت ملف eSIM مباشرة. |
| iOS 16.x–17.3 | أصلي عبر الإعدادات > الاتصال الخلوي | امسح من الإعدادات > الاتصال الخلوي > إضافة eSIM بدلاً من الكاميرا. وصل دعم المسح بالكاميرا في 17.4. |
| Android 13+ | أصلي | الإعدادات > الشبكة والإنترنت > شرائح SIM > إضافة eSIM > مسح QR. |
| Android 9–12 | خاص بالمصنّع | هواتف Samsung Galaxy وGoogle Pixel وبعض OnePlus لديها دعم مسح بالكاميرا. تتطلب المصنّعات الأخرى الإدخال اليدوي عبر الإعدادات. |
| Third-party camera apps | ليس أصلياً | تفك تشفير QR لكنها لا تُشغّل تثبيت eSIM. يجب على المستخدمين نسخ السلسلة يدوياً في الإعدادات. |
| Older / non-eSIM phones | غير متاح | لا توجد أجهزة eSIM فعلية؛ يُفك تشفير الحمولة لكن لا شيء يحدث. |
انظر أيضاً
- /esim-qr-code/, المولّد مع تنسيق LPA مُعبأ مسبقاً.
- /standards/, العودة إلى فهرس المعايير.
- GSMA SGP.22, المرجع الموثوق.