Share via

Új SIM-ek kiépítése az Azure Private 5G Core - ARM-sablonhoz

  • Cikk

A SIM-erőforrások a magán mobilhálózat által használt felhasználói berendezések által használt fizikai SIM-eket vagy eSIM-eket jelölik. Ebben az útmutatóban megtudhatja, hogyan építhet ki új SIM-eket egy meglévő privát mobilhálózathoz egy Azure Resource Manager-sablon (ARM-sablon) használatával.

Az Azure Resource Manager-sablon egy JavaScript Object Notation (JSON) fájl, amely meghatározza a projekt infrastruktúráját és konfigurációját. A sablon deklaratív szintaxist használ. Az üzembe helyezés létrehozásához szükséges programozási parancsok sorozatának megírása nélkül írhatja le a tervezett üzembe helyezést.

Ha a környezet megfelel az előfeltételeknek, és már ismeri az ARM-sablonokat, kattintson az Üzembe helyezés az Azure-ban gombra. A sablon az Azure Portalon fog megnyílni.

Gomb a Resource Manager-sablon Azure-ban való üzembe helyezéséhez.

Előfeltételek

  • Győződjön meg arról, hogy bejelentkezhet az Azure Portalra egy olyan fiókkal, amely hozzáféréssel rendelkezik a privát mobilhálózat üzembe helyezéséhez szükséges előfeltételek elvégzésével azonosított aktív előfizetéshez. Ennek a fióknak beépített közreműködői szerepkörrel kell rendelkeznie az előfizetés hatókörében.
  • Azonosítsa a saját mobilhálózatának megfelelő mobilhálózati erőforrás nevét és az azt tartalmazó erőforráscsoportot.
  • Azonosítsa azt az Azure-régiót, amelyben a privát mobilhálózatot üzembe helyezte.
  • Adja meg annak az új SIM-csoportnak a nevét, amelyhez az SIM-ek hozzá lesznek adva.
  • Azonosítsa a kiépíteni kívánt SIM-ekhez hozzárendelni kívánt SIM-szabályzatot. Ezt a SIM-szabályzatot már létrehozta a SIM-szabályzat konfigurálása – Azure Portal utasításait követve.

Gyűjtse össze az SIM-ekhez szükséges információkat

Először gyűjtse össze az alábbi táblázatban szereplő értékeket minden kiépíteni kívánt SIM-hez.

Érték Paraméter neve
SIM-név. A SIM-név csak alfanumerikus karaktereket, kötőjeleket és aláhúzásjeleket tartalmazhat. simName
Az integrált áramköri kártya azonosítószáma (ICCID). Az ICCID azonosít egy adott fizikai SIM-et vagy eSIM-et, és információkat tartalmaz a SIM országáról/régiójáról és kibocsátójától. Az ICCID nem kötelező, és 19 és 20 számjegy közötti egyedi numerikus érték, 89-től kezdődően. integratedCircuitCardIdentifier
A nemzetközi mobil előfizetői identitás (IMSI). Az IMSI egy egyedi szám (általában 15 számjegy), amely egy mobileszközt vagy felhasználót azonosít egy mobilhálózaton. internationalMobileSubscriberIdentity
A hitelesítési kulcs (Ki). A Ki egy egyedi 128 bites érték, amelyet egy operátor rendel a SIM-hez, és a származtatott operátorkóddal (OPc) használja a felhasználó hitelesítéséhez. Csak hexadecimális karaktereket tartalmazó 32 karakterből álló sztringnek kell lennie. authenticationKey
A származtatott operátor kódja (OPc). Az OPc a SIM ki- és a hálózat operátorkódjából (OP) származik. A csomagmagpéldány egy szabványalapú algoritmus használatával hitelesíti a felhasználót. Az OPc csak hexadecimális karaktereket tartalmazó 32 karakterből álló sztring lehet. operatorKeyCode
A SIM-et használó eszköz típusa. Ez az érték nem kötelező szabad formátumú sztring. Szükség szerint használhatja az eszköztípusok egyszerű azonosításához a vállalat privát mobilhálózatával. deviceType
A SIM-hez hozzárendelendő SIM-szabályzat. Ez nem kötelező, de az SIM-ek nem fogják tudni használni a privát mobilhálózatot hozzárendelt SIM-szabályzat nélkül. simPolicyId

A statikus IP-címek hozzárendeléséhez szükséges információk összegyűjtése

Ezt a lépést csak akkor kell végrehajtania, ha az alábbiak mindegyike érvényes:

  • Egy vagy több JSON-tömböt használ az SIM-ek kiépítéséhez.
  • Konfigurálta a csomagmagpéldány(ok) statikus IP-címfoglalását.
  • A SIM-kiépítés során statikus IP-címeket szeretne hozzárendelni az SIM-ekhez.

Gyűjtse össze az alábbi táblázatban szereplő értékeket minden kiépíteni kívánt SIM-hez. Ha a privát mobilhálózat több adathálózattal rendelkezik, és minden egyes adathálózathoz más statikus IP-címet szeretne hozzárendelni ehhez a SIM-hez, gyűjtse össze az egyes IP-címek értékeit.

Minden IP-címnek abból a készletből kell származnia, amelyet a megfelelő adathálózat létrehozásakor a statikus IP-címfoglaláshoz rendelt, az adathálózati értékek összegyűjtése című szakaszban leírtak szerint. További információ: Felhasználói berendezések lefoglalása (UE) IP-címkészletek.

Érték Mezőnév az Azure Portalon JSON-paraméter neve
A SIM által használt adathálózat. Nem alkalmazható. staticIpConfiguration.attachedDataNetworkId
A SIM által használt hálózati szelet. Nem alkalmazható. staticIpConfiguration.sliceId
A SIM-hez hozzárendelendő statikus IP-cím. Nem alkalmazható. staticIpConfiguration.staticIpAddress

Egy vagy több JSON-tömb előkészítése az SIM-ekhez

Használja a Gyűjtse össze az SIM-ekhez szükséges információkat, hogy létrehozzon egy vagy több JSON-tömböt, amelyek legfeljebb 1000 kiépítendő SIM-hez tartalmaznak tulajdonságokat. Az alábbiakban egy olyan tömböt mutatunk be, amely két SIM (SIM1 és SIM2) tulajdonságát tartalmazza.

Ha most nem szeretne SIM-szabályzatot vagy statikus IP-címet hozzárendelni, törölheti a és/vagy staticIpConfiguration a simPolicy paramétereket.

Feljegyzés

Az API-kérelem törzsének maximális mérete 4 MB. Javasoljuk, hogy JSON-tömbönként legfeljebb 1000 SIM-et adjon meg, hogy a korlát alatt maradjon. Ha több mint 1000 SIM-et szeretne kiépíteni, hozzon létre több tömböt, és ismételje meg a kiépítési folyamatot mindegyiknél. Másik lehetőségként az Azure Portal használatával JSON-fájlonként legfeljebb 10 000 SIM-et építhet ki.

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

A sablon áttekintése

Az ebben a gyorsútmutatóban használt sablon az Azure-gyorssablonok közül származik.

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

A sablon a következő Azure-erőforrásokat definiálja.

A sablon üzembe helyezése

  1. Az alábbi hivatkozásra kattintva jelentkezzen be az Azure-ba, és nyisson meg egy sablont.

    Gomb a Resource Manager-sablon Azure-ban való üzembe helyezéséhez.

  2. Válassza ki vagy adja meg a következő értékeket az előfeltételekben lekért adatok használatával.

    • Előfizetés: válassza ki a privát mobilhálózat létrehozásához használt Azure-előfizetést.
    • Erőforráscsoport: válassza ki azt az erőforráscsoportot, amely a magánhálózatot képviselő mobilhálózati erőforrást tartalmazza.
    • Régió: válassza ki azt a régiót, amelyben a magánhálózatot üzembe helyezte.
    • Hely: adja meg annak a régiónak a kódnevét , amelyben a magánhálózatot üzembe helyezte.
    • Meglévő mobilhálózat neve: adja meg a magánhálózatot képviselő mobilhálózati erőforrás nevét.
    • Meglévő sim-házirend neve: adja meg az SIM-ekhez hozzárendelni kívánt SIM-szabályzat nevét.
    • Sim-csoport neve: adja meg az új SIM-csoport nevét.
    • Sim-erőforrások: illessze be az egyik JSON-tömböt, amelyet az SIM-ek előkészítése egy vagy több JSON-tömb előkészítésében készített.

    Képernyőkép az Azure Portalról, amelyen az SIMs ARM-sablon konfigurációs mezői láthatók.

  3. Válassza az Áttekintés + létrehozás lehetőséget.

  4. Az Azure most ellenőrzi a megadott konfigurációs értékeket. Ekkor megjelenik egy üzenet, amely jelzi, hogy az értékek érvényesítésen mentek át.

    Ha az érvényesítés sikertelen, hibaüzenet jelenik meg, és az érvénytelen konfigurációt tartalmazó Konfiguráció lap(ok) meg lesz jelölve. Jelölje ki a megjelölt lap(ok)ot, és a hibaüzenetek segítségével javítsa ki az érvénytelen konfigurációt, mielőtt visszatér a Véleményezés + létrehozás lapra.

  5. A konfiguráció ellenőrzése után a Létrehozás lehetőséget választva kiépítheti az SIM-eket. Az Azure Portal megerősítő képernyőt jelenít meg az SIM-ek kiépítésekor.

  6. Ha több mint 1000 SIM-et épít ki, ismételje meg ezt a folyamatot minden egyes JSON-tömbhöz.

Üzembe helyezett erőforrások áttekintése

  1. Válassza az Ugrás az erőforráscsoportra lehetőséget.

    Képernyőkép az Azure Portalról, amelyen az ARM-sablon üzembe helyezésének megerősítése látható.

  2. Ellenőrizze, hogy a SIM-csoport erőforrása létrejött-e az erőforráscsoportban.

    Képernyőkép az Azure Portalról egy újonnan létrehozott SIM-csoportot tartalmazó erőforráscsoportról.

  3. Válassza ki a SIM-csoport erőforrását, és győződjön meg arról, hogy az összes SIM megfelelően lett kiépítve.

    Képernyőkép az Azure Portalról, amelyen egy SIM-eket tartalmazó SIM-csoporterőforrás látható.

Következő lépések