Compartir a través de

Inicio rápido: Creación de un libro de contabilidad confidencial mediante Azure PowerShell

Azure Confidential Ledger es un servicio en la nube que proporciona un almacén de alta integridad para registros de datos confidenciales y registros que deben mantenerse intactos. En este inicio rápido, usará Azure PowerShell para crear un libro de contabilidad confidencial, ver y actualizar sus propiedades y eliminarlo. Para más información sobre el libro de contabilidad confidencial de Azure y ejemplos de lo que se puede almacenar en un libro de contabilidad confidencial, consulte Acerca del libro de contabilidad confidencial de Microsoft Azure.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Azure Cloud Shell

Azure hospeda Azure Cloud Shell, un entorno de shell interactivo que puede usar a través del explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo, sin tener que instalar nada en el entorno local.

Para iniciar Azure Cloud Shell:

Opción Ejemplo o vínculo
Seleccione Pruébelo en la esquina superior derecha de un código o bloque de comandos. Al seleccionar Inténtalo, no se copia automáticamente el código o el comando en Cloud Shell. Captura de pantalla que muestra un ejemplo de la opción Pruébelo para Azure Cloud Shell.
Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. Botón para iniciar Azure Cloud Shell.
Seleccione el botón Cloud Shell en la barra de menús en la parte superior derecha del Azure portal. Captura de pantalla que muestra el botón de Cloud Shell en Azure Portal

Para usar Azure Cloud Shell:

  1. Inicie Cloud Shell.

  2. Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.

  3. Pegue el código o comando en la sesión de Cloud Shell seleccionando Ctrl+Mayús+V en Windows y Linux o seleccionando Cmd+Mayús+V en macOS.

  4. Seleccione Enter para ejecutar el código o comando.

En este inicio rápido, creará un libro de contabilidad confidencial con Azure PowerShell. Si decide instalar y usar PowerShell localmente, este tutorial requiere la versión 1.0.0 o posterior del módulo de Azure PowerShell. Escriba $PSVersionTable.PSVersion para buscar la versión. Si necesita actualizar, consulte Instalación del módulo de Azure PowerShell. Si PowerShell se ejecuta localmente, también debe ejecutar Login-AzAccount para crear una conexión con Azure.

Prerrequisitos

  • Propietario de la suscripción: los usuarios que tienen permisos de propietario en la suscripción de Azure solo pueden crear un libro de contabilidad confidencial. Confirme que tiene el acceso adecuado antes de continuar con este inicio rápido.

Creación de un grupo de recursos

Un grupo de recursos es un contenedor lógico en el que se implementan y se administran los recursos de Azure. Use el cmdlet New-AzResourceGroup de Azure PowerShell para crear un grupo de recursos denominado myResourceGroup en la ubicación eastus .

New-AzResourceGroup -Name "myResourceGroup" -Location "EastUS"

Obtenga su ID principal y la ID del arrendatario

Para crear un libro mayor confidencial, use su ID principal de Microsoft Entra (también denominado identificador de objeto). Para obtener su ID principal, use el cmdlet Get-AzADUser de Azure PowerShell, con el indicador -SignedIn.

Get-AzADUser -SignedIn

El resultado está listado bajo "Id", de esta manera: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Creación de un libro de contabilidad confidencial

Use el comando New-AzConfidentialLedger de Azure PowerShell para crear un libro de contabilidad confidencial en el nuevo grupo de recursos.

New-AzConfidentialLedger -Name "myLedger" -ResourceGroupName "myResourceGroup" -Location "EastUS" -LedgerType "Public" -AadBasedSecurityPrincipal @{ LedgerRoleName="Administrator"; PrincipalId="aaaaaaaa-bbbb-cccc-1111-222222222222"; }

Si la operación es correcta, devuelve las propiedades del ledger (libro de contabilidad) recién creado. Anote el valor ledgerUri. En el ejemplo anterior, este URI es "https://myledger.confidential-ledger.azure.com".

Necesita el identificador de URI para realizar transacciones con el confidential ledger desde el plano de datos.

Visualización y actualización de las propiedades del libro de contabilidad confidencial

Puede ver las propiedades asociadas al libro de contabilidad confidencial recién creado mediante el cmdlet Get-AzConfidentialLedger de Azure PowerShell.

Get-AzConfidentialLedger -Name "myLedger" -ResourceGroupName "myResourceGroup"

Para actualizar las propiedades de un libro de contabilidad confidencial, use el cmdlet Update-AzConfidentialLedger de Azure PowerShell. Por ejemplo, si quiere actualizar el libro de contabilidad para cambiar el rol a "Lector", ejecute:

Update-AzConfidentialLedger -Name "myLedger" -ResourceGroupName "myResourceGroup" -Location "EastUS" -LedgerType "Public" -AadBasedSecurityPrincipal @{ LedgerRoleName="Reader"; PrincipalId="aaaaaaaa-bbbb-cccc-1111-222222222222"; }

Si vuelve a ejecutar Get-AzConfidentialLedger, verá que el rol se actualiza.

"ledgerRoleName": "Reader",

Limpieza de recursos

Otras guías de inicio rápido y tutoriales de esta colección se basan en este inicio rápido. Si tiene previsto seguir trabajando con otros inicios rápidos y tutoriales, es posible que desee dejar estos recursos en su lugar.

Cuando ya no sea necesario, puede usar el cmdlet Remove-AzResourceGroup de Azure PowerShell para quitar el grupo de recursos y todos los recursos relacionados.

Remove-AzResourceGroup -Name "myResourceGroup"

Pasos siguientes

En este inicio rápido, ha creado un libro de contabilidad confidencial mediante Azure PowerShell. Para más información sobre Azure Confidential Ledger y cómo integrarlo con las aplicaciones, continúe con los artículos siguientes.

  • Last updated on