Provisionar novos SIMs para Azure Private 5G Core – Modelo do ARM

Os recursos do SIM representam SIMs físicos ou eSIMs usados por UEs (equipamentos de usuário) atendidos pela rede móvel privada. Neste guia de instruções, você aprenderá a provisionar novos SIMs para uma rede móvel privada existente usando um modelo do ARM.

Um Modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo usa a sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Se seu ambiente atender aos pré-requisitos e você estiver familiarizado com o uso de modelos ARM, selecione o botão Implantar no Azure. O modelo será aberto no portal do Azure.

Pré-requisitos

• Verifique se você pode entrar no portal do Azure usando uma conta com acesso à assinatura ativa identificada em Concluir as tarefas de pré-requisito para implantar uma rede móvel privada. Essa conta precisa ter a função interna Colaborador no escopo da assinatura.
• Identifique o nome do recurso de Rede Móvel correspondente à rede móvel privada e ao grupo de recursos que ele pertence.
• Identifique a região do Azure na qual você implantou sua rede móvel privada.
• Escolha um nome para o novo grupo SIM ao qual os SIMs serão adicionados.
• Identifique a política SIM que você deseja atribuir aos SIMs que está provisionando. Você já deve ter criado as políticas SIM usando as instruções em Configurar uma política SIM – portal do Azure.

Coletar as informações necessárias para os SIMs

Para começar, colete os valores na tabela a seguir para cada SIM que você deseja provisionar.

Coletar as informações necessárias para atribuir endereços IP estáticos

Você só precisará concluir esta etapa se todas as seguintes se aplicarem:

• Você está usando uma ou mais matrizes JSON para provisionar seus SIMs.
• Você configurou a alocação de endereço IP estático para suas instâncias principais de pacotes.
• Você deseja atribuir endereços IP estáticos aos SIMs durante o provisionamento do SIM.

Colete os valores na tabela a seguir para cada SIM que você deseja provisionar. Se sua rede móvel particular tiver várias redes de dados e você deseja atribuir um endereço IP estático diferente para cada rede de dados a este SIM, colete os valores para cada endereço IP.

Cada endereço IP deve ser derivado do pool atribuído para alocação de endereço IP estático ao criar a rede de dados relevante, conforme descrito em Coletar valores de rede de dados. Para obter mais informações, consulte Alocar pools de endereços IP do UE (Equipamento de Usuário).

Preparar uma ou mais matrizes JSON para seus SIMs

Use as informações coletadas em Coletar as informações necessárias para seus SIMs para criar uma ou mais matrizes JSON que contenha propriedades para até 1.000 SIMs que você quer provisionar. Veja a seguir um exemplo de uma matriz que contém as propriedades de dois SIMs (SIM1 e SIM2).

Se você não quiser atribuir uma política SIM ou um endereço de IP estático agora, poderá excluir simPolicy e/ou os parâmetros staticIpConfiguration.

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

Examinar o modelo

O modelo usado neste início rápido é proveniente dos Modelos de Início Rápido do 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'))]"
    }
  ]
}

Os seguintes recursos do Azure estão definidos no modelo.

• Microsoft.MobileNetwork/simGroups: um recurso que representa um grupo SIM.
• Microsoft.MobileNetwork/simGroups/sims: um recurso que representa um SIM físico ou eSIM.

Implantar o modelo

1. Selecione o link a seguir para entrar no Azure e abrir um modelo.

   

2. Selecione ou insira os valores a seguir usando as informações recuperadas nos Pré-requisitos.

   • Assinatura: selecione a assinatura do Azure usada para criar a rede móvel privada.
   • Grupo de recursos: selecione o grupo de recursos que contém o recurso de Rede Móvel que representa a rede móvel privada.
   • Região: selecione a região na qual você implantou a rede móvel particular.
   • Localização: digite o codinome da região na qual você implantou a rede móvel privada.
   • Nome da Rede Móvel existente: insira o nome do recurso de Rede Móvel que representa a rede móvel privada.
   • Nome da Política SIM existente: insira o nome da política SIM que você deseja atribuir aos SIMs.
   • Nome do Grupo Sim: insira o nome do novo grupo SIM.
   • Recursos Sim: colar em uma das matrizes JSON que você preparou em Preparar uma ou mais matrizes JSON para seus SIMs.

   

3. Selecione Examinar + criar.

4. O Azure validará os valores de configuração inseridos. Você deverá ver uma mensagem indicando que seus valores foram aprovados na validação.

   Se a validação falhar, você verá uma mensagem de erro e as guias de Configuração contendo a configuração inválida serão sinalizadas. Selecione as guias sinalizadas e use as mensagens de erro para corrigir a configuração inválida antes de voltar à guia Examinar + criar.

5. Após a configuração ser validada, você poderá selecionar a opção Criar para provisionar os SIMs. O portal do Azure exibirá uma tela de confirmação quando os SIMs forem provisionados.

6. Se você estiver provisionando mais de 1.000 SIMs, repita esse processo em cada uma das suas matrizes JSON.

Examinar os recursos implantados

1. Selecione Ir para grupo de recursos.

   

2. Confirme se o recurso grupo SIM foi criado no grupo de recursos.

   

3. Selecione o recurso grupo SIM e confirme se todos os SIMs foram provisionados corretamente.

   

Próximas etapas

• Gerenciar esses SIMs usando o portal do Azure.
• Habilitar a ocultação de SUPI, se necessário.