توفير SIMs جديدة ل Azure Private 5G Core - قالب ARM

مقالة
04/10/2024

تمثل موارد SIM أجهزة SIM الفعلية أو eSIMs المستخدمة من قبل معدات المستخدم (UEs) التي تخدمها شبكة الجوال الخاصة. في هذا الدليل الإرشادي، ستتعلم كيفية توفير أجهزة SIM جديدة لشبكة جوال خاصة موجودة باستخدام قالب Azure Resource Manager (قالب ARM).

قالب Azure Resource Manager هو ملف JavaScript Object Notation (JSON) الذي يحدد البنية الأساسية والتكوين لمشروعك. يستخدم القالب عبارات توضيحية. يمكنك وصف النشر المقصود دون كتابة تسلسل أوامر البرمجة لإنشاء النشر.

إذا كانت بيئتك تلبي المتطلبات الأساسية وكنت معتاداً على استخدام قوالب "ARM"، فحدد زر "Deploy to Azure". سيتم فتح القالب في مدخل Azure.

المتطلبات الأساسية

تأكد من أنه يمكنك تسجيل الدخول إلى مدخل Microsoft Azure باستخدام حساب مع الوصول إلى الاشتراك النشط الذي حددته في إكمال المهام الأساسية لنشر شبكة جوال خاصة. يجب أن يكون لهذا الحساب دور المساهم المضمن في نطاق الاشتراك.
حدد اسم مورد شبكة الجوال المطابقة لشبكة الجوال الخاصة بك ومجموعة الموارد التي تحتوي عليها.
حدد منطقة Azure التي قمت بنشر شبكة الجوال الخاصة بك فيها.
اختر اسما لمجموعة SIM الجديدة التي ستتم إضافة SIMs إليها.
حدد نهج SIM الذي تريد تعيينه إلى SIMs التي تقوم بتوفيرها. يجب أن تكون قد أنشأت نهج SIM هذا بالفعل باستخدام الإرشادات الموجودة في تكوين نهج SIM - مدخل Microsoft Azure.

جمع المعلومات المطلوبة ل SIMs

للبدء، اجمع القيم في الجدول التالي لكل بطاقة SIM تريد توفيرها.

القيمة‬	اسم المعلمة
اسم بطاقة SIM. يجب أن يحتوي اسم SIM على أحرف أبجدية رقمية والشرطات والتسطير السفلي فقط.	`simName`
رقم تعريف بطاقة الدائرة المتكاملة (ICCID). يحدد ICCID بطاقة SIM فعلية محددة أو eSIM، ويتضمن معلومات عن بلد/منطقة بطاقة SIM ومصدرها. إن معرف غرفة التجارة الدولية اختياري وهو قيمة رقمية فريدة يتراوح طولها بين 19 و20 رقما، بدءا من 89 رقما.	`integratedCircuitCardIdentifier`
هوية المشترك الدولي للهاتف المحمول (IMSI). IMSI هو رقم فريد (عادة 15 رقما) يحدد جهازا أو مستخدما في شبكة جوال.	`internationalMobileSubscriberIdentity`
مفتاح المصادقة (Ki). Ki هي قيمة فريدة من نوعها 128 بت تم تعيينها لبطاقة SIM من قبل عامل تشغيل، ويتم استخدامها مع رمز عامل التشغيل المشتق (OPc) لمصادقة مستخدم. يجب أن تكون سلسلة مكونة من 32 حرفا، تحتوي على أحرف سداسية عشرية فقط.	`authenticationKey`
رمز عامل التشغيل المشتق (OPc). يتم أخذ OPc من Ki لبطاقة SIM ورمز مشغل الشبكة (OP). يستخدمه مثيل الحزمة الأساسي لمصادقة مستخدم باستخدام خوارزمية تستند إلى المعايير. يجب أن يكون OPc سلسلة مكونة من 32 حرفا، تحتوي على أحرف سداسية عشرية فقط.	`operatorKeyCode`
نوع الجهاز الذي يستخدم بطاقة SIM هذه. هذه القيمة هي سلسلة اختيارية ذات شكل حر. يمكنك استخدامه كما هو مطلوب لتحديد أنواع الأجهزة بسهولة باستخدام شبكة الجوال الخاصة بالمؤسسة.	`deviceType`
نهج SIM لتعيينه إلى بطاقة SIM. هذا اختياري، ولكن لن تتمكن أجهزة SIM الخاصة بك من استخدام شبكة الجوال الخاصة دون نهج SIM المعين.	`simPolicyId`

جمع المعلومات المطلوبة لتعيين عناوين IP ثابتة

تحتاج فقط إلى إكمال هذه الخطوة إذا تم تطبيق كل ما يلي:

أنت تستخدم صفيف JSON واحدا أو أكثر لتوفير SIMs.
لقد قمت بتكوين تخصيص عنوان IP ثابت لمثيل (مثيلات) الحزمة الأساسية.
تريد تعيين عناوين IP ثابتة إلى SIMs أثناء توفير SIM.

اجمع القيم في الجدول التالي لكل بطاقة SIM تريد توفيرها. إذا كانت شبكة الجوال الخاصة بك تحتوي على شبكات بيانات متعددة وتريد تعيين عنوان IP ثابت مختلف لكل شبكة بيانات إلى بطاقة SIM هذه، فجمع القيم لكل عنوان IP.

يجب أن يأتي كل عنوان IP من التجمع الذي قمت بتعيينه لتخصيص عنوان IP ثابت عند إنشاء شبكة البيانات ذات الصلة، كما هو موضح في تجميع قيم شبكة البيانات. لمزيد من المعلومات، راجع تخصيص تجمعات عناوين IP لمعدات المستخدم (UE).

القيمة‬	اسم الحقل في مدخل Microsoft Azure	اسم معلمة JSON
شبكة البيانات التي ستستخدمها بطاقة SIM.	غير قابل للتطبيق.	`staticIpConfiguration.attachedDataNetworkId`
شريحة الشبكة التي ستستخدمها بطاقة SIM.	غير قابل للتطبيق.	`staticIpConfiguration.sliceId`
عنوان IP الثابت لتعيينه إلى بطاقة SIM.	غير قابل للتطبيق.	`staticIpConfiguration.staticIpAddress`

إعداد صفيف JSON واحد أو أكثر ل SIMs

استخدم المعلومات التي جمعتها في تجميع المعلومات المطلوبة ل SIMs لإنشاء صفيف JSON واحد أو أكثر يحتوي على خصائص تصل إلى 1000 من SIMs التي تريد توفيرها. فيما يلي مثال على صفيف يحتوي على خصائص لاثنين من SIMs (SIM1 و SIM2).

إذا كنت لا تريد تعيين نهج SIM أو عنوان IP ثابت الآن، يمكنك حذف simPolicy المعلمتين و/أو .staticIpConfiguration

إشعار

الحد الأقصى لحجم نص طلب واجهة برمجة التطبيقات هو 4 ميغابايت. نوصي بإدخال 1000 SIM كحد أقصى لكل صفيف JSON للبقاء دون هذا الحد. إذا كنت ترغب في توفير أكثر من 1000 SIMs، قم بإنشاء صفائف متعددة وكرر عملية التزويد لكل منها. بدلا من ذلك، يمكنك استخدام مدخل Microsoft Azure لتوفير ما يصل إلى 10,000 SIMs لكل ملف JSON.

[
 {
  "simName": "SIM1",
  "integratedCircuitCardIdentifier": "8912345678901234566",
  "internationalMobileSubscriberIdentity": "001019990010001",
  "authenticationKey": "00112233445566778899AABBCCDDEEFF",
  "operatorKeyCode": "63bfa50ee6523365ff14c1f45f88737d",
  "deviceType": "Cellphone",
  "simPolicyId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/mobileNetworks/contoso-network/simPolicies/SimPolicy1",
  "staticIpConfiguration" :[
	{
	  "attachedDataNetworkId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/site-1/packetCoreDataPlanes/site-1/attachedDataNetworks/adn1",
	  "sliceId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/mobileNetworks/contoso-network/slices/slice-1",
	  "staticIpAddress": "10.132.124.54"
	},
    {
	  "attachedDataNetworkId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/site-1/packetCoreDataPlanes/site-1/attachedDataNetworks/adn2",
	  "sliceId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/mobileNetworks/contoso-network/slices/slice-1",
	  "staticIpAddress": "10.132.124.55"
	}
   ]
 },
 {
  "simName": "SIM2",
  "integratedCircuitCardIdentifier": "8922345678901234567",
  "internationalMobileSubscriberIdentity": "001019990010002",
  "authenticationKey": "11112233445566778899AABBCCDDEEFF",
  "operatorKeyCode": "63bfa50ee6523365ff14c1f45f88738d",
  "deviceType": "Sensor",
  "simPolicyId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/mobileNetworks/contoso-network/simPolicies/SimPolicy2",
  "staticIpConfiguration" :[
	{
	  "attachedDataNetworkId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/site-1/packetCoreDataPlanes/site-1/attachedDataNetworks/adn1",
	  "sliceId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/mobileNetworks/contoso-network/slices/slice-1",
	  "staticIpAddress": "10.132.124.54"
	},
	{
	  "attachedDataNetworkId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/site-1/packetCoreDataPlanes/site-1/attachedDataNetworks/adn2",
	  "sliceId": "/subscriptions/subid/resourceGroups/contoso-rg/providers/Microsoft.MobileNetwork/mobileNetworks/contoso-network/slices/slice-1",
	  "staticIpAddress": "10.132.124.55"
	}
   ]
 }
]

مراجعة القالب

يُعدّ النموذج المستخدم في هذا التشغيل السريع مأخوذاً من قوالب التشغيل السريع من Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.25.53.49325",
      "templateHash": "9173523895323587869"
    }
  },
  "parameters": {
    "location": {
      "type": "string",
      "metadata": {
        "description": "Region where the SIM group will be deployed (must match the resource group region)."
      }
    },
    "existingMobileNetworkName": {
      "type": "string",
      "metadata": {
        "description": "The name of the mobile network to which you are adding the SIM group."
      }
    },
    "existingSimPolicyName": {
      "type": "string",
      "metadata": {
        "description": "The name of the SIM policy to be assigned to the SIM(s)."
      }
    },
    "simGroupName": {
      "type": "string",
      "metadata": {
        "description": "The name for the SIM group."
      }
    },
    "existingEncryptionKeyUrl": {
      "type": "string",
      "defaultValue": "",
      "metadata": {
        "description": "A unversioned key vault key to encrypt the SIM data that belongs to this SIM group. For example: https://contosovault.vault.azure.net/keys/azureKey."
      }
    },
    "existingUserAssignedIdentityResourceId": {
      "type": "string",
      "defaultValue": "",
      "metadata": {
        "description": "User-assigned identity is an identity in Azure Active Directory that can be used to give access to other Azure resource such as Azure Key Vault. This identity should have Get, Wrap key, and Unwrap key permissions on the key vault."
      }
    },
    "simResources": {
      "type": "array",
      "metadata": {
        "description": "An array containing properties of the SIM(s) you wish to create. See [Provision proxy SIM(s)](https://docs.microsoft.com/en-gb/azure/private-5g-core/provision-sims-azure-portal) for a full description of the required properties and their format."
      }
    }
  },
  "resources": [
    {
      "copy": {
        "name": "exampleSimResources",
        "count": "[length(parameters('simResources'))]"
      },
      "type": "Microsoft.MobileNetwork/simGroups/sims",
      "apiVersion": "2024-02-01",
      "name": "[format('{0}/{1}', parameters('simGroupName'), parameters('simResources')[copyIndex()].simName)]",
      "properties": {
        "integratedCircuitCardIdentifier": "[parameters('simResources')[copyIndex()].integratedCircuitCardIdentifier]",
        "internationalMobileSubscriberIdentity": "[parameters('simResources')[copyIndex()].internationalMobileSubscriberIdentity]",
        "authenticationKey": "[parameters('simResources')[copyIndex()].authenticationKey]",
        "operatorKeyCode": "[parameters('simResources')[copyIndex()].operatorKeyCode]",
        "deviceType": "[parameters('simResources')[copyIndex()].deviceType]",
        "simPolicy": {
          "id": "[resourceId('Microsoft.MobileNetwork/mobileNetworks/simPolicies', parameters('existingMobileNetworkName'), parameters('existingSimPolicyName'))]"
        }
      },
      "dependsOn": [
        "[resourceId('Microsoft.MobileNetwork/simGroups', parameters('simGroupName'))]"
      ]
    },
    {
      "type": "Microsoft.MobileNetwork/simGroups",
      "apiVersion": "2024-02-01",
      "name": "[parameters('simGroupName')]",
      "location": "[parameters('location')]",
      "properties": {
        "mobileNetwork": {
          "id": "[resourceId('Microsoft.MobileNetwork/mobileNetworks', parameters('existingMobileNetworkName'))]"
        },
        "encryptionKey": {
          "keyUrl": "[parameters('existingEncryptionKeyUrl')]"
        }
      },
      "identity": "[if(not(empty(parameters('existingUserAssignedIdentityResourceId'))), createObject('type', 'UserAssigned', 'userAssignedIdentities', createObject(format('{0}', parameters('existingUserAssignedIdentityResourceId')), createObject())), createObject('type', 'None'))]"
    }
  ]
}

يتم تعريف موارد Azure التالية في القالب.

Microsoft.MobileNetwork/simGroups: مورد يمثل مجموعة SIM.
Microsoft.MobileNetwork/simGroups/sims: مورد يمثل بطاقة SIM فعلية أو eSIM.

نشر القالب

حدد الرابط التالي لتسجيل الدخول إلى Azure وفتح قالب.
حدد القيم التالية أو أدخلها، باستخدام المعلومات التي قمت باستردادها في المتطلبات الأساسية.
- الاشتراك: حدد اشتراك Azure الذي استخدمته لإنشاء شبكة الجوال الخاصة بك.
- مجموعة الموارد: حدد مجموعة الموارد التي تحتوي على مورد شبكة الجوال الذي يمثل شبكة الجوال الخاصة بك.
- المنطقة: حدد المنطقة التي قمت بنشر شبكة الجوال الخاصة فيها.
- الموقع: أدخل اسم التعليمات البرمجية للمنطقة التي قمت بنشر شبكة الجوال الخاصة فيها.
- اسم شبكة الجوال الموجودة: أدخل اسم مورد شبكة الجوال الذي يمثل شبكة الجوال الخاصة بك.
- اسم نهج Sim الموجود: أدخل اسم نهج SIM الذي تريد تعيينه إلى SIMs.
- اسم مجموعة Sim: أدخل اسم مجموعة SIM الجديدة.
- موارد Sim: الصق في أحد صفائف JSON التي أعددتها في إعداد صفيف JSON واحد أو أكثر ل SIMs.
حدد "Review + create".
سيقوم Azure الآن بالتحقق من صحة قيم التكوين التي أدخلتها. يجب أن تشاهد رسالة تشير إلى أن قيمك قد اجتازت التحقق من الصحة.

إذا فشل التحقق من الصحة، فسترى رسالة خطأ وسيتم وضع علامة تبويب التكوين (علامات) التكوين التي تحتوي على التكوين غير الصالح. حدد علامة التبويب (علامات) المعلمة واستخدم رسائل الخطأ لتصحيح التكوين غير الصالح قبل العودة إلى علامة التبويب مراجعة + إنشاء .
بمجرد التحقق من صحة التكوين الخاص بك، يمكنك تحديد إنشاء لتوفير SIMs. سيعرض مدخل Microsoft Azure شاشة تأكيد عند توفير SIMs.
إذا كنت تقوم بتوفير أكثر من 1000 SIMs، كرر هذه العملية لكل صفائف JSON.