Zřízení nových SIM adres pro Azure Private 5G Core – šablona ARM

Článek
09/14/2023

Prostředky SIM představují fyzické SIM karty nebo eSIM používané uživatelským vybavením obsluhované privátní mobilní sítí. V tomto návodu se dozvíte, jak zřídit nové SIM adresy pro existující privátní mobilní síť pomocí šablony Azure Resource Manager (šablony ARM).

Šablona Resource Manageru je soubor JSON (JavaScript Object Notation), který definuje infrastrukturu a konfiguraci pro váš projekt. Tato šablona používá deklarativní syntaxi. V deklarativní syntaxi popíšete zamýšlené nasazení, aniž byste museli psát sekvenci programovacích příkazů pro vytvoření tohoto nasazení.

Pokud vaše prostředí splňuje požadavky a jste obeznámeni s používáním šablon ARM, vyberte tlačítko Nasazení do Azure. Šablona se otevře v prostředí Azure Portal.

Požadavky

Ujistěte se, že se můžete přihlásit k Azure Portal pomocí účtu s přístupem k aktivnímu předplatnému, které jste určili v tématu Dokončení požadovaných úloh pro nasazení privátní mobilní sítě. Tento účet musí mít předdefinovanou roli Přispěvatel v oboru předplatného.
Identifikujte název prostředku mobilní sítě odpovídající vaší privátní mobilní síti a skupinu prostředků, která ho obsahuje.
Určete oblast Azure, ve které jste nasadili privátní mobilní síť.
Zvolte název nové skupiny SIM karet, do které se sim karty přidají.
Určete zásady SIM karty, které chcete přiřadit k SIM kartami, které zřizujete. Tuto zásadu SIM karty už musíte vytvořit podle pokynů v tématu Konfigurace zásad SIM – Azure Portal.

Shromáždění požadovaných informací pro SIM služby

Začněte tím, že shromáždíte hodnoty v následující tabulce pro každou SIM kartu, kterou chcete zřídit.

Hodnota	Název parametru
Název SIM karty. Název SIM karty musí obsahovat jenom alfanumerické znaky, pomlčky a podtržítka.	`simName`
Identifikační číslo karty integrovaného okruhu (ICCID). ICCID identifikuje konkrétní fyzickou SIM kartu nebo eSIM kartu a obsahuje informace o zemi/oblasti a vydavateli SIM karty. IcCID je volitelný a jedná se o jedinečnou číselnou hodnotu o délce 19 až 20 číslic, počínaje číslem 89.	`integratedCircuitCardIdentifier`
ImSI (International Mobile Subscriber Identity). IMSI je jedinečné číslo (obvykle 15 číslic), které identifikuje zařízení nebo uživatele v mobilní síti.	`internationalMobileSubscriberIdentity`
Ověřovací klíč (Ki). Ki je jedinečná 128bitová hodnota přiřazená k SIM kartě operátorem a používá se s kódem odvozeného operátora (OPc) k ověření uživatele. Musí se jednat o 32znakový řetězec obsahující pouze šestnáctkové znaky.	`authenticationKey`
Kód odvozeného operátoru (OPc). OPc se přebírá z Ki SIM karty a z kódu operátora sítě (OP). Instance jádra paketu ji používá k ověření uživatele pomocí algoritmu založeného na standardech. OPC musí být řetězec o délce 32 znaků, který obsahuje pouze šestnáctkové znaky.	`operatorKeyCode`
Typ zařízení, které používá tuto SIM kartu. Tato hodnota je volitelný řetězec volného tvaru. Podle potřeby ho můžete použít ke snadné identifikaci typů zařízení pomocí privátní mobilní sítě podniku.	`deviceType`
Zásady SIM karty, které se mají k SIM kartě přiřadit. Tato možnost je volitelná, ale vaše SIM karty nebudou moct používat privátní mobilní síť bez přiřazených zásad SIM.	`simPolicyId`

Příprava jednoho nebo více polí pro SIMs

Pomocí informací, které jste shromáždili v části Shromáždění požadovaných informací pro SIM karty, vytvořte jedno nebo více polí JSON obsahujících vlastnosti až pro 500 SIM, které chcete zřídit. Následuje příklad pole obsahujícího vlastnosti pro dvě SIM karty (SIM1 a SIM2).

Důležité

Zřizování hromadné SIM karty je omezené na 500 SIM karet. Pokud chcete zřídit více než 500 SIM karet, musíte vytvořit několik polí SIM s maximálně 500 SIM kartami v jednom poli a opakovat proces zřizování pro každé pole SIM.

Odstraňte parametr pro danou staticIpConfiguration SIM kartu.

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

Kontrola šablony

Šablona použitá v tomto rychlém startu je jednou z šablon pro rychlý start Azure.

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

V šabloně jsou definované následující prostředky Azure.

Microsoft.MobileNetwork/simGroups: prostředek představující skupinu SIM.
Microsoft.MobileNetwork/simGroups/sims: prostředek představující fyzickou SIM kartu nebo eSIM kartu.

Nasazení šablony

Vyberte následující odkaz, přihlaste se k Azure a otevřete šablonu.
Pomocí informací, které jste získali v části Požadavky, vyberte nebo zadejte následující hodnoty.
- Předplatné: Vyberte předplatné Azure, které jste použili k vytvoření privátní mobilní sítě.
- Skupina prostředků: Vyberte skupinu prostředků obsahující prostředek mobilní sítě představující vaši privátní mobilní síť.
- Oblast: Vyberte oblast, ve které jste nasadili privátní mobilní síť.
- Umístění: Zadejte název kódu oblasti, ve které jste nasadili privátní mobilní síť.
- Existující název mobilní sítě: Zadejte název prostředku mobilní sítě, který představuje vaši privátní mobilní síť.
- Název existující zásady sim karty: Zadejte název zásad SIM, které chcete přiřadit SIM karty.
- Název skupiny SIM: Zadejte název nové skupiny SIM karet.
- Prostředky SIM: Vložte jedno z polí JSON, která jste připravili v tématu Příprava jednoho nebo více polí pro SIM karty.
Vyberte Zkontrolovat a vytvořit.
Azure teď ověří hodnoty konfigurace, které jste zadali. Měla by se zobrazit zpráva oznamující, že vaše hodnoty prošly ověřením.

Pokud se ověření nezdaří, zobrazí se chybová zpráva a karty Konfigurace obsahující neplatnou konfiguraci se označí příznakem. Než se vrátíte na kartu Zkontrolovat a vytvořit , vyberte karty označené příznakem a pomocí chybových zpráv opravte neplatnou konfiguraci.
Po ověření konfigurace můžete vybrat Vytvořit a zřizovat SIM. Azure Portal zobrazí potvrzovací obrazovku po zřízení SIM.
Pokud zřizujete více než 500 SIM, opakujte tento postup pro každé pole JSON.

Kontrola nasazených prostředků

Vyberte Přejít do skupiny prostředků.
Ověřte, že se prostředek skupiny SIM karet vytvořil ve skupině prostředků.
Vyberte prostředek SKUPINY SIM a ověřte, že jsou všechny vaše SIM karty správně zřízené.

Další kroky

Tyto SIM sady můžete spravovat pomocí Azure Portal.