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

Makale
04/10/2024

SIM kaynakları , özel mobil ağ tarafından hizmet sunulan kullanıcı ekipmanı (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.

Azure Resource Manager ş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. Dağıtımı oluşturmak için programlama komutlarının sırasını yazmadan hedeflenen dağıtımınızı açıklarsınız.

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 hesabı kullanarak Azure portalında 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 ve onu içeren kaynak grubuna karşılık gelen Mobil Ağ kaynağının adını belirleyin.
Özel mobil ağınızın dağıtıldığı 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 basamak).	`internationalMobileSubscriberIdentity`
Kimlik Doğrulama Anahtarı (Ki). Ki, bir operatör 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ı 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`

Statik IP adresleri atamak için gerekli bilgileri toplama

Bu adımı yalnızca aşağıdakilerin tümü geçerliyse tamamlamanız gerekir:

SIM'lerinizi sağlamak için bir veya daha fazla JSON dizisi kullanıyorsunuz.
Paket çekirdeği örnekleriniz için statik IP adresi ayırmayı yapılandırdıysanız.
SIM sağlama sırasında SIM'lere statik IP adresleri atamak istiyorsunuz.

Sağlamak istediğiniz her SIM için aşağıdaki tabloda yer alan değerleri toplayın. Özel mobil ağınızda birden çok veri ağı varsa ve bu SIM'e her veri ağı için farklı bir statik IP adresi atamak istiyorsanız, her IP adresi için değerleri toplayın.

Her IP adresi, Veri ağı değerlerini toplama bölümünde açıklandığı gibi ilgili veri ağını oluştururken statik IP adresi ayırması için atadığınız havuzdan gelmelidir. Daha fazla bilgi için bkz . Kullanıcı Donanımı (UE) IP adresi havuzlarını ayırma.

Değer	Azure portalında alan adı	JSON parametre adı
SIM'in kullanacağı veri ağı.	Uygulanamaz.	`staticIpConfiguration.attachedDataNetworkId`
SIM'in kullanacağı ağ dilimi.	Uygulanamaz.	`staticIpConfiguration.sliceId`
SIM'e atanacak statik IP adresi.	Uygulanamaz.	`staticIpConfiguration.staticIpAddress`

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

Sağlamak istediğiniz SIM'lerin en fazla 1000'i için özellikler 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.

Şimdi bir SIM ilkesi veya statik IP adresi atamak istemiyorsanız ve/veya staticIpConfiguration parametrelerini silebilirsinizsimPolicy.

Not

API istek gövdesinin en büyük boyutu 4 MB'tır. Bu sınırın altında kalmak için JSON dizisi başına en fazla 1000 SIM girmenizi öneririz. 1000'den fazla SIM sağlamak istiyorsanız, birden çok dizi oluşturun ve her biri için sağlama işlemini yineleyin. Alternatif olarak, JSON dosyası başına en fazla 10.000 SIM sağlamak için Azure portalını kullanabilirsiniz.

[
 {
  "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.27.1.19265",
      "templateHash": "7026271350043138477"
    }
  },
  "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-04-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-04-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ımlanı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

Azure'da oturum açmak ve bir şablon açmak için aşağıdaki bağlantıyı seçin.
Ö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 JSON dizisi 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ğrulayacaktır. 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.
1000'den fazla SIM sağlanıyorsa, 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.