Geliştirme ortamı kimlik doğrulaması sorunlarını giderme

Bu makalede, çeşitli TokenCredential uygulamalar aracılığıyla geliştirici makinelerinde yerel olarak çalışan Java uygulamaları için Azure SDK'nın kimliğini doğrularken karşılaşılan sorunlarla ilgili yönergeler sağlanmaktadır. Daha fazla bilgi için bkz. Java geliştirme ortamlarında Azure kimlik doğrulaması.

AzureCliCredential sorunlarını giderme

'AzureCliCredential' kullandığınızda, isteğe bağlı olarak 'CredentialUnavailableException' hatası için deneyebilir/yakalayabilirsiniz. Aşağıdaki tabloda, bu özel durumun gösterdiği hatalar ve azaltma yöntemleri gösterilmektedir:

Hata mesajı	Açıklama	Azaltma
Azure CLI not installed	Azure CLI yüklü değil veya bulunamadı.	- Azure CLI'yi düzgün yüklediğinizden emin olun. - Yükleme konumunun ortam değişkenine PATH eklendiğini doğrulayın.
Please run 'az login' to set up account	Şu anda Azure CLI'da oturum açmış bir hesap yok veya oturum açma süresi doldu.	- komutunu kullanarak Azure CLI'da az login oturum açın. Daha fazla bilgi için bkz . Azure CLI ile oturum açma. - Azure CLI'nın belirteçleri alabildiğini doğrulayın. Daha fazla bilgi için sonraki bölüme bakın.

Azure CLI'nın belirteçleri alabildiğini doğrulayın

Azure CLI'da doğru şekilde kimlik doğrulaması yapıp almadığını el ile doğrulayabilir ve belirteçleri alabilirsiniz. İlk olarak, hesabın şu anda Azure CLI'da oturum açtığını doğrulamak için aşağıdaki komutu kullanın:

az account show

Azure CLI'nın doğru hesabı kullandığını doğruladıktan sonra, bu hesap için belirteçleri alabildiği doğrulamak için aşağıdaki komutu kullanın:

az account get-access-token \
    --output json \
    --resource https://management.core.windows.net

Uyarı

Bu komutun çıktısı geçerli bir erişim belirteci içeriyor. Hesap güvenliğinin tehlikeye atılmasını önlemek için bu erişim belirtecini paylaşmayın.

AzureDeveloperCliCredential sorunlarını giderme

'AzureDeveloperCliCredential' kullandığınızda, isteğe bağlı olarak 'CredentialUnavailableException' hatası için deneyebilir/yakalayabilirsiniz. Aşağıdaki tabloda, bu özel durumun gösterdiği hatalar ve azaltma yöntemleri gösterilmektedir:

Hata mesajı	Açıklama	Azaltma
Azure Developer CLI not installed	Azure Geliştirici CLI'sı yüklü değil veya bulunamadı.	- Azure Geliştirici CLI'sını düzgün yüklediğinizden emin olun. - Yükleme konumunun ortam değişkenine PATH eklendiğini doğrulayın.
Please run 'azd auth login' to set up account	Azure Geliştirici CLI'sinde şu anda hiçbir hesap oturum açmadı veya oturum açma süresi doldu.	- komutunu kullanarak Azure Geliştirici CLI'sinde azd auth login oturum açın. - Azure Geliştirici CLI'sinin belirteçleri alabildiğini doğrulayın. Daha fazla bilgi için sonraki bölüme bakın.

Azure Geliştirici CLI'sinin belirteçleri alabildiğini doğrulayın

Azure Geliştirici CLI'sinin doğru şekilde kimlik doğrulaması yapıldığını el ile doğrulayabilir ve belirteçleri alabilirsiniz. İlk olarak, hesabın şu anda Azure Geliştirici CLI'sinde oturum açtığını doğrulamak için aşağıdaki komutu kullanın:

azd config list

Azure Geliştirici CLI'sının doğru hesabı kullandığını doğruladıktan sonra, bu hesap için belirteçleri edinebildiğini doğrulamak için aşağıdaki komutu kullanabilirsiniz:

azd auth token --output json --scope https://management.core.windows.net/.default

Uyarı

Bu komutun çıktısı geçerli bir erişim belirteci içeriyor. Hesap güvenliğinin tehlikeye atılmasını önlemek için bu erişim belirtecini paylaşmayın.

AzurePowerShellCredential sorunlarını giderme

'AzurePowerShellCredential' kullandığınızda, isteğe bağlı olarak 'CredentialUnavailableException' hatası için deneyebilir/yakalayabilirsiniz. Aşağıdaki tabloda, bu özel durumun gösterdiği hatalar ve azaltma yöntemleri gösterilmektedir:

Hata mesajı	Açıklama	Azaltma
PowerShell isn't installed.	PowerShell'in yerel yüklemesi bulunamadı.	Makineye PowerShell'i düzgün yüklediğinizden emin olun.
Az.Account module >= 2.2.0 isn't installed.	Az.Account Azure PowerShell'de kimlik doğrulaması için gereken modül yüklenmez.	En son Az.Account modülü yükleyin. Daha fazla bilgi için Azure PowerShell Nasıl Kurulur bölümüne bakın.
Please run 'Connect-AzAccount' to set up account.	Şu anda Azure PowerShell'de oturum açmış bir hesap yok.	- komutunu kullanarak Azure PowerShell'de Connect-AzAccount oturum açın. Daha fazla bilgi için bkz. Azure PowerShell ile oturum açma - Azure PowerShell'in belirteçleri alabildiğini doğrulayın. Daha fazla bilgi için sonraki bölüme bakın.

Azure PowerShell'in belirteçleri alabildiğini doğrulayın

Azure PowerShell'i doğru bir şekilde kimlik doğruladığınızı manuel olarak doğrulayabilir ve belirteç alabilirsiniz. İlk olarak, hesabın şu anda Azure CLI'da oturum açtığını doğrulamak için aşağıdaki komutu kullanın:

Get-AzContext

Bu komut aşağıdaki örneğe benzer bir çıktı oluşturur:

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

Azure PowerShell'in doğru hesabı kullandığını doğruladıktan sonra, bu hesap için belirteçleri edinebildiğini doğrulamak için aşağıdaki komutu kullanabilirsiniz.

Get-AzAccessToken -ResourceUrl "https://management.core.windows.net"

Uyarı

Bu komutun çıktısı geçerli bir erişim belirteci içeriyor. Hesap güvenliğinin tehlikeye atılmasını önlemek için bu erişim belirtecini paylaşmayın.

VisualStudioCodeCredential sorunlarını giderme

Uyarı

Bu, VisualStudioCodeCredential sürümlerinden daha yeni olanlarla çalışmayan 0.9.11. Bu soruna uzun vadeli bir düzeltme devam ediyor. Bu arada Azure CLI aracılığıyla kimlik doğrulamayı göz önünde bulundurun.

'VisualStudioCodeCredential' kullandığınızda, isteğe bağlı olarak 'CredentialUnavailableException' hatası için deneyebilir/yakalayabilirsiniz. Aşağıdaki tabloda, bu özel durumun gösterdiği hatalar ve azaltma yöntemleri gösterilmektedir:

Hata mesajı	Açıklama	Azaltma
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code	VS Code yapılandırmasında Azure hesabı bilgisi bulunamadı.	- Azure Hesabı eklentisini düzgün yüklediğinizden emin olun. - > komutunu yürütmek için Komut Paletini Görüntüle'yi kullanın. Bu komut bir tarayıcı penceresi açar ve Azure'da oturum açmanıza olanak tanıyan bir sayfa görüntüler. - Azure Hesabı uzantısı zaten yüklüyse ve hesabınızda oturum açtıysanız, oturumu kapatıp yeniden giriş yapmayı deneyin. Bu eylem önbelleği yeniden doldurur ve potansiyel olarak aldığınız hatayı hafifletir.
MSAL Interaction Required Exception	VisualStudioCodeCredential önbelleğe alınan kimlik bilgilerini önbellekten okuyabildi ancak önbelleğe alınan belirtecin süresi dolmuş olabilir.	VS Code IDE'de Azure> komutunu yürütmek için Görünüm Komut Paleti aracılığıyla Azure Hesabı uzantısında oturum açın.
ADFS tenant not supported	Visual Studio Azure Hizmet Kimlik Doğrulaması şu anda ADFS kiracılarını desteklememektedir.	Visual Studio ile kimlik doğrulaması yaparken desteklenen bir buluttan kimlik bilgilerini kullanın. Desteklenen bulutlar hakkında daha fazla bilgi için bkz. Ulusal bulutlar.

Sonraki Adımlar

Bu makaledeki sorun giderme kılavuzu, Java istemci kitaplıkları için Azure SDK'sını kullanırken karşılaşabileceğiniz sorunları çözmeye yardımcı olmazsa, Azure SDK for Java GitHub deposunda bir sorun bildirmenizi tavsiye ederiz.