快速入門:使用 Azure CLI 建立機密總帳

Azure 機密帳本是一項雲端服務,提供敏感資料日誌與紀錄的高完整性儲存體,且這些日誌和紀錄必須保持完整。 在本快速入門中,您會使用 Azure CLI 來建立機密總帳、檢視及更新其屬性,以及將其刪除。

如需 Azure 機密總帳的詳細資訊,以及機密總帳中可以儲存的內容的範例,請參閱關於 Microsoft Azure 機密總帳。

如果您沒有 Azure 帳戶,請在開始之前建立 免費帳戶 。

先決條件

  • 訂用帳戶擁有者 - 只有具備 Azure 訂用帳戶「擁有者」權限的使用者,才能建立機密總帳。 先確認您有適當的存取權,再繼續進行本快速入門。

建立資源群組

資源群組是在其中部署與管理 Azure 資源的邏輯容器。 使用 az group create 命令,在 eastus 位置建立名為 myResourceGroup 的資源群組。

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

取得您的主體識別碼

若要建立機密總帳,您需要Microsoft Entra 主體標識碼(也稱為對象標識碼)。 若要取得您的主體標識符,請使用 Azure CLI az ad signed-in-user 命令,然後依 objectId篩選結果:

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

您的結果為格式xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

建立機密總帳

使用 Azure CLI az confidentialledger create 命令,在新的資源群組中建立機密總帳。

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>"

成功的作業會傳回新建立的總帳的屬性。 記下 ledgerUri。 在我們的範例中,此 URI 為 “https://myledger.confidential-ledger.azure.com"。

您需要此 URI 才能與資料平面中的機密總帳進行交易。

檢視和更新您的機密總帳屬性

您可以使用 Azure CLI az confidentialledger show 命令來檢視與您新建立的機密總賬相關聯的屬性。

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

傳回的 JSON 物件會顯示總賬的屬性,包括您的角色:

"ledgerRoleName": "Administrator",

使用 Azure CLI az confidentialledger update 命令來更新機密帳本的屬性。 例如,若要透過控制平面將指派給您的帳本角色從管理員變更為讀取者,請使用與建立帳本時相同的主體 ID 執行以下命令。 在更改自己的角色之前,請確保另一位管理員仍留在帳本上。

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

如果你再次執行 az confidentialledger show ,你會在帳本資源中看到更新的角色:

"ledgerRoleName": "Reader",

對於其他例行的使用者管理更新,請使用資料平面 API。 欲了解透過控制平面與資料平面指派的帳本角色有何不同,請參閱「 選擇如何管理帳本使用者」。

清理資源

此集合中的其他快速入門和教學課程會以本快速入門為基礎。 如果您打算繼續進行後續的快速入門和教學課程,您可以讓這些資源留在原處。

若不再需要,您可以使用 Azure CLI az group delete 命令來移除資源群組和所有相關資源:

az group delete --name "myResourceGroup"

後續步驟

在本快速入門中,您已使用 Azure CLI 建立機密總帳。 若要深入了解 Azure 機密總帳及如何與應用程式整合,請繼續閱讀下列文章。