Hızlı Başlangıç: Azure CLI kullanarak gizli kayıt defteri oluşturma

Azure Confidential Ledger, hassas veri günlükleri ve bozulmadan saklanması gereken kayıtlar için yüksek bütünlüklü depo sağlayan bir bulut hizmetidir. Bu hızlı başlangıçta, gizli bir kayıt defteri oluşturmak, özelliklerini görüntülemek ve güncelleştirmek ve silmek için Azure CLI'yi kullanacaksınız.

Azure gizli defteri hakkında daha fazla bilgi ve gizli kayıt defterinde depolanabilecekler hakkında örnekler için bkz . Microsoft Azure gizli kayıt defteri hakkında.

Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.

Önkoşullar

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz. Azure Cloud Shell'i kullanmaya başlama.

  

• CLI referans komutlarını yerel olarak çalıştırmayı tercih ediyorsanız, Azure CLI'yi yükleyin. Windows veya macOS üzerinde çalışıyorsanız, Azure CLI'yi bir Docker konteynerinde çalıştırmayı düşünün. Daha fazla bilgi için Azure CLI'nin bir Docker konteynerında nasıl çalıştırılacağını inceleyin.

  • Yerel bir kurulum kullanıyorsanız, az login komutunu kullanarak Azure CLI'ye giriş yapın. Kimlik doğrulama işlemini tamamlamak için, terminalinizde görüntülenen adımları takip edin. Diğer oturum açma seçenekleri için bkz. Azure CLI kullanarak Azure'da kimlik doğrulaması.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma ve yönetme.

  • Yüklü olan sürümü ve bağımlı kütüphaneleri bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

• Abonelik sahibi - Gizli bir kayıt defteri yalnızca Azure aboneliğinde Sahip izinleri olan kullanıcılar tarafından oluşturulabilir. Bu hızlı başlangıca devam etmeden önce uygun erişime sahip olduğunuzu onaylayın.

Bir kaynak grubu oluşturun

Kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. az group create komutunu kullanarak eastus konumunda myResourceGroup adlı bir kaynak grubu oluşturun.

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

Ana Kimlik ID'nizi alın

Gizli bir kayıt defteri oluşturmak için Microsoft Entra asıl kimliğiniz (nesne kimliğiniz de denir) gerekir. Asıl kimliğinizi almak için Azure CLI az ad signed-in-user komutunu kullanın ve sonuçları şu şekilde filtreleyin objectId:

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

Sonucunuz biçimindedir xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Gizli kayıt defteri oluşturma

Yeni kaynak grubunuzda gizli bir kayıt defteri oluşturmak için Azure CLI az confidentialledger create komutunu kullanın.

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

Başarılı bir işlem, yeni oluşturulan kayıt defterinin özelliklerini döndürür. LedgerUri değerini not alın. Örneğimizde, bu URI "https://myledger.confidential-ledger.azure.com"";.

Veri düzleminden gizli kayıt defteriyle işlem yapmak için bu URI'ye ihtiyacınız vardır.

Gizli kayıt defteri özelliklerinizi görüntüleme ve güncelleştirme

Azure CLI az confidentialledger show komutunu kullanarak yeni oluşturduğunuz gizli kayıt defterinizle ilişkili özellikleri görüntüleyebilirsiniz.

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

Döndürülen JSON nesnesi, rolünüz dahil olmak üzere kayıt defterinin özelliklerini görüntüler:

"ledgerRoleName": "Administrator",

Gizli bir kayıt defterinin özelliklerini güncelleştirmek için Azure CLI az confidentialledger update komutunu kullanın. Örneğin, denetim düzlemi aracılığıyla size atanan kayıt defteri rolünü Yöneticiden Okuyucuya değiştirmek için, kayıt defterini oluştururken kullandığınız aynı asıl kimlikle aşağıdaki komutu çalıştırın. Kendi rolünüzü değiştirmeden önce defterde başka bir Yöneticinin kaldığından emin olun.

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 komutunu yeniden çalıştırırsanız, ledger kaynağında güncelleştirilmiş rolü görürsünüz:

"ledgerRoleName": "Reader",

Diğer rutin kullanıcı yönetimi güncelleştirmeleri için veri düzlemi API'sini kullanın. Denetim düzlemi ve veri düzlemi aracılığıyla atanan kayıt defteri rollerinin nasıl farklılık gösterdiğini öğrenmek için bkz. Kayıt defteri kullanıcılarını yönetmeyi seçme.

Kaynakları temizle

Bu koleksiyondaki diğer hızlı başlangıçlar ve öğreticiler bu hızlı başlangıcı temel alır. Sonraki hızlı başlangıçlar ve öğreticilerle çalışmaya devam etmeyi planlıyorsanız, bu kaynakları yerinde bırakmayı tercih edebilirsiniz.

Artık gerekli olmadığında, kaynak grubunu ve tüm ilgili kaynakları kaldırmak için Azure CLI az group delete komutunu kullanabilirsiniz:

az group delete --name "myResourceGroup"

Sonraki Adımlar

Bu hızlı başlangıçta, Azure CLI kullanarak gizli bir kayıt defteri oluşturdunuz. Azure gizli kayıt defteri ve bunu uygulamalarınızla tümleştirme hakkında daha fazla bilgi edinmek için bu makalelere geçin.

• Microsoft Azure gizli defterine genel bakış