Risolvere i problemi di autenticazione dell'ambiente di sviluppo

Questo articolo fornisce indicazioni sulla gestione dei problemi riscontrati durante l'autenticazione di applicazioni Azure SDK per Java in esecuzione in locale nei computer per sviluppatori, tramite varie TokenCredential implementazioni. Per altre informazioni, vedere Autenticazione di Azure in ambienti di sviluppo Java.

Risolvere i problemi di AzureCliCredential

Quando si usa AzureCliCredential, è possibile provare/catch facoltativamente per CredentialUnavailableException. La tabella seguente illustra gli errori che questa eccezione indica e i metodi di mitigazione:

Error message	Descrizione	Mitigazione
Azure CLI not installed	L'interfaccia della riga di comando di Azure non è installata o non è stata trovata.	- Assicurarsi di aver installato correttamente l'interfaccia della riga di comando di Azure. - Verificare che il percorso di installazione sia stato aggiunto alla PATH variabile di ambiente.
Please run 'az login' to set up account	Nessun account attualmente connesso all'interfaccia della riga di comando di Azure o l'accesso è scaduto.	- Accedere all'interfaccia della riga di comando di Azure usando il az login comando . Per altre informazioni, vedere Accedere tramite l'interfaccia della riga di comando di Azure. - Verificare che l'interfaccia della riga di comando di Azure possa ottenere i token. Per altre informazioni, vedere la sezione successiva.

Verificare che l'interfaccia della riga di comando di Azure possa ottenere i token

È possibile verificare manualmente di aver autenticato correttamente l'interfaccia della riga di comando di Azure e di ottenere i token. Usare prima di tutto il comando seguente per verificare che l'account sia attualmente connesso all'interfaccia della riga di comando di Azure:

az account show

Dopo aver verificato che l'interfaccia della riga di comando di Azure usa l'account corretto, usare il comando seguente per verificare che sia in grado di ottenere i token per questo account:

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

Avviso

L'output di questo comando contiene un token di accesso valido. Per evitare di compromettere la sicurezza degli account, non condividere questo token di accesso.

Risolvere i problemi di AzureDeveloperCliCredential

Quando si usa AzureDeveloperCliCredential, è possibile provare/catch facoltativamente per CredentialUnavailableException. La tabella seguente illustra gli errori che questa eccezione indica e i metodi di mitigazione:

Error message	Descrizione	Mitigazione
Azure Developer CLI not installed	L'interfaccia della riga di comando per sviluppatori di Azure non è installata o non è stata trovata.	- Assicurarsi di aver installato correttamente l'interfaccia della riga di comando per sviluppatori di Azure. - Verificare che il percorso di installazione sia stato aggiunto alla PATH variabile di ambiente.
Please run 'azd auth login' to set up account	Nessun account attualmente connesso all'interfaccia della riga di comando per sviluppatori di Azure o l'accesso è scaduto.	- Accedere all'interfaccia della riga di comando per sviluppatori di Azure usando il azd auth login comando . - Verificare che l'interfaccia della riga di comando per sviluppatori di Azure possa ottenere i token. Per altre informazioni, vedere la sezione successiva.

Verificare che l'interfaccia della riga di comando per sviluppatori di Azure possa ottenere i token

È possibile verificare manualmente di aver autenticato correttamente l'interfaccia della riga di comando per sviluppatori di Azure e di ottenere i token. Usare prima di tutto il comando seguente per verificare che l'account sia attualmente connesso all'interfaccia della riga di comando per sviluppatori di Azure:

azd config list

Dopo aver verificato che l'interfaccia della riga di comando per sviluppatori di Azure usa l'account corretto, è possibile usare il comando seguente per verificare che sia in grado di ottenere i token per questo account:

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

Avviso

L'output di questo comando contiene un token di accesso valido. Per evitare di compromettere la sicurezza degli account, non condividere questo token di accesso.

Risolvere i problemi di AzurePowerShellCredential

Quando si usa AzurePowerShellCredential, è possibile provare/catch facoltativamente per CredentialUnavailableException. La tabella seguente illustra gli errori che questa eccezione indica e i metodi di mitigazione:

Error message	Descrizione	Mitigazione
PowerShell isn't installed.	Non è stata trovata alcuna installazione locale di PowerShell.	Assicurarsi di aver installato correttamente PowerShell nel computer.
Az.Account module >= 2.2.0 isn't installed.	Il Az.Account modulo necessario per l'autenticazione in Azure PowerShell non è installato.	Installare il modulo più recente Az.Account . Per altre informazioni, vedere Come installare Azure PowerShell.
Please run 'Connect-AzAccount' to set up account.	Nessun account attualmente connesso ad Azure PowerShell.	- Accedere ad Azure PowerShell usando il Connect-AzAccount comando . Per altre informazioni, vedere Accedere con Azure PowerShell - Verificare che Azure PowerShell possa ottenere i token. Per altre informazioni, vedere la sezione successiva.

Verificare che Azure PowerShell possa ottenere i token

È possibile verificare manualmente che Azure PowerShell sia stato autenticato correttamente e che sia possibile ottenere i token. Usare prima di tutto il comando seguente per verificare che l'account sia attualmente connesso all'interfaccia della riga di comando di Azure:

Get-AzContext

Questo comando genera un output simile all'esempio seguente:

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

Dopo aver verificato che Azure PowerShell usa l'account corretto, è possibile usare il comando seguente per verificare che sia in grado di ottenere i token per questo account.

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

Avviso

L'output di questo comando contiene un token di accesso valido. Per evitare di compromettere la sicurezza degli account, non condividere questo token di accesso.

Risolvere i problemi di VisualStudioCodeCredential

Nota

Si tratta di un problema noto che VisualStudioCodeCredential non funziona con le versioni dell'estensione account di Azure più recenti di 0.9.11. È in corso una correzione a lungo termine per questo problema. Nel frattempo, prendere in considerazione l'autenticazione tramite l'interfaccia della riga di comando di Azure.

Quando si usa VisualStudioCodeCredential, è possibile provare/catch facoltativamente per CredentialUnavailableException. La tabella seguente illustra gli errori che questa eccezione indica e i metodi di mitigazione:

Error message	Descrizione	Mitigazione
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code	Non sono state trovate informazioni sull'account Azure nella configurazione di VS Code.	- Assicurarsi di aver installato correttamente il plug-in dell'account Azure. - Usare il riquadro comandi Visualizza > per eseguire il comando Azure: Accedi. Questo comando apre una finestra del browser e visualizza una pagina che consente di accedere ad Azure. - Se l'estensione dell'account Azure è già installata e ha eseguito l'accesso all'account, provare a disconnettersi e accedere di nuovo. Questa azione ripopola la cache e riduce potenzialmente l'errore che si sta ricevendo.
MSAL Interaction Required Exception	VisualStudioCodeCredential è stato in grado di leggere le credenziali memorizzate nella cache, ma è probabile che il token memorizzato nella cache sia scaduto.	Accedere all'estensione account di Azure tramite Visualizza riquadro comandi per eseguire il comando Azure: Sign In nell'IDE > di VS Code.
ADFS tenant not supported	L'autenticazione del servizio di Azure di Visual Studio attualmente non supporta i tenant ADFS.	Usare le credenziali da un cloud supportato durante l'autenticazione con Visual Studio. Per altre informazioni sui cloud supportati, vedere Cloud nazionali.

Passaggi successivi

Se le linee guida per la risoluzione dei problemi in questo articolo non consentono di risolvere i problemi quando si usano le librerie client di Azure SDK per Java, è consigliabile segnalare un problema nel repository GitHub di Azure SDK per Java.