Guia de início rápido: criar um livro-razão confidencial usando a CLI do Azure

O Azure Confidential Ledger é um serviço na cloud que fornece um armazenamento de alta integridade para registos e arquivos de dados sensíveis que devem ser mantidos intactos. Neste arranque rápido, utiliza a CLI do Azure para criar um livro-razão confidencial, exibir e atualizar as suas propriedades, e excluí-lo.

Para obter mais informações sobre o livro-razão confidencial do Azure e exemplos do que pode ser armazenado em um livro-razão confidencial, consulte Sobre o livro-razão confidencial do Microsoft Azure.

Se não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

• Utilize o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale o CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o 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 você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga os passos exibidos no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão do CLI do Azure na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.

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

• Proprietário da subscrição - Um registo confidencial só pode ser criado por utilizadores com permissões de Proprietário na subscrição do Azure. Confirme se você tem o acesso apropriado antes de continuar com este início rápido.

Criar um grupo de recursos

Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados. Use o comando az group create para criar um grupo de recursos chamado myResourceGroup na localização eastus.

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

Obtenha o seu ID principal

Para criar um livro-razão confidencial, você precisa da sua ID principal do Microsoft Entra (também chamada de ID do objeto). Para obter sua ID principal, use o comando CLI do Azure az ad signed-in-user e filtre os resultados por objectId:

az ad signed-in-user show --query objectId

O seu resultado está no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Criar um livro razão confidencial

Use o comando CLI do Azure az confidentialledger create para criar um livro-razão confidencial no seu novo grupo de recursos.

az confidentialledger create --name "<ledger-name>" --resource-group "<resource-group>" --location "EastUS" --ledger-type "Public" --aad-based-security-principals ledger-role-name="Administrator" principal-id="<principal-id>"

Uma operação bem-sucedida retorna as propriedades do registo recém-criado. Tome nota do ledgerUri. No nosso exemplo, este URI é "https://myledger.confidential-ledger.azure.com".

Você precisa desse URI para fazer transações com o livro-razão confidencial do plano de dados.

Ver e atualizar as suas propriedades de contabilidade confidenciais

Você pode exibir as propriedades associadas ao seu livro-razão confidencial recém-criado usando o comando CLI do Azure az confidentialledger show .

az confidentialledger show --name "<ledger-name>" --resource-group "<resource-group>"

O objeto JSON retornado exibe as propriedades do livro-razão, incluindo sua função:

"ledgerRoleName": "Administrator",

Utilize o comando CLI do Azure az confidentialledger update para atualizar as propriedades de um livro de registo confidencial. Por exemplo, para alterar o papel do livro razão que lhe foi atribuído através do plano de controlo de Administrador para Leitor, execute o seguinte comando com o mesmo ID do principal que usou ao criar o livro razão. Assegure-se de que outro Administrador permanece no livro-razão antes de mudar o seu próprio papel.

az confidentialledger update --name "<ledger-name>" --resource-group "<resource-group>" --ledger-type "Public" --aad-based-security-principals "[{principal-id:<principal-id>,ledger-role-name:Reader}]"

Se voltares a executar az confidentialledger show novamente, vês o papel atualizado no recurso ledger:

"ledgerRoleName": "Reader",

Para outras atualizações rotineiras de gestão de utilizadores, utilize a API do plano de dados. Para saber como os papéis do livro razão atribuídos através do plano de controlo e do plano de dados diferem, veja Escolher como gerir utilizadores do livro razão.

Limpeza de recursos

Outros inícios rápidos e tutoriais desta coleção baseiam-se neste início rápido. Se pretende continuar a trabalhar com os quickstarts e tutoriais subsequentes, poderá querer deixar estes recursos no lugar.

Quando já não for necessário, pode utilizar o comando az group delete do CLI do Azure para remover o grupo de recursos e todos os recursos relacionados.

az group delete --name "myResourceGroup"

Próximos passos

Nesta introdução rápida, você criou um livro-razão confidencial usando a CLI do Azure. Para saber mais sobre o ledger confidencial do Azure e como integrá-lo nas suas aplicações, consulte os seguintes artigos.

• Visão geral da contabilidade confidencial do Microsoft Azure