Dela via

Etablera nya SIM:er för Azure Private 5G Core – ARM-mall

  • Artikel

SIM-resurser representerar fysiska SIM:er eller eSIM:er som används av användarutrustning (UEs) som hanteras av det privata mobilnätverket. I den här instruktionsguiden får du lära dig hur du etablerar nya SIM:er för ett befintligt privat mobilt nätverk med hjälp av en Azure Resource Manager-mall (ARM-mall).

En Azure Resource Manager-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för projektet. Mallen använder deklarativ syntax. Du beskriver den avsedda distributionen utan att skriva sekvensen med programmeringskommandon för att skapa distributionen.

Om din miljö uppfyller förhandskraven och du är van att använda ARM-mallar väljer du knappen Distribuera till Azure. Mallen öppnas på Azure-portalen.

Knapp för att distribuera Resource Manager-mallen till Azure.

Förutsättningar

  • Kontrollera att du kan logga in på Azure Portal med ett konto med åtkomst till den aktiva prenumeration som du identifierade i Slutför nödvändiga uppgifter för att distribuera ett privat mobilt nätverk. Det här kontot måste ha den inbyggda deltagarrollen i prenumerationsomfånget.
  • Identifiera namnet på den mobilnätverksresurs som motsvarar ditt privata mobilnätverk och resursgruppen som innehåller den.
  • Identifiera den Azure-region där du distribuerade ditt privata mobilnätverk.
  • Välj ett namn för den nya SIM-grupp som dina SIM:er ska läggas till i.
  • Identifiera den SIM-princip som du vill tilldela till de SIM:er som du etablerar. Du måste redan ha skapat den här SIM-principen med hjälp av anvisningarna i Konfigurera en SIM-princip – Azure Portal.

Samla in nödvändig information för dina SIM:er

Börja med att samla in värdena i följande tabell för varje SIM som du vill etablera.

Värde Parameternamn
SIM-namn. SIM-namnet får bara innehålla alfanumeriska tecken, bindestreck och understreck. simName
ICCID (Integrated Circuit Card Identification Number). ICCID identifierar ett specifikt fysiskt SIM eller eSIM och innehåller information om SIM:ns land/region och utfärdare. ICCID är valfritt och är ett unikt numeriskt värde mellan 19 och 20 siffror i längd, från och med 89. integratedCircuitCardIdentifier
ImSI (International Mobile Subscriber Identity). IMSI är ett unikt nummer (vanligtvis 15 siffror) som identifierar en enhet eller användare i ett mobilt nätverk. internationalMobileSubscriberIdentity
Autentiseringsnyckeln (Ki). Ki är ett unikt 128-bitarsvärde som tilldelats sim-kortet av en operatör och används med den härledda operatorkoden (OPc) för att autentisera en användare. Det måste vara en sträng på 32 tecken som endast innehåller hexadecimala tecken. authenticationKey
Den härledda operatorkoden (OPc). OPc hämtas från SIM:ns Ki och nätverkets operatörskod (OP). Paketkärninstansen använder den för att autentisera en användare med hjälp av en standardbaserad algoritm. OPc måste vara en sträng på 32 tecken som endast innehåller hexadecimala tecken. operatorKeyCode
Typ av enhet som använder det här SIM-kortet. Det här värdet är en valfri friformssträng. Du kan använda den efter behov för att enkelt identifiera enhetstyper med hjälp av företagets privata mobilnätverk. deviceType
SIM-principen som ska tilldelas till SIM-kortet. Det här är valfritt, men dina SIM:er kan inte använda det privata mobilnätverket utan en tilldelad SIM-princip. simPolicyId

Samla in nödvändig information för att tilldela statiska IP-adresser

Du behöver bara slutföra det här steget om alla följande gäller:

  • Du använder en eller flera JSON-matriser för att etablera dina SIM:er.
  • Du har konfigurerat statisk IP-adressallokering för dina paketkärninstanser.
  • Du vill tilldela statiska IP-adresser till SIM:erna under SIM-etableringen.

Samla in värdena i följande tabell för varje SIM som du vill etablera. Om ditt privata mobilnätverk har flera datanätverk och du vill tilldela en annan statisk IP-adress för varje datanätverk till det här SIM-kortet samlar du in värdena för varje IP-adress.

Varje IP-adress måste komma från poolen som du har tilldelat för statisk IP-adressallokering när du skapar det relevanta datanätverket, enligt beskrivningen i Samla in datanätverksvärden. Mer information finns i Allokera UE-adresspooler (User Equipment).

Värde Fältnamn i Azure Portal JSON-parameternamn
Det datanätverk som SIM:n ska använda. Ej tillämpbart. staticIpConfiguration.attachedDataNetworkId
Den nätverkssektor som SIM:n ska använda. Ej tillämpbart. staticIpConfiguration.sliceId
Den statiska IP-adress som ska tilldelas till SIM-kortet. Ej tillämpbart. staticIpConfiguration.staticIpAddress

Förbereda en eller flera JSON-matriser för dina SIM:er

Använd informationen som du samlade in i Samla in nödvändig information för dina SIM:er för att skapa en eller flera JSON-matriser som innehåller egenskaper för upp till 1 000 av de SIM:er som du vill etablera. Följande är ett exempel på en matris som innehåller egenskaper för två SIM:er (SIM1 och SIM2).

Om du inte vill tilldela en SIM-princip eller statisk IP-adress nu kan du ta bort parametrarna simPolicy och/eller staticIpConfiguration .

Kommentar

Den maximala storleken på API-begärandetexten är 4 MB. Vi rekommenderar att du anger högst 1 000 SIM:er per JSON-matris för att hålla sig under den här gränsen. Om du vill etablera fler än 1 000 SIM:er skapar du flera matriser och upprepar etableringsprocessen för var och en. Du kan också använda Azure Portal för att etablera upp till 10 000 SIM per JSON-fil.

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

Granska mallen

Mallen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

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

Följande Azure-resurser definieras i mallen.

Distribuera mallen

  1. Välj följande länk för att logga in på Azure och öppna en mall.

    Knapp för att distribuera Resource Manager-mallen till Azure.

  2. Välj eller ange följande värden med hjälp av den information som du hämtade i Krav.

    • Prenumeration: välj den Azure-prenumeration som du använde för att skapa ditt privata mobilnätverk.
    • Resursgrupp: Välj den resursgrupp som innehåller mobilnätverksresursen som representerar ditt privata mobilnätverk.
    • Region: välj den region där du distribuerade det privata mobilnätverket.
    • Plats: Ange kodnamnet för den region där du distribuerade det privata mobilnätverket.
    • Befintligt mobilt nätverksnamn: ange namnet på den mobilnätverksresurs som representerar ditt privata mobilnätverk.
    • Befintligt simprincipnamn: Ange namnet på den SIM-princip som du vill tilldela till SIM:erna.
    • Sim-gruppnamn: ange namnet på den nya SIM-gruppen.
    • Sim-resurser: Klistra in en av de JSON-matriser som du förberedde i Förbered en eller flera JSON-matriser för dina SIM:er.

    Skärmbild av Azure Portal som visar konfigurationsfälten för ARM-mallen för sims.

  3. Välj Granska + skapa.

  4. Azure verifierar nu de konfigurationsvärden som du har angett. Du bör se ett meddelande som anger att dina värden har godkänts.

    Om verifieringen misslyckas visas ett felmeddelande och flikarna Konfiguration som innehåller den ogiltiga konfigurationen flaggas. Välj de flaggade flikarna och använd felmeddelandena för att korrigera ogiltig konfiguration innan du återgår till fliken Granska + skapa .

  5. När konfigurationen har verifierats kan du välja Skapa för att etablera dina SIM:er. Azure Portal visar en bekräftelseskärm när SIM:erna har etablerats.

  6. Om du etablerar fler än 1 000 SIM:er upprepar du den här processen för var och en av dina JSON-matriser.

Granska distribuerade resurser

  1. Välj Gå till resursgrupp.

    Skärmbild av Azure Portal som visar en distributionsbekräftelse för ARM-mallen.

  2. Bekräfta att SIM-gruppresursen har skapats i resursgruppen.

    Skärmbild av Azure Portal som visar en resursgrupp som innehåller en nyskapad SIM-grupp.

  3. Välj SIM-gruppresursen och bekräfta att alla dina SIM:er har etablerats korrekt.

    Skärmbild av Azure Portal som visar en SIM-gruppresurs som innehåller SIM:er.

Nästa steg