Azure Özel 5G Core için yeni SIM'ler sağlama - ARM şablonu

Makale
09/14/2023

SIM kaynakları , özel mobil ağ tarafından hizmet edilen kullanıcı ekipmanları (UE) tarafından kullanılan fiziksel SIM'leri veya eSIM'leri temsil eder. Bu nasıl yapılır kılavuzunda, Azure Resource Manager şablonu (ARM şablonu) kullanarak mevcut bir özel mobil ağ için yeni SIM'ler sağlamayı öğreneceksiniz.

Kaynak yöneticisi şablonu, projenizin altyapısını ve yapılandırmasını tanımlayan bir JavaScript Nesne Gösterimi (JSON) dosyasıdır. Bu şablonda, bildirim temelli sözdizimi kullanılır. Bildirim temelli sözdiziminde, dağıtım oluşturmak için programlama komutlarının dizisini yazmadan amaçladığınız dağıtımı ifade edersiniz.

Ortamınız önkoşulları karşılıyorsa ve ARM şablonlarını kullanma hakkında bilginiz varsa, Azure’a dağıtma düğmesini seçin. Şablon Azure portalda açılır.

Önkoşullar

Özel mobil ağ dağıtmak için önkoşul görevlerini tamamlama bölümünde tanımladığınız etkin aboneliğe erişimi olan bir hesap kullanarak Azure portal oturum açabildiğinizi doğrulayın. Bu hesabın abonelik kapsamında yerleşik Katkıda Bulunan rolüne sahip olması gerekir.
Özel mobil ağınıza karşılık gelen Mobil Ağ kaynağının adını ve onu içeren kaynak grubunu belirleyin.
Özel mobil ağınızı dağıtılan Azure bölgesini belirleyin.
SIM'lerinizin eklendiği yeni SIM grubu için bir ad seçin.
Sağladığınız SIM'lere atamak istediğiniz SIM ilkesini belirleyin. Sim ilkesi yapılandırma - Azure portal başlığındaki yönergeleri kullanarak bu SIM ilkesini önceden oluşturmuş olmanız gerekir.

SIM'leriniz için gerekli bilgileri toplama

Başlamak için, sağlamak istediğiniz her SIM için aşağıdaki tabloda yer alan değerleri toplayın.

Değer	Parametre adı
SIM adı. SIM adı yalnızca alfasayısal karakterler, kısa çizgiler ve alt çizgi içermelidir.	`simName`
Tümleşik Devre Kartı Kimlik Numarası (ICCID). ICCID belirli bir fiziksel SIM'i veya eSIM'i tanımlar ve SIM'in ülkesi/bölgesi ve vereni hakkında bilgi içerir. ICCID isteğe bağlıdır ve 89 ile başlayarak 19 ile 20 basamak arasında benzersiz bir sayısal değerdir.	`integratedCircuitCardIdentifier`
Uluslararası mobil abone kimliği (IMSI). IMSI, mobil ağdaki bir cihazı veya kullanıcıyı tanımlayan benzersiz bir sayıdır (genellikle 15 basamaktır).	`internationalMobileSubscriberIdentity`
Kimlik Doğrulama Anahtarı (Ki). Ki, bir işleç tarafından SIM'e atanan benzersiz bir 128 bit değerdir ve bir kullanıcının kimliğini doğrulamak için türetilmiş işleç koduyla (OPc) kullanılır. Yalnızca onaltılık karakterler içeren 32 karakterlik bir dize olmalıdır.	`authenticationKey`
Türetilmiş işleç kodu (OPc). OPc, SIM'in Ki'sinden ve ağın operatör kodundan (OP) alınır. Paket çekirdek örneği, standart tabanlı bir algoritma kullanarak kullanıcının kimliğini doğrulamak için bunu kullanır. OPc, yalnızca onaltılık karakterler içeren 32 karakterlik bir dize olmalıdır.	`operatorKeyCode`
Bu SIM'i kullanan cihaz türü. Bu değer isteğe bağlı bir serbest biçimli dizedir. Kuruluşun özel mobil ağını kullanarak cihaz türlerini kolayca tanımlamak için gerektiği gibi kullanabilirsiniz.	`deviceType`
SIM'e atanacak SIM ilkesi. Bu isteğe bağlıdır, ancak SIM'leriniz atanmış bir SIM ilkesi olmadan özel mobil ağı kullanamaz.	`simPolicyId`

SIM'leriniz için bir veya daha fazla dizi hazırlama

Sağlamak istediğiniz SIM'lerin en fazla 500'ünün özelliklerini içeren bir veya daha fazla JSON dizisi oluşturmak için SIM'leriniz için gerekli bilgileri toplama bölümünde topladığınız bilgileri kullanın. Aşağıda, iki SIM ' in (SIM1 ve SIM2) özelliklerini içeren bir dizi örneği verilmiştir.

Önemli

Toplu SIM sağlama 500 SIM ile sınırlıdır. Bu 500 SIM'den daha fazlasını sağlamak istiyorsanız, herhangi bir dizide 500 SIM'den fazla OLMAYAN birden çok SIM dizisi oluşturmanız ve sağlama işlemini her SIM dizisi için yinelemeniz gerekir.

Bu SIM için parametreyi staticIpConfiguration silin.

[
 {
  "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"
	}
   ]
 }
]

Şablonu gözden geçirme

Bu hızlı başlangıçta kullanılan şablon Azure Hızlı Başlangıç Şablonlarından alınmıştır.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.19.5.34762",
      "templateHash": "9849936408650350256"
    }
  },
  "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": "2023-06-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": "2023-06-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'))]"
    }
  ]
}

Şablonda aşağıdaki Azure kaynakları tanımlanmıştır.

Microsoft.MobileNetwork/simGroups: SIM grubunu temsil eden bir kaynak.
Microsoft.MobileNetwork/simGroups/sims: Fiziksel SIM veya eSIM'i temsil eden bir kaynak.

Şablonu dağıtma

Aşağıdaki bağlantıyı seçerek Azure’da oturum açıp bir şablon açın.
Önkoşullar bölümünde aldığınız bilgileri kullanarak aşağıdaki değerleri seçin veya girin.
- Abonelik: Özel mobil ağınızı oluşturmak için kullandığınız Azure aboneliğini seçin.
- Kaynak grubu: Özel mobil ağınızı temsil eden Mobil Ağ kaynağını içeren kaynak grubunu seçin.
- Bölge: Özel mobil ağı dağıtılan bölgeyi seçin.
- Konum: Özel mobil ağı dağıtılan bölgenin kod adını girin.
- Mevcut Mobil Ağ Adı: Özel mobil ağınızı temsil eden Mobil Ağ kaynağının adını girin.
- Mevcut Sim İlkesi Adı: SIM'lere atamak istediğiniz SIM ilkesinin adını girin.
- Sim Grubu Adı: Yeni SIM grubunun adını girin.
- Sim Kaynakları:SIM'leriniz için bir veya daha fazla dizi hazırlama bölümünde hazırladığınız JSON dizilerinden birini yapıştırın.
Gözden geçir ve oluştur’u seçin.
Azure artık girdiğiniz yapılandırma değerlerini doğrular. Değerlerinizin doğrulamadan geçtiğini belirten bir ileti görmeniz gerekir.

Doğrulama başarısız olursa bir hata iletisi görürsünüz ve geçersiz yapılandırmayı içeren Yapılandırma sekmeleri işaretlenir. Bayrak eklenmiş sekmeleri seçin ve Gözden Geçir + oluştur sekmesine dönmeden önce geçersiz yapılandırmayı düzeltmek için hata iletilerini kullanın.
Yapılandırmanız doğrulandıktan sonra, SIM'lerinizi sağlamak için Oluştur'u seçebilirsiniz. AZURE PORTAL, SIM'ler sağlandığında bir onay ekranı görüntüler.
500'den fazla SIM sağlarsanız, JSON dizilerinizin her biri için bu işlemi yineleyin.

Dağıtılan kaynakları gözden geçirme

Kaynak grubuna git'i seçin.
SIM Grubu kaynağının kaynak grubunda oluşturulduğunu onaylayın.
SIM Grubu kaynağını seçin ve tüm SIM'lerinizin doğru sağlandığını onaylayın.

Sonraki adımlar

Azure portal kullanarak bu SIM'leri yönetebilirsiniz.