Kullanıcı kimliğiyle AzCopy erişimini yetkilendirme

Kullanıcı kimliği kimlik doğrulaması, kişisel Microsoft Entra Id kimlik bilgilerinizi kullanarak AzCopy işlemlerini yetkilendirmek için kolay bir yol sağlar. Bu kimlik doğrulama yöntemi, AzCopy komutlarını el ile çalıştırdığınız veya geliştirme ortamlarında çalıştığınız etkileşimli senaryolar için idealdir.

Bu makalede, kullanıcı kimliğinizi ortam değişkenleriyle, etkileşimli AzCopy oturum açma komutuyla veya mevcut Azure CLI veya Azure PowerShell oturumlarından yararlanarak AzCopy'nin kimliğini doğrulama adımları gösterilmektedir.

AzCopy'ye erişimi yetkilendirmenin diğer yolları için bkz. AzCopy'yi yetkilendirme.

Rol atamalarını doğrulama

Kullanıcı kimliğinizin hedeflenen işlemleriniz için gerekli Azure rolüne sahip olduğundan emin olun:

• İndirme işlemleri için Depolama Blob Veri Okuyucusu (Blob Depolama) veya Depolama Dosyası Verileri Ayrıcalıklı Okuyucusu 'nu (Azure Dosyaları) kullanın.

• Karşıya yükleme işlemleri için Depolama Blob Verisi Katkıda Bulunanı veya Depolama Blob Verisi Sahibi (Blob Depolama) ya da Depolama Dosyası Verisi Ayrıcalıklı Katkıda Bulunanı (Azure Dosyaları) kullanın.

Rol atama yönergeleri için bkz. Blob verilerine erişim için Azure rolü atama (Blob Depolama) veya Azure portalında (Azure Dosyaları) dosya verilerine erişimi yetkilendirmeyi seçme .

Uyarı

Rol atamalarının yayılması beş dakika kadar sürebilir.

Hiyerarşik ad alanına sahip bir hesaptaki blobları aktarıyorsanız, güvenlik sorumlunuzu hedef kapsayıcının veya dizinin erişim denetimi listesine (ACL) eklerseniz bu rolleri güvenlik sorumlunuza atamanız gerekmez. ACL'de güvenlik sorumlunuzun hedef dizinde yazma iznine ve kapsayıcı ile her üst dizinde yürütme iznine sahip olması gerekir. Daha fazla bilgi edinmek için bkz . Azure Data Lake Storage'da erişim denetimi modeli.

Ortam değişkenlerini kullanarak yetkilendirme

Erişimi yetkilendirmek için bellek içi ortam değişkenlerini ayarlayın ve ardından herhangi bir AzCopy komutunu çalıştırın. AzCopy, işlemi tamamlamak için gereken kimlik doğrulama belirtecini alır. İşlem tamamlandıktan sonra belirteç bellekten kaldırılır. AzCopy, sağladığınız kimlik bilgilerini kullanarak OAuth belirtecini alır.

Kullanıcı kimliğinizin gerekli yetkilendirmeye sahip olduğunu doğruladıktan sonra aşağıdaki komutu girin ve ENTER tuşuna basın.

Linux

export AZCOPY_AUTO_LOGIN_TYPE=DEVICE

Windows

$Env:AZCOPY_AUTO_LOGIN_TYPE="DEVICE"

Ardından, herhangi bir AzCopy komutunu çalıştırın (örneğin: azcopy list https://contoso.blob.core.windows.net).

Bu komut bir kimlik doğrulama kodu ve bir web sitesinin URL'sini döndürür. Web sitesini açın, kodu sağlayın ve ardından İleri düğmesini seçin.

Bir oturum açma penceresi görüntülenir. Bu pencerede, Azure hesabı kimlik bilgilerinizi kullanarak Azure hesabınızda oturum açın. Başarıyla oturum açtığınızda işlem tamamlar.

AzCopy oturum açma komutuyla yetkilendirme

Bellek içi değişkenleri kullanmak yerine, erişimi azcopy login komutunu kullanarak yetkilendirin.

Komutu azcopy login bir OAuth belirteci alır ve bu belirteci sisteminizdeki bir gizli depo içine yerleştirir. İşletim sisteminizde Linux anahtarlığı gibi bir gizli saklama alanı yoksa, belirteci yerleştirecek hiçbir yer olmadığından azcopy login komutu çalışmaz.

Kullanıcı kimliğinizin gerekli yetkilendirme düzeyine sahip olduğunu doğruladıktan sonra bir komut istemi açın, aşağıdaki komutu yazın ve ENTER tuşuna basın.

azcopy login

Hata alırsanız, depolama hesabının ait olduğu kuruluşun kiracı kimliğini eklemeyi deneyin.

azcopy login --tenant-id=<tenant-id>

Yer tutucuyu <tenant-id> , depolama hesabının ait olduğu kuruluşun kiracı kimliğiyle değiştirin. Kiracı kimliğini bulmak için Azure portalında Kiracı özellikleri > Kiracı Kimliği'ni seçin.

Bu komut bir kimlik doğrulama kodu ve bir web sitesinin URL'sini döndürür. Web sitesini açın, kodu sağlayın ve ardından İleri düğmesini seçin.

Bir oturum açma penceresi görüntülenir. Bu pencerede, Azure hesabı kimlik bilgilerinizi kullanarak Azure hesabınızda oturum açın. Başarıyla oturum açıldıktan sonra tarayıcı penceresini kapatabilir ve AzCopy'yi kullanmaya başlayabilirsiniz.

Azure CLI kullanarak yetkilendirme

Azure CLI kullanarak oturum açarsanız Azure CLI, AzCopy'nin işlemleri yetkilendirmek için kullanabileceği bir OAuth belirteci alır.

AzCopy'nin bu belirteci kullanmasını sağlamak için aşağıdaki komutu yazın ve ENTER tuşuna basın.

Linux

export AZCOPY_AUTO_LOGIN_TYPE=AZCLI
export AZCOPY_TENANT_ID=<tenant-id>

Windows

$Env:AZCOPY_AUTO_LOGIN_TYPE="AZCLI"
$Env:AZCOPY_TENANT_ID="<tenant-id>"

Azure CLI kullanarak oturum açma hakkında daha fazla bilgi için bkz. Azure CLI kullanarak etkileşimli olarak Azure'da oturum açma.

Azure PowerShell kullanarak yetkilendirme

Azure PowerShell kullanarak oturum açarsanız Azure PowerShell, AzCopy'nin işlemleri yetkilendirmek için kullanabileceği bir OAuth belirteci alır.

AzCopy'nin bu belirteci kullanmasını sağlamak için aşağıdaki komutu yazın ve ENTER tuşuna basın.

$Env:AZCOPY_AUTO_LOGIN_TYPE="PSCRED"
$Env:AZCOPY_TENANT_ID=<tenant-id>

Azure PowerShell kullanarak oturum açma hakkında daha fazla bilgi için bkz. Azure PowerShell'de etkileşimli olarak oturum açma.

Sonraki Adımlar

• AzCopy hakkında daha fazla bilgi için bkz. AzCopy'yi kullanmaya başlama.

• Sorularınız, sorunlarınız veya genel geri bildiriminiz varsa bunları GitHub'dan gönderin.