Memecahkan masalah autentikasi lingkungan pengembangan

Artikel ini menyediakan panduan tentang pemecahan masalah autentikasi lingkungan pengembangan yang Anda temui saat mengautentikasi Azure SDK untuk aplikasi Java yang berjalan secara lokal pada mesin pengembang melalui berbagai TokenCredential implementasi. Untuk informasi selengkapnya, lihat Autentikasi Azure di lingkungan pengembangan Java.

Memecahkan masalah AzureCliCredential

Ketika Anda menggunakan AzureCliCredential, Anda dapat secara opsional mencoba/menangkap untuk CredentialUnavailableException. Tabel berikut menunjukkan kesalahan yang ditunjukkan pengecualian ini, dan metode mitigasi:

Pesan kesalahan Deskripsi Mitigasi
Azure CLI not installed Azure CLI tidak diinstal atau tidak dapat ditemukan. - Pastikan Anda menginstal Azure CLI.
- Validasi bahwa lokasi penginstalan ditambahkan ke PATH variabel lingkungan.
Please run 'az login' to set up account Saat ini tidak ada akun yang masuk ke Azure CLI, atau proses masuk telah kedaluwarsa. - Masuk ke Azure CLI dengan menggunakan az login perintah . Untuk informasi selengkapnya, lihat Masuk dengan Azure CLI.
- Validasi bahwa Azure CLI dapat memperoleh token. Untuk informasi selengkapnya, lihat bagian berikutnya.

Verifikasi bahwa Azure CLI dapat memperoleh token

Anda dapat memverifikasi secara manual bahwa Anda mengautentikasi Azure CLI dan dapat memperoleh token. Pertama, gunakan perintah berikut untuk memverifikasi bahwa akun saat ini masuk ke Azure CLI:

az account show

Setelah Anda memverifikasi bahwa Azure CLI menggunakan akun yang benar, gunakan perintah berikut untuk memvalidasi bahwa Azure CLI dapat memperoleh token untuk akun ini:

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

Peringatan

Output perintah ini berisi token akses yang valid. Untuk menghindari penyusupan keamanan akun, jangan bagikan token akses ini.

Memecahkan masalah AzureDeveloperCliCredential

Ketika Anda menggunakan AzureDeveloperCliCredential, Anda dapat secara opsional mencoba/menangkap untuk CredentialUnavailableException. Tabel berikut menunjukkan kesalahan yang ditunjukkan pengecualian ini, dan metode mitigasi:

Pesan kesalahan Deskripsi Mitigasi
Azure Developer CLI not installed Azure Developer CLI tidak diinstal atau tidak dapat ditemukan. - Pastikan Anda menginstal Azure Developer CLI.
- Validasi bahwa lokasi penginstalan ditambahkan ke PATH variabel lingkungan.
Please run 'azd auth login' to set up account Saat ini tidak ada akun yang masuk ke Azure Developer CLI, atau rincian masuk telah kedaluwarsa. - Masuk ke Azure Developer CLI dengan menggunakan azd auth login perintah .
- Validasi bahwa Azure Developer CLI dapat memperoleh token. Untuk informasi selengkapnya, lihat bagian berikutnya.

Verifikasi bahwa Azure Developer CLI dapat memperoleh token

Anda dapat memverifikasi bahwa Anda mengautentikasi CLI Pengembang Azure dengan benar dan dapat memperoleh token. Pertama, gunakan perintah berikut untuk memverifikasi bahwa akun saat ini masuk ke Azure Developer CLI:

azd config list

Setelah Anda memverifikasi Azure Developer CLI menggunakan akun yang benar, gunakan perintah berikut untuk memvalidasi bahwa CLI dapat memperoleh token untuk akun ini:

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

Peringatan

Output perintah ini berisi token akses yang valid. Untuk menghindari penyusupan keamanan akun, jangan bagikan token akses ini.

Memecahkan masalah AzurePowerShellCredential

Ketika Anda menggunakan AzurePowerShellCredential, Anda dapat secara opsional mencoba/menangkap untuk CredentialUnavailableException. Tabel berikut menunjukkan kesalahan yang ditunjukkan pengecualian ini, dan metode mitigasi:

Pesan kesalahan Deskripsi Mitigasi
PowerShell isn't installed. Penginstalan lokal PowerShell tidak ditemukan. Pastikan Anda menginstal PowerShell di komputer.
Az.Account module >= 2.2.0 isn't installed. Modul Az.Account yang diperlukan untuk autentikasi di Azure PowerShell belum diinstal. Instal modul Az.Account terbaru. Untuk informasi lebih lanjut, lihat Cara menginstal Azure PowerShell.
Please run 'Connect-AzAccount' to set up account. Saat ini tidak ada akun yang masuk ke Azure PowerShell. - Masuk ke Azure PowerShell dengan menggunakan Connect-AzAccount perintah . Untuk informasi selengkapnya, lihat Masuk dengan Azure PowerShell
- Validasi bahwa Azure PowerShell dapat memperoleh token.

Verifikasi bahwa Azure PowerShell bisa mendapatkan token

Anda dapat memastikan secara manual bahwa Anda telah mengautentikasi Azure PowerShell dengan benar dan bahwa Azure PowerShell dapat memperoleh token. Pertama, gunakan perintah berikut untuk memverifikasi bahwa akun saat ini masuk ke Azure CLI:

Get-AzContext

Perintah ini menghasilkan output yang mirip dengan contoh berikut:

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

Setelah Anda memverifikasi Azure PowerShell menggunakan akun yang benar, gunakan perintah berikut untuk memvalidasi bahwa akun ini bisa mendapatkan token untuk akun ini.

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

Peringatan

Output perintah ini berisi token akses yang valid. Untuk menghindari penyusupan keamanan akun, jangan bagikan token akses ini.

Memecahkan masalah VisualStudioCodeCredential

Catatan

Ini adalah masalah yang diketahui bahwa tidak berfungsi dengan versi ekstensi Akun Azure yang lebih baru dari . Perbaikan jangka panjang untuk masalah ini sedang berlangsung. Sementara itu, pertimbangkan untuk melakukan autentikasi melalui Azure CLI.

Ketika Anda menggunakan VisualStudioCodeCredential, Anda dapat secara opsional mencoba/menangkap untuk CredentialUnavailableException. Tabel berikut menunjukkan kesalahan yang ditunjukkan pengecualian ini, dan metode mitigasi:

Pesan kesalahan Deskripsi Mitigasi
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code Tidak ada informasi akun Azure yang ditemukan dalam konfigurasi Visual Studio Code. - Pastikan Anda menginstal plugin Akun Azure dengan benar.
- Gunakan Perintah Lihat Palet Perintah untuk menjalankan perintah Azure: Masuk. Perintah ini membuka jendela browser dan menampilkan halaman yang dapat Anda gunakan untuk masuk ke Azure.
- Jika Anda sudah menginstal ekstensi Akun Azure dan telah masuk ke akun Anda, coba keluar dan masuk lagi. Tindakan ini mengisi ulang cache dan berpotensi mengurangi kesalahan yang Anda dapatkan.
MSAL Interaction Required Exception VisualStudioCodeCredential dapat membaca kredensial yang di-cache dari dalam cache tetapi kemungkinan token yang di-cache sudah kedaluwarsa. Masuk ke ekstensi Akun Azure melalui Palet Perintah untuk menjalankan Azure: Masuk di VS Code IDE.
ADFS tenant not supported Autentikasi Layanan Azure Visual Studio saat ini tidak mendukung penyewa ADFS. Gunakan kredensial dari cloud yang didukung saat mengautentikasi dengan Visual Studio. Untuk informasi selengkapnya tentang cloud yang didukung, lihat Cloud nasional.

Langkah berikutnya

Jika panduan pemecahan masalah dalam artikel ini tidak membantu mengatasi masalah saat Anda menggunakan Azure SDK untuk pustaka klien Java, ajukan masalah di Azure SDK untuk repositori Java GitHub.