Bagikan melalui

Menyediakan SIM baru untuk Azure Private 5G Core - templat ARM

  • Artikel

Sumber daya SIM mewakili SIM fisik atau eSIM yang digunakan oleh peralatan pengguna (EA) yang dilayani oleh jaringan seluler privat. Dalam panduan cara ini, Anda akan mempelajari cara memprovisikan SIM baru untuk jaringan seluler privat yang ada menggunakan templat Azure Resource Manager (templat ARM).

Templat Azure Resource Manager adalah file JavaScript Object Notation (JSON) yang menentukan infrastruktur dan konfigurasi untuk proyek Anda. Template tersebut menggunakan sintaksis deklaratif. Anda menjelaskan penyebaran yang Dimaksudkan tanpa menulis urutan perintah pemrograman untuk membuat penyebaran.

Jika lingkungan Anda telah memenuhi prasyarat dan Anda terbiasa menggunakan templat ARM, pilih tombol Sebarkan ke Azure. Templat akan terbuka di portal Microsoft Azure.

Tombol untuk menyebarkan templat Resource Manager ke Azure.

Prasyarat

  • Pastikan Anda dapat masuk ke portal Azure menggunakan akun dengan akses ke langganan aktif yang Anda identifikasi di Menyelesaikan tugas prasyarat untuk menyebarkan jaringan seluler privat. Akun ini harus memiliki peran Kontributor bawaan di cakupan langganan.
  • Identifikasi nama sumber daya Jaringan Seluler yang sesuai dengan jaringan seluler privat Anda dan grup sumber daya yang berisinya.
  • Identifikasi wilayah Azure tempat Anda menyebarkan jaringan seluler privat Anda.
  • Pilih nama untuk grup SIM baru tempat SIM Anda akan ditambahkan.
  • Identifikasi kebijakan SIM yang ingin Anda tetapkan ke SIM yang Anda provisikan. Anda harus sudah membuat kebijakan SIM ini menggunakan instruksi dalam Mengonfigurasi kebijakan SIM - portal Azure.

Mengumpulkan informasi yang diperlukan untuk SIM Anda

Untuk memulai, kumpulkan nilai dalam tabel berikut untuk setiap SIM yang ingin Anda provisikan.

Nilai Nama Parameter
Nama SIM. Nama SIM hanya boleh berisi karakter alfanumerik, tanda hubung, dan garis bawah. simName
Nomor Identifikasi Kartu Sirkuit Terpadu (ICCID). ICCID mengidentifikasi SIM fisik atau eSIM tertentu, dan menyertakan informasi tentang negara/wilayah dan penerbit SIM. ICCID bersifat opsional dan merupakan nilai numerik unik antara 19 dan 20 digit, dimulai dengan 89. integratedCircuitCardIdentifier
Identitas pelanggan seluler internasional (IMSI). IMSI adalah nomor unik (biasanya 15 digit) yang mengidentifikasi perangkat atau pengguna di jaringan seluler. internationalMobileSubscriberIdentity
Kunci Autentikasi (Ki). Ki adalah nilai unik 128-bit yang ditetapkan ke SIM oleh operator, dan digunakan dengan kode operator turunan (OPc) untuk mengautentikasi pengguna. Ini harus berupa string 32 karakter, hanya berisi karakter heksadesimal. authenticationKey
Kode operator turunan (OPc). OPc diambil dari KI SIM dan kode operator jaringan (OP). Instans inti paket menggunakannya untuk mengautentikasi pengguna menggunakan algoritma berbasis standar. OPc harus berupa string 32 karakter, yang hanya berisi karakter heksadesimal. operatorKeyCode
Jenis perangkat yang menggunakan SIM ini. Nilai ini adalah string bentuk bebas opsional. Anda dapat menggunakannya sesuai kebutuhan untuk dengan mudah mengidentifikasi jenis perangkat menggunakan jaringan seluler privat perusahaan. deviceType
Kebijakan SIM untuk ditetapkan ke SIM. Ini bersifat opsional, tetapi SIM Anda tidak akan dapat menggunakan jaringan seluler privat tanpa kebijakan SIM yang ditetapkan. simPolicyId

Mengumpulkan informasi yang diperlukan untuk menetapkan alamat IP statis

Anda hanya perlu menyelesaikan langkah ini jika semua hal berikut ini berlaku:

  • Anda menggunakan satu atau beberapa array JSON untuk memprovisikan SIM Anda.
  • Anda telah mengonfigurasi alokasi alamat IP statis untuk instans inti paket Anda.
  • Anda ingin menetapkan alamat IP statis ke SIM selama provisi SIM.

Kumpulkan nilai dalam tabel berikut untuk setiap SIM yang ingin Anda provisikan. Jika jaringan seluler privat Anda memiliki beberapa jaringan data dan Anda ingin menetapkan alamat IP statis yang berbeda untuk setiap jaringan data ke SIM ini, kumpulkan nilai untuk setiap alamat IP.

Setiap alamat IP harus berasal dari kumpulan yang Anda tetapkan untuk alokasi alamat IP statis saat membuat jaringan data yang relevan, seperti yang dijelaskan dalam Mengumpulkan nilai jaringan data. Untuk informasi selengkapnya, lihat Mengalokasikan kumpulan alamat IP Peralatan Pengguna (UE).

Nilai Nama bidang di portal Azure Nama parameter JSON
Jaringan data yang akan digunakan SIM. Tidak berlaku. staticIpConfiguration.attachedDataNetworkId
Iringan jaringan yang akan digunakan SIM. Tidak berlaku. staticIpConfiguration.sliceId
Alamat IP statis untuk ditetapkan ke SIM. Tidak berlaku. staticIpConfiguration.staticIpAddress

Menyiapkan satu atau beberapa array JSON untuk SIM Anda

Gunakan informasi yang Anda kumpulkan di Mengumpulkan informasi yang diperlukan untuk SIM Anda untuk membuat satu atau beberapa array JSON yang berisi properti hingga 1000 SIM yang ingin Anda provisikan. Berikut ini adalah contoh array yang berisi properti untuk dua SIM (SIM1 dan SIM2).

Jika Anda tidak ingin menetapkan kebijakan SIM atau alamat IP statis sekarang, Anda dapat menghapus simPolicy parameter dan/atau staticIpConfiguration .

Catatan

Ukuran maksimum isi permintaan API adalah 4MB. Sebaiknya masukkan maksimum 1000 SIM per array JSON agar tetap di bawah batas ini. Jika Anda ingin menyediakan lebih dari 1000 SIM, buat beberapa array dan ulangi proses provisi untuk masing-masing. Atau, Anda dapat menggunakan portal Azure untuk memprovisikan hingga 10.000 SIM per file 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"
	}
   ]
 }
]

Meninjau templat

Templat yang digunakan di mulai cepat ini berasal dari Templat Mulai Cepat Azure.

{
  "$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'))]"
    }
  ]
}

Sumber daya Azure berikut didefinisikan dalam templat.

Menyebarkan templat

  1. Pilih tautan berikut untuk masuk ke Azure dan membuka template.

    Tombol untuk menyebarkan templat Resource Manager ke Azure.

  2. Pilih atau masukkan nilai berikut, menggunakan informasi yang Anda ambil di Prasyarat.

    • Langganan: pilih langganan Azure yang Anda gunakan untuk membuat jaringan seluler privat Anda.
    • Grup sumber daya: pilih grup sumber daya yang berisi sumber daya Jaringan Seluler yang mewakili jaringan seluler privat Anda.
    • Wilayah: pilih wilayah tempat Anda menyebarkan jaringan seluler privat.
    • Lokasi: masukkan nama kode wilayah tempat Anda menyebarkan jaringan seluler privat.
    • Nama Jaringan Seluler yang Ada: masukkan nama sumber daya Jaringan Seluler yang mewakili jaringan seluler privat Anda.
    • Nama Kebijakan SIM yang ada: masukkan nama kebijakan SIM yang ingin Anda tetapkan ke SIM.
    • Nama Grup SIM: masukkan nama untuk grup SIM baru.
    • Sumber Daya Sim: tempelkan salah satu array JSON yang Anda siapkan di Menyiapkan satu atau beberapa array JSON untuk SIM Anda.

    Cuplikan layar portal Azure memperlihatkan bidang konfigurasi untuk templat SIM ARM.

  3. Pilih Tinjau + buat.

  4. Azure sekarang akan memvalidasi nilai konfigurasi yang telah Anda masukkan. Anda akan melihat pesan yang menunjukkan bahwa nilai Anda telah melewati validasi.

    Jika validasi gagal, Anda akan melihat pesan kesalahan dan tab Konfigurasi yang berisi konfigurasi yang tidak valid akan ditandai. Pilih tab yang ditandai dan gunakan pesan kesalahan untuk memperbaiki konfigurasi yang tidak valid sebelum kembali ke tab Tinjau + buat .

  5. Setelah konfigurasi divalidasi, Anda dapat memilih Buat untuk memprovisikan SIM Anda. portal Azure akan menampilkan layar konfirmasi ketika SIM telah disediakan.

  6. Jika Anda menyediakan lebih dari 1000 SIM, ulangi proses ini untuk setiap array JSON Anda.

Meninjau sumber daya yang disebarkan

  1. Pilih Masuk ke grup sumber daya.

    Cuplikan layar portal Azure memperlihatkan konfirmasi penyebaran untuk templat ARM.

  2. Konfirmasikan bahwa sumber daya Grup SIM telah dibuat di grup sumber daya.

    Cuplikan layar portal Azure memperlihatkan grup sumber daya yang berisi grup SIM yang baru dibuat.

  3. Pilih sumber daya Grup SIM dan konfirmasikan bahwa semua SIM Anda telah disediakan dengan benar.

    Cuplikan layar portal Azure memperlihatkan sumber daya grup SIM yang berisi SIM.

Langkah berikutnya