Share via

Guia de início rápido: criar um HSM de pagamento do Azure com a CLI do Azure

  • Artigo

O Azure Payment HSM é um serviço "BareMetal" fornecido usando os módulos de segurança de hardware de pagamento (HSM) Thales payShield 10K para fornecer operações de chave criptográfica para transações de pagamento críticas em tempo real na nuvem do Azure. O Azure Payment HSM foi projetado especificamente para ajudar um provedor de serviços e uma instituição financeira individual a acelerar a estratégia de transformação digital de seus sistemas de pagamento e adotar a nuvem pública. Para obter mais informações, consulte Azure Payment HSM: Visão geral.

Este guia de início rápido descreve como criar, atualizar e excluir um HSM de Pagamento do Azure usando o comando az dedicated-hsm Azure CLI.

Pré-requisitos

Importante

O Azure Payment HSM é um serviço especializado. Para se qualificarem para a integração e utilização do Azure Payment HSM, os clientes têm de ter um Gestor de Conta Microsoft atribuído, ter um CSA e cumprir o requisito monetário de cinco milhões de USD (5 milhões de dólares) ou superior em receitas globais comprometidas do Azure anualmente.

Para saber mais sobre o serviço, iniciar o processo de qualificação e preparar os pré-requisitos antes da integração, peça ao seu gerente de conta da Microsoft e ao CSA para enviar uma solicitação por email.

  • Você deve registrar os provedores de recursos "Microsoft.HardwareSecurityModules" e "Microsoft.Network", bem como os recursos do Azure Payment HSM. As etapas para fazer isso estão em Registrar o provedor de recursos do HSM de pagamento do Azure e os recursos do provedor de recursos.

    Aviso

    Você deve aplicar o sinalizador de recurso "FastPathEnabled" a cada ID de assinatura e adicionar a tag "fastpathenabled" a cada rede virtual. Para obter mais informações, consulte Fastpathenabled.

    Para verificar rapidamente se os provedores de recursos e recursos já estão registrados, use o comando Azure CLI az provider show . (A saída deste comando é mais legível se você exibi-lo em formato de tabela.)

    az provider show --namespace "Microsoft.HardwareSecurityModules" -o table

az provider show --namespace "Microsoft.Network" -o table

az feature registration show -n "FastPathEnabled"  --provider-namespace "Microsoft.Network" -o table

az feature registration show -n "AzureDedicatedHsm"  --provider-namespace "Microsoft.HardwareSecurityModules" -o table

    Você pode continuar com este início rápido se todos esses quatro comandos retornarem "Registrado".

  • Precisa de uma subscrição do Azure. Você pode criar uma conta gratuita se não tiver uma.

    Se você tiver mais de uma assinatura do Azure, defina a assinatura a ser usada para cobrança com o comando Azure CLI az account set .

    az account set --subscription <subscription-id>

  • Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  • Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

    • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

    • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Criar um grupo de recursos

Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos. Use o comando az group create para criar um grupo de recursos chamado myResourceGroup no local eastus .

az group create --name "myResourceGroup" --location "EastUS"

Criar uma rede virtual e uma sub-rede

Antes de criar um HSM de pagamento, você deve primeiro criar uma rede virtual e uma sub-rede. Para fazer isso, use o comando Azure CLI az network vnet create :

az network vnet create -g "myResourceGroup" -n "myVNet" --address-prefixes "10.0.0.0/16" --tags "fastpathenabled=True" --subnet-name "myPHSMSubnet" --subnet-prefix "10.0.0.0/24"

Depois, use o comando Azure CLI az network vnet subnet update para atualizar a sub-rede e dar-lhe uma delegação de "Microsoft.HardwareSecurityModules/dedicatedHSMs":

az network vnet subnet update -g "myResourceGroup" --vnet-name "myVNet" -n "myPHSMSubnet" --delegations "Microsoft.HardwareSecurityModules/dedicatedHSMs"

Para verificar se a rede virtual e a sub-rede foram criadas corretamente, use o comando Azure CLI az network vnet show :

az network vnet show -n "myVNet" -g "myResourceGroup"

Anote o valor retornado como id, pois ele é usado na próxima etapa. O id está no formato:

"id": "/subscriptions/<subscriptionID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/myPHSMSubnet",

Criar um HSM de pagamento

Para criar um HSM de pagamento, use o comando az dedicated-hsm create . O exemplo a seguir cria um HSM de pagamento nomeado myPaymentHSM na eastus região, grupo de recursos e assinatura especificada, myResourceGroup rede virtual e sub-rede:

az dedicated-hsm create \
   --resource-group "myResourceGroup" \
   --name "myPaymentHSM" \
   --location "EastUS" \
   --subnet id="<subnet-id>" \
   --stamp-id "stamp1" \
   --sku "payShield10K_LMK1_CPS60"

Obter um pagamento HSM

Para ver seu HSM de pagamento e suas propriedades, use o comando Azure CLI az dedicated-hsm show .

az dedicated-hsm show --resource-group "myResourceGroup" --name "myPaymentHSM"

Para listar todos os seus HSMs de pagamento, use o comando az dedicated-hsm list . (A saída deste comando é mais legível se você exibi-lo em formato de tabela.)

az dedicated-hsm list --resource-group "myResourceGroup" -o table

Remover um HSM de pagamento

Para remover seu HSM de pagamento, use o comando az dedicated-hsm delete . O exemplo a seguir exclui o myPaymentHSM HSM de pagamento do myResourceGroup grupo de recursos:

az dedicated-hsm delete --name "myPaymentHSM" -g "myResourceGroup"

Eliminar o grupo de recursos

Outros inícios rápidos e tutoriais desta coleção têm por base este início rápido. Se quiser continuar a trabalhar com os inícios rápidos e tutoriais subsequentes, pode manter estes recursos.

Quando não for mais necessário, você pode usar o comando azur CLI az group delete para remover o grupo de recursos e todos os recursos relacionados:

az group delete --name "myResourceGroup"

Próximos passos

Neste início rápido, você criou um HSM de pagamento, visualizou e atualizou suas propriedades e o excluiu. Para saber mais sobre o HSM de pagamento e como integrá-lo com seus aplicativos, continue nestes artigos.