Mulai cepat: Membuat ledger rahasia menggunakan Azure CLI

Azure confidential ledger adalah layanan cloud yang menyediakan repositori berintegritas tinggi untuk log data sensitif dan rekaman yang harus tetap utuh. Dalam panduan cepat ini, Anda menggunakan Azure CLI untuk membuat buku besar rahasia, melihat dan memperbarui propertinya, dan menghapusnya.

Untuk informasi selengkapnya tentang Azure Confidential Ledger dan contoh apa yang dapat disimpan dalam confidential ledger, lihat Tentang Microsoft Azure Confidential Ledger.

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

Prasyarat

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah az login. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI saat pertama kali digunakan. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

• Pemilik langganan - Ledger rahasia hanya dapat dibuat oleh pengguna yang memiliki izin Pemilik pada langganan Azure. Pastikan bahwa Anda memiliki akses yang sesuai sebelum melanjutkan dengan panduan mulai cepat ini.

Membuat grup sumber daya

Grup sumber daya adalah wadah logis di mana sumber daya Azure ditempatkan dan dikelola. Gunakan perintah az group create untuk membuat grup sumber daya bernama myResourceGroup di lokasi eastus.

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

Dapatkan ID utama Anda

Untuk membuat confidential ledger, Anda memerlukan ID utama Microsoft Entra (juga disebut ID objek Anda). Untuk mendapatkan ID utama Anda, gunakan perintah Azure CLI az ad signed-in-user , dan filter hasilnya dengan objectId:

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

Hasil Anda dalam format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Membuat ledger rahasia

Gunakan perintah azure CLI az confidentialledger create untuk membuat confidential ledger di grup sumber daya baru Anda.

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

Operasi yang berhasil akan mengembalikan properti dari ledger yang baru dibuat. Catat ledgerUri. Dalam contoh kami, URI ini adalah "https://myledger.confidential-ledger.azure.com".

Anda memerlukan URI ini untuk bertransaksi dengan ledger rahasia dari bidang data.

Menampilkan dan memperbarui properti confidential ledger Anda

Anda dapat melihat properti yang terkait dengan confidential ledger yang baru dibuat menggunakan perintah azure CLI az confidentialledger show .

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

Objek JSON yang dikembalikan menampilkan properti ledger, termasuk peran Anda:

"ledgerRoleName": "Administrator",

Gunakan perintah az confidentialledger update Azure CLI untuk memperbarui properti confidential ledger. Misalnya, untuk mengubah peran ledger yang ditetapkan kepada Anda melalui control plane dari Administrator ke Pembaca, jalankan perintah berikut dengan ID principal yang sama dengan yang Anda gunakan saat membuat ledger. Pastikan Administrator lain tetap berada di ledger sebelum mengubah peran Anda sendiri.

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

Jika Anda menjalankan az confidentialledger show lagi, Anda akan melihat peran yang diperbarui dalam sumber daya ledger:

"ledgerRoleName": "Reader",

Untuk pembaruan manajemen pengguna rutin lainnya, gunakan API data-plane. Untuk mempelajari bagaimana peran ledger yang ditetapkan melalui sarana kontrol dan bidang data berbeda, lihat Memilih cara mengelola pengguna ledger.

Membersihkan sumber daya

Panduan cepat dan tutorial lain dalam koleksi ini disusun berdasarkan panduan cepat ini. Jika Anda berencana untuk terus menggunakan panduan memulai cepat dan tutorial selanjutnya, Anda mungkin ingin membiarkan sumber daya ini tetap ada.

Jika tidak lagi dibutuhkan, gunakan perintah az group delete Azure CLI untuk menghapus grup sumber daya, dan semua sumber daya terkait:

az group delete --name "myResourceGroup"

Langkah selanjutnya

Dalam panduan langkah cepat ini, Anda membuat buku besar rahasia dengan Azure CLI. Untuk mempelajari selengkapnya tentang Azure Confidential Ledger dan cara mengintegrasikannya dengan aplikasi Anda, lanjutkan ke artikel ini.

• Gambaran umum Microsoft Azure Confidential Ledger