Guida alla risoluzione dei problemi di Azure Storage Explorer
Note
Questo articolo è stato utile? Diamo importanza al contributo degli utenti. Usare il pulsante Feedback in questa pagina per comunicare se questo articolo è stato utile o come possiamo migliorarlo.
Microsoft Azure Storage Explorer è un'app autonoma che facilita l'uso dei dati con Archiviazione di Azure in Windows, macOS e Linux. L'app può connettersi ad account di archiviazione ospitati in Azure, cloud nazionali e Azure Stack.
In questa guida sono riepilogate le soluzioni agli errori comuni riscontrati in Storage Explorer.
Problemi relativi alle autorizzazioni di Controllo degli accessi in base al ruolo di Azure
Il controllo degli accessi in base al ruolo di Azure consente una gestione degli accessi altamente granulare delle risorse di Azure combinando set di autorizzazioni in ruoli. Ecco alcune strategie per ottenere il funzionamento ottimale del controllo degli accessi in base al ruolo di Azure in Storage Explorer.
Come si accede alle risorse in Storage Explorer?
Se si verificano problemi durante l'accesso alle risorse di archiviazione tramite il controllo degli accessi in base al ruolo di Azure, è possibile che all'utente non siano stati assegnati i ruoli appropriati. Le sezioni seguenti descrivono le autorizzazioni attualmente richieste da Storage Explorer per l'accesso alle risorse di archiviazione. Contattare l'amministratore dell'account di Azure se non si è certi di avere i ruoli o le autorizzazioni appropriati.
Problema relativo alle autorizzazioni di "Lettura: Elencare/Ottenere gli account di archiviazione"
È necessario disporre dell'autorizzazione per elencare gli account di archiviazione. Per ottenere questa autorizzazione, è necessario avere il ruolo di Lettore.
Ottenere chiavi degli account di archiviazione
Storage Explorer può anche usare le chiavi dell'account per autenticare le richieste. È possibile accedere alle chiavi dell'account tramite ruoli avanzati, ad esempio il ruolo di Collaboratore.
Nota
Le chiavi di accesso concedono autorizzazioni senza restrizioni a chiunque le possieda. Di conseguenza, non è consigliabile dare le chiavi agli utenti dell'account. Se è necessario revocare le chiavi di accesso, è possibile rigenerarle dal portale di Azure.
Ruoli relativi ai dati
È necessario avere almeno un ruolo che conceda l'accesso alla lettura dei dati dalle risorse. Ad esempio, se si vogliono elencare o scaricare BLOB, è necessario almeno il ruolo lettore di dati dei BLOB di archiviazione.
Perché è necessario un ruolo del livello di gestione per visualizzare le risorse in Storage Explorer?
Archiviazione di Azure ha due livelli di accesso: gestione e dati. Le sottoscrizioni e gli account di archiviazione sono accessibili dal livello di gestione. È possibile accedere a contenitori, BLOB e altre risorse dati attraverso il livello dati. Ad esempio, se si vuole ottenere un elenco degli account di archiviazione da Azure, inviare una richiesta all'endpoint di gestione. Se si vuole un elenco di contenitori BLOB in un account, inviare una richiesta all'endpoint di servizio appropriato.
I ruoli di Azure possono concedere autorizzazioni per la gestione o l'accesso al livello dati. Il ruolo di Lettore, ad esempio, concede l'accesso in sola lettura alle risorse del livello di gestione.
In senso stretto, il ruolo di Lettore non fornisce autorizzazioni del livello dati e non è necessario per accedervi.
Storage Explorer semplifica l'accesso alle risorse raccogliendo le informazioni necessarie per connettersi alle risorse di Azure. Ad esempio, per visualizzare i contenitori BLOB, Storage Explorer invia una richiesta "elenca contenitori" all'endpoint di servizio del BLOB. Per ottenere tale endpoint, Storage Explorer cerca nell'elenco di sottoscrizioni e account di archiviazione a cui si ha accesso. Per trovare le sottoscrizioni e gli account di archiviazione, Storage Explorer deve anche accedere al livello di gestione.
Se non si ha un ruolo che concede autorizzazioni a livello di gestione, Storage Explorer non può ottenere le informazioni necessarie per connettersi al livello dati.
Cosa succede se non è possibile ottenere le autorizzazioni a livello di gestione necessarie dall'amministratore?
Per accedere ai contenitori BLOB, ai contenitori o alle directory di Azure Data Lake Storage Gen2, o alle code, è possibile connettersi a tali risorse usando le credenziali di Azure.
- Aprire la finestra di dialogo Connetti .
- Selezionare il tipo di risorsa a cui si desidera connettersi.
- Selezionare Accedi con Microsoft Entra ID>Next.
- Selezionare l'account utente e il tenant associati alla risorsa a cui si sta eseguendo il collegamento e quindi selezionare Avanti.
- Digitare l'URL della risorsa e quindi digitare un nome visualizzato univoco per la connessione. Selezionare Avanti>connetti.
Attualmente non esiste una soluzione correlata al controllo degli accessi in base al ruolo di Azure per altri tipi di risorse. Come soluzione alternativa, è possibile richiedere un URL di firma di accesso condiviso e quindi collegarlo alla risorsa:
- Aprire la finestra di dialogo Connetti .
- Selezionare il tipo di risorsa a cui si desidera connettersi.
- Selezionare Firma di accesso condiviso (SAS)>Avanti.
- Digitare l'URL della firma di accesso condiviso ricevuto e immettere un nome visualizzato univoco per la connessione. Selezionare Avanti>connetti.
Per altre informazioni su come connettersi alle risorse, vedere Collegarsi a una singola risorsa.
Ruoli predefiniti di Azure consigliati
Diversi ruoli predefiniti di Azure possono fornire le autorizzazioni necessarie per usare Storage Explorer. Alcuni di questi ruoli sono:
- Proprietario: consente di gestire qualsiasi aspetto, incluso l'accesso alle risorse.
- Collaboratore: consente di gestire tutto, tranne l'accesso alle risorse.
- Lettore: legge ed elenca le risorse.
- Collaboratore account di archiviazione: gestione completa degli account di archiviazione.
- Proprietario dei dati dei BLOB di archiviazione: consente l'accesso completo ai contenitori e ai dati dei BLOB di Archiviazione di Azure.
- Collaboratore ai dati del BLOB di archiviazione: lettura, scrittura ed eliminazione di contenitori e BLOB di Archiviazione di Azure.
- Lettore dei dati del BLOB di archiviazione: lettura e indicazione di contenitori e BLOB di Archiviazione di Azure.
Nota
I ruoli di Proprietario, Collaboratore e Collaboratore Account di archiviazione concedono l'accesso alla chiave dell'account.
Problemi relativi al certificato SSL
Questa sezione illustra i problemi relativi ai certificati SSL.
Informazioni sui problemi relativi ai certificati SSL
Assicurarsi di aver letto la sezione sui certificati SSL nella documentazione relativa alla rete di Storage Explorer prima di continuare.
Usare il proxy di sistema:
Se si usano solo funzionalità che supportano l'impostazione per usare il proxy di sistema, provare a usare tale impostazione. Per altre informazioni sull'impostazione proxy di sistema, vedere Connessioni di rete in Storage Explorer.
Importare certificati SSL
Se tuttavia si dispone di una copia del certificato autofirmato, è possibile indicare a Storage Explorer di considerarlo attendibile:
- Ottenere una copia del certificato X.509 (.cer) con codifica Base64
- Passare a Modifica>Certificati SSL>Importa certificati. Quindi, usando lo strumento di selezione file, trovare, selezionare e aprire i file con estensione .cer.
Questo problema può verificarsi anche se sono presenti più certificati (radice e intermedio). Per correggere questo errore, è necessario importare tutti i certificati.
Trovare i certificati SSL.
Se non si dispone di una copia dei certificati autofirmati, chiedere assistenza all'amministratore IT.
Per trovarli, seguire i seguenti passaggi:
Installare OpenSSL:
- Windows: una delle versioni light dovrebbe essere sufficiente.
- Mac: OpenSSL dovrebbe essere incluso nel sistema operativo.
- Linux: OpenSSL dovrebbe essere incluso nel sistema operativo.
Eseguire OpenSSL:
- Windows: aprire la directory di installazione, selezionare /bin/, quindi fare doppio clic su openssl.exe.
- Mac: eseguire
openssl
da un terminale. - Linux: eseguire
openssl
da un terminale.
Eseguire il comando
openssl s_client -showcerts -connect <hostname>:443
per i nomi host di Microsoft o Azure dietro alle risorse di archiviazione. Per altre informazioni, vedere questo elenco di nomi host a cui si accede di frequente Storage Explorer.Cercare i certificati autofirmati. Se l'oggetto
("s:")
e l'autorità di certificazione("i:")
sono uguali, è probabile che il certificato sia autofirmato.Quando si trovano i certificati autofirmato, copiare e incollare tutti gli elementi da
-----BEGIN CERTIFICATE-----
a-----END CERTIFICATE-----
in un nuovo file di .cer.Aprire Storage Explorer e passare a Modifica>Certificati SSL>Importa certificati. Quindi, usando lo strumento di selezione file, trovare, selezionare e aprire i file con estensione .cer creati.
Disabilitare la convalida del certificato SSL
Se non è possibile trovare alcun certificato autofirmato seguendo questi passaggi, contattare Microsoft tramite lo strumento di feedback. È anche possibile aprire Storage Explorer dalla riga di comando con il flag --ignore-certificate-errors
. Quando viene aperto con questo flag, Storage Explorer ignora gli errori del certificato. Questo flag non è consigliato.
Problemi di accesso
Questa sezione illustra i problemi di accesso che potrebbero verificarsi.
Informazioni sull'accesso
Prima di continuare, leggere la documentazione Accedere a Storage Explorer.
Frequente necessità di immettere nuovamente le credenziali
La necessità di immettere nuovamente le credenziali è probabilmente il risultato dei criteri di accesso condizionale impostati dall'amministratore di Microsoft Entra. Quando Storage Explorer chiede di immettere nuovamente le credenziali dal pannello dell'account, verrà visualizzato un collegamento Dettagli errore. Selezionarlo per scoprire il motivo per cui Storage Explorer chiede di immettere nuovamente le credenziali. Gli errori dei criteri di accesso condizionale che richiedono la reimmissione delle credenziali potrebbero essere simili ai seguenti:
- Il token di aggiornamento è scaduto.
- Per accedere, è necessario usare l'autenticazione a più fattori.
- L'amministratore ha apportato una modifica alla configurazione.
Per ridurre la frequenza di dover immettere nuovamente le credenziali a causa di errori come quelli precedenti, rivolgersi all'amministratore di Microsoft Entra.
Criteri di accesso condizionale
Se è necessario soddisfare i criteri di accesso condizionale per l'account, assicurarsi di usare il valore Web browser predefinito per l'impostazione Accedi con. Per informazioni su questa impostazione, vedere Modifica della posizione in cui si veridica l'accesso.
Il browser mostra un errore di reindirizzamento HTTP o di connessione non sicura durante l'accesso
Quando Storage Explorer esegue l'accesso nel Web browser, viene eseguito un reindirizzamento a localhost alla fine del processo di accesso. I browser a volte generano un avviso o un errore che indica che il reindirizzamento viene eseguito con HTTP e non con HTTPS. Alcuni browser potrebbero anche provare a forzare l'esecuzione del reindirizzamento con HTTPS. Se uno di questi problemi si verifica, a seconda del browser, sono disponibili opzioni:
- Ignorare l'avviso.
- Aggiungere un'eccezione per localhost.
- Disabilitare force HTTPS, globalmente o solo per localhost.
Se non è possibile eseguire alcuna di queste opzioni, è anche possibile modificare la posizione in cui si verifica l'accesso impostando l'accesso integrato per evitare di usare tutto il browser.
Impossibile acquisire il token, il tenant viene escluso da un filtro
A volte è possibile che venga visualizzato un messaggio di errore che indica che non è possibile acquisire un token perché un tenant viene escluso da un filtro. Ciò significa che si sta provando ad accedere a una risorsa presente in un tenant escluso da un filtro. Per includere il tenant, passare al pannello dell'account. Assicurarsi che la casella di controllo per il tenant specificato nell'errore sia selezionata. Per altre informazioni sull'applicazione dei filtri sui tenant in Storage Explorer, vedere Gestione degli account.
Impossibile avviare correttamente la libreria di autenticazione
Se all'avvio viene visualizzato un messaggio di errore che indica che la libreria di autenticazione di Storage Explorer non è stata avviata correttamente, assicurarsi che l'ambiente di installazione soddisfi tutti i prerequisiti. Il mancato soddisfacimento dei prerequisiti è la causa più probabile di questo messaggio di errore.
Se si ritiene che l'ambiente di installazione soddisfi tutti i prerequisiti, inserire un problema in GitHub. Quando si inserisce il problema, assicurarsi di indicare:
- Il sistema operativo.
- Versione di Storage Explorer che si sta provando a usare.
- Se sono stati controllati i prerequisiti.
- I log di autenticazione di un avvio non riuscito di Storage Explorer. La registrazione dettagliata dell'autenticazione viene abilitata automaticamente dopo questo tipo di errore.
Finestra vuota quando si usa l'accesso integrato
Se si sceglie di usare l'accesso integrato e viene visualizzata una finestra di accesso vuota, è probabile che sia necessario passare a un metodo di accesso diverso. Le finestre di dialogo di accesso vuote si verificano il più delle volte quando un server Active Directory Federation Services richiede a Storage Explorer di eseguire un reindirizzamento non supportato da Electron.
Per passare a un metodo di accesso diverso, modificare l'impostazione Accedi con in Impostazioni>Applicazione>Accedi. Per informazioni sui diversi tipi di metodo di accesso, vedere Modifica della posizione in cui si verifica l'accesso.
Ciclo di riautenticazione o modifica UPN
Se ci si trova in un ciclo di riautenticazione, o se l'UPN di uno degli account è stato modificato, procedere come segue:
- Aprire Storage Explorer.
- Passare a Aiuto>Ripristina.
- Assicurarsi che sia selezionata almeno l'opzione Autenticazione. Cancellare gli altri elementi che non si desidera reimpostare.
- Selezionare Reimposta.
- Riavviare lo strumento di esplorazione dell’archiviazione e riprovare ad accedere.
Se continuano a verificarsi problemi dopo aver eseguito una reimpostazione, provare la seguente procedura:
- Aprire Storage Explorer.
- Rimuovere tutti gli account e quindi chiudere Storage Explorer.
- Eliminare la cartella .IdentityService dal computer. In Windows la cartella si trova in C:\utenti\<username>\AppData\Local. Per Mac e Linux, è possibile trovare la cartella nella radice della directory dell'utente.
- Se si esegue Mac o Linux, è anche necessario eliminare la voce
Microsoft.Developer.IdentityService
dall'archivio chiavi del sistema operativo. Su Mac, l'archivio chiavi è l'applicazione Gnome Keychain. Per Linux, l'applicazione viene in genere chiamata Keyring, ma il nome può variare a seconda della distribuzione. - Riavviare lo strumento di esplorazione dell’archiviazione e riprovare ad accedere.
macOS: errori di Portachiavi o nessuna finestra di accesso
Portachiavi di macOS può talvolta andare in uno stato che causa problemi alla libreria di autenticazione di Storage Explorer. Per uscire da questo stato, seguire questa procedura:
Chiudere Azure Storage Explorer.
Aprire Keychain selezionando Barra spaziatrice dei comandi + , digitare keychain e selezionare INVIO.
Selezionare il portachiavi di accesso.
Selezionare il lucchetto per bloccare il portachiavi. Al termine del processo, il lucchetto viene visualizzato bloccato. Potrebbero essere necessari alcuni secondi, a seconda delle app aperte.
Aprire Storage Explorer.
Viene visualizzato un messaggio simile a "Hub di servizio vuole accedere al Keychain". Digitare la password dell'account amministratore Mac e selezionare Consenti sempre. In alternativa, selezionare Consenti se Consenti sempre non è disponibile.
Provare a effettuare l'accesso.
Linux: nessun errore di gestione password o finestra dell'applicazione all'avvio
Se si avvia Storage Explorer in un sistema Linux, è possibile che si verifichi uno dei problemi seguenti:
- Non viene visualizzata alcuna finestra dell'applicazione.
- Si verificano errori relativi al gestore delle password del sistema.
Storage Explorer usa il gestore delle credenziali del sistema per proteggere i dati, incluse le credenziali di accesso e le connessioni di firma di accesso condiviso. Se non viene rilevata alcuna applicazione di gestione delle credenziali compatibile, Storage Explorer non verrà avviato. Se nel sistema non è installato uno strumento di gestione delle credenziali locale, installare uno strumento di terze parti compatibile con libsecret
. Ad esempio, nei sistemi Linux che usano l'ambiente desktop GNOME, è possibile installare Seahorse.
Storage Explorer crea in genere un keyring predefinito se non esiste all'avvio. In alcuni casi, tuttavia, ciò potrebbe non verificarsi, senza errori di finestra dell'applicazione o del servizio di gestione delle password. Per risolvere i problemi, impostare manualmente un keyring predefinito.
Se si usa Seahorse e non sono presenti keyring esistenti o si vuole crearne uno nuovo, seguire questa procedura per creare un keyring predefinito:
- Avviare l'applicazione "Password e chiavi".
- Selezionare il pulsante "+" e quindi selezionare Keyring password.
- Impostare un nome e una password per il nuovo keyring.
- Fare clic con il pulsante destro del mouse sul nuovo keyring e scegliere Imposta come predefinito.
Se si usa lo snap di Storage Explorer, è anche necessario assicurarsi che Storage Explorer sia connesso al gestore delle password del sistema. A tale scopo, utilizzare il seguente comando:
snap connect storage-explorer:password-manager-service :password-manager-service
Il browser predefinito non si apre
Se il browser predefinito non si apre quando si tenta di accedere, provare tutte le tecniche seguenti:
- Riavviare Storage Explorer.
- Aprire manualmente il browser prima di avviare l'accesso.
- Provare a usare l'accesso integrato. Per istruzioni, vedere Modifica della posizione in cui si verifica l'accesso.
Altri problemi di accesso
Se nessuna delle istruzioni precedenti si applica al problema di accesso o se queste non risolvono il problema di accesso, inserire un problema in GitHub.
Sottoscrizioni mancanti e tenant interrotti
Se non è possibile recuperare le sottoscrizioni dopo aver eseguito correttamente l'accesso, provare i metodi di risoluzione dei problemi seguenti:
- Verificare che l'account abbia accesso alle sottoscrizioni previste. È possibile verificare l'accesso effettuando l'accesso al portale per l'ambiente di Azure che si sta tentando di usare.
- Assicurarsi di aver effettuato l'accesso usando l'ambiente di Azure corretto, ad esempio Azure, Azure Cina (21Vianet), Azure Germania, Azure Governo degli Stati Uniti o un ambiente personalizzato.
- Se si è dietro un server proxy, assicurarsi di aver configurato correttamente il proxy di Storage Explorer.
- Provare a rimuovere e aggiungere di nuovo l'account.
- Se è presente un collegamento "Più informazioni" o "Dettagli dell'errore", controllare quali messaggi di errore vengono segnalati per i tenant che hanno esito negativo. Se non si è certi di come rispondere ai messaggi di errore, inserire un problema in GitHub.
Problema di interazione con l'archivio credenziali del sistema operativo durante il trasferimento di AzCopy
Se viene visualizzato questo messaggio in Windows, Windows Credential Manager è molto probabilmente pieno. Per fare spazio in Gestione credenziali di Windows, seguire questa procedura:
- Chiudere Azure Storage Explorer.
- Nel menu Start cercare Gestione credenziali e aprirlo.
- Passare a Credenziali di Windows.
- In Credenziali generiche cercare le voci associate ai programmi che non vengono più usati ed eliminarle. È anche possibile cercare voci come
azcopy/aadtoken/<some number>
ed eliminarle.
Se il messaggio viene comunque visualizzato dopo aver completato i passaggi precedenti o se viene visualizzato su piattaforme diverse da Windows, è possibile inserire un problema in GitHub.
Non è possibile rimuovere un account di archiviazione o una risorsa collegati
Se non si riesce a rimuovere un account o una risorsa di archiviazione collegati tramite l'interfaccia utente, è possibile eliminare manualmente tutte le risorse collegate eliminando le cartelle seguenti:
- Windows: %AppData%/StorageExplorer
- macOS: /Utenti/<your_name>/Libreria/Application Support/StorageExplorer
- Linux: ~/.config/StorageExplorer
Chiudere Storage Explorer prima di eliminare queste cartelle.
Nota
Se sono stati importati certificati SSL, eseguire il backup del contenuto della directory certificati. In un secondo momento, è possibile usare il backup per reimportare i certificati SSL.
Problemi di proxy
Storage Explorer supporta la connessione alle risorse Archiviazione di Azure tramite un server proxy. Se si verificano problemi durante la connessione ad Azure tramite proxy, ecco alcuni suggerimenti.
Storage Explorer supporta solo l'autenticazione di base con i server proxy. Altri metodi di autenticazione, ad esempio NTLM, non sono supportati.
Nota
Storage Explorer non supporta i file di configurazione automatica del proxy per la configurazione delle impostazioni del proxy.
Verificare le impostazioni del proxy di Storage Explorer
L'impostazione Applicazione>Proxy>Configurazione proxy determina da quale origine Storage Explorer recupera la configurazione del proxy.
Se si seleziona Usare le variabili di ambiente, assicurarsi di impostare le variabili di ambiente HTTPS_PROXY
o HTTP_PROXY
. Le variabili di ambiente fanno distinzione tra maiuscole e minuscole, quindi assicurarsi di impostare le variabili corrette. Se queste variabili non sono definite o non sono valide, Storage Explorer non userà un proxy. Riavviare Storage Explorer dopo aver modificato le variabili di ambiente.
Se si seleziona Usa le impostazioni proxy dell'app, assicurarsi che le impostazioni del proxy in-app siano corrette.
Passaggi per la diagnosi dei problemi
Se si verificano ancora problemi, provare questi metodi di risoluzione dei problemi:
- Se è possibile connettersi a Internet senza usare il proxy, verificare che Storage Explorer funzioni senza le impostazioni del proxy abilitate. Se Storage Explorer si connette correttamente, potrebbe verificarsi un problema con il server proxy. Rivolgersi al proprio amministratore per identificare i problemi.
- Verificare che le altre applicazioni che usano il server proxy funzionino come previsto.
- Verificare che sia possibile connettersi al portale per l'ambiente di Azure che si sta tentando di usare.
- Verificare di poter ricevere le risposte dagli endpoint del servizio. Immettere uno degli URL dell'endpoint nel browser. Se è possibile connettersi, si dovrebbe ricevere una
InvalidQueryParameterValue
risposta XML simile o simile. - Controllare se un altro utente che usa Storage Explorer con lo stesso server proxy può connettersi. Se sì, potrebbe essere necessario contattare l'amministratore del server proxy.
Strumenti per la diagnosi dei problemi
Uno strumento di rete, ad esempio Fiddler, consente di diagnosticare i problemi.
- Configurare lo strumento di rete come server proxy in esecuzione nell'host locale. Se è necessario continuare a lavorare dietro un proxy effettivo, potrebbe essere necessario configurare lo strumento di rete per connettersi tramite il proxy.
- Controllare il numero della porta usato dallo strumento di rete.
- Configurare le impostazioni proxy di Storage Explorer per l'uso dell'host locale e del numero di porta dello strumento di rete, ad esempio
localhost:8888
.
Se impostato correttamente, lo strumento di rete registra le richieste di rete effettuate da Storage Explorer per la gestione e gli endpoint di servizio.
Se lo strumento di rete non sembra registrare il traffico di Storage Explorer, provare a testarlo con un'applicazione diversa. Ad esempio, immettere l'URL dell'endpoint per una delle risorse di archiviazione, ad esempio https://contoso.blob.core.windows.net/
in un Web browser. Si riceverà una risposta simile a questo esempio di codice:
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>InvalidQueryParameterValue</Code>
<Message>Value for one of the query parameters specified in the request URI is invalid.
RequestId:<RequestId> Time:2017-04-10T21:42:17.3863214Z</Message>
<QueryParameterName>comp</QueryParameterName>
<QueryParameterValue/>
<Reason/>
</Error>
La risposta suggerisce che la risorsa esiste, anche se non è possibile accedervi.
Se lo strumento di rete mostra solo il traffico proveniente da altre applicazioni, potrebbe essere necessario modificare le impostazioni del proxy in Storage Explorer. Altrimenti, potrebbe essere necessario modificare le impostazioni dello strumento.
Contattare l'amministratore del server proxy
Se le impostazioni del proxy sono corrette, potrebbe essere necessario contattare l'amministratore del server proxy per:
- Assicurarsi che il proxy non blocchi il traffico verso gli endpoint di gestione o delle risorse di Azure.
- Verificare il protocollo di autenticazione usato dal server proxy. Storage Explorer supporta solo i protocolli di autenticazione di base. Storage Explorer non supporta i proxy NTLM.
Messaggio di errore "Unable to Retrieve Children" (Impossibile recuperare gli elementi figlio)
Se si è connessi ad Azure tramite un proxy, verificare che le impostazioni del proxy siano corrette.
Se il proprietario di una sottoscrizione o di un account ha concesso l'accesso a una risorsa, verificare di avere autorizzazioni di lettura o di elenco per tale risorsa.
La stringa di connessione non dispone di impostazioni di configurazione complete
Se si riceve questo messaggio di errore, è possibile che non si disponga delle autorizzazioni necessarie per ottenere le chiavi dell'account di archiviazione. Per verificarlo, passare al portale e individuare l'account di archiviazione. Fare clic con il pulsante destro del mouse sul nodo dell'account di archiviazione e selezionare Apri nel portale. Passare quindi al riquadro Chiavi di accesso. Se non si ha l'autorizzazione per visualizzare le chiavi, verrà visualizzato un messaggio "Non si ha accesso". Per risolvere questo problema, è possibile ottenere il nome e la chiave dell'account o una firma di accesso condivisa dell'account e usarla per collegarsi all'account di archiviazione.
Se vengono visualizzate le chiavi dell'account, segnalare un problema in GitHub per consentire la risoluzione del problema.
"Si è verificato un errore durante l'aggiunta della nuova connessione: TypeError: Non è possibile leggere la proprietà 'version' di un elemento non definito"
Se viene visualizzato questo messaggio di errore quando si tenta di aggiungere una connessione personalizzata, i dati di connessione archiviati nella gestione credenziali locale potrebbero essere danneggiati. Per risolvere questo problema, provare a eliminare e aggiungere di nuovo le connessioni locali danneggiate:
Avviare Storage Explorer. Dal menu passare a Guida>Attiva/Disattiva strumenti di sviluppo.
Nella scheda Applicazione della finestra aperta passare ad Archiviazione locale>file:// a sinistra.
A seconda del tipo di connessione con cui si verifica il problema, cercare la relativa chiave. Copiarne quindi il valore in un editor di testo. Il valore è una matrice dei nomi della connessione personalizzata, ad esempio:
- Account di archiviazione
StorageExplorer_CustomConnections_Accounts_v1
- Contenitori BLOB
StorageExplorer_CustomConnections_Blobs_v1
StorageExplorer_CustomConnections_Blobs_v2
- Condivisioni file
StorageExplorer_CustomConnections_Files_v1
- Code
StorageExplorer_CustomConnections_Queues_v1
- Tabelle
StorageExplorer_CustomConnections_Tables_v1
- Account di archiviazione
Dopo aver salvato i nomi della connessione correnti, impostare il valore di Strumenti di sviluppo su
[]
.
Per mantenere le connessioni non danneggiate, seguire questa procedura per individuare le connessioni danneggiate. Se non è un problema perdere tutte le connessioni esistenti, ignorare questi passaggi e seguire le istruzioni specifiche della piattaforma per cancellare i dati della connessione.
- Da un editor di testo aggiungere di nuovo ogni nome della connessione in Strumenti di sviluppo. Controllare quindi se la connessione funziona ancora correttamente.
- Se una connessione funziona correttamente, non è danneggiata e quindi è possibile lasciarla così. Se una connessione non funziona, rimuovere il valore da Strumenti di sviluppo e registrarlo in modo da poterlo aggiungere in un secondo momento.
- Ripetere queste operazioni fino a quando non sono state esaminate tutte le connessioni.
Dopo aver rimosso i nomi delle connessioni, è necessario cancellare i dati danneggiati. È quindi possibile aggiungere di nuovo le connessioni usando la procedura per la connessione standard in Storage Explorer.
- Nel menu Start cercare Gestione credenziali e aprirlo.
- Passare a Credenziali di Windows.
- In Credenziali generiche cercare le voci con la chiave
<connection_type_key>/<corrupted_connection_name>
. Un esempio èStorageExplorer_CustomConnections_Accounts_v1/account1
. - Eliminare e aggiungere di nuovo queste connessioni.
Se l'errore si verifica ancora dopo aver eseguito questa procedura o se si vuole condividere l'elemento sospettato di aver danneggiato le connessioni, inserire un problema nella pagina di GitHub.
Problemi con un URL di firma di accesso condiviso
Se ci si connette a un servizio tramite un URL della firma di accesso condiviso e si verifica un errore:
- Verificare che l'URL abbia le autorizzazioni necessarie per la lettura o l'elenco delle risorse.
- Verificare che l'URL non sia scaduto.
- Se l'URL della firma di accesso condiviso si basa sui criteri di accesso, verificare che questi non siano stati revocati.
Se per errore il collegamento è stato eseguito usando un URL della firma di accesso condiviso non valido e ora non è possibile scollegarsi, seguire questa procedura:
- Quando si esegue Storage Explorer, selezionare F12 per aprire la finestra Strumenti di sviluppo.
- Nella scheda Applicazione selezionare Archiviazione locale>file:// a sinistra.
- Individuare la chiave associata al tipo di servizio dell'URI della firma di accesso condiviso. Ad esempio, se l'URI della firma di accesso condiviso non valido fa riferimento a un contenitore BLOB, cercare la chiave denominata
StorageExplorer_AddStorageServiceSAS_v1_blob
. - Il valore della chiave deve essere una matrice JSON. Individuare l'oggetto associato all'URI non valido e rimuoverlo.
- Selezionare CTRL +R per ricaricare Storage Explorer.
Dipendenze di Storage Explorer
Storage Explorer include tutte le dipendenze necessarie per l'esecuzione in Windows.
Applicare le patch a Storage Explorer per le versioni più recenti di .NET Core
Per Storage Explorer 1.7.0 o versioni precedenti, potrebbe essere necessario applicare patch alla versione di .NET Core usata da Storage Explorer:
Passare alla pagina NuGet e scaricare la versione 1.5.43 di StreamJsonRpc dal collegamento Scarica pacchetto a destra.
Dopo aver scaricato il pacchetto, modificarne l'estensione da .nupkg in .zip.
Decomprimere il pacchetto.
Aprire la cartella streamjsonrpc.1.5.43/lib/netstandard1.1/.
Copiare StreamJsonRpc.dll nei percorsi seguenti della cartella di Storage Explorer:
- StorageExplorer/risorse/app/ServiceHub/Servizi/Microsoft.Developer.IdentityService/
- StorageExplorer/risorse/app/ServiceHub/Host/ServiceHub.Host.Core.CLR.x64/
Il pulsante "Apri in Explorer" nella portale di Azure non funziona
Se il pulsante Apri in Explorer nel portale di Azure non funziona, assicurarsi di usare un browser compatibile. I browser seguenti sono stati testati per la compatibilità:
- Microsoft Edge
- Mozilla Firefox
- Google Chrome
- Microsoft Internet Explorer
Raccogliere i log
Quando si segnala un problema in GitHub, potrebbe essere richiesto di raccogliere determinati log per diagnosticare il problema.
Log di Storage Explorer
Storage Explorer registra vari elementi nei propri registri applicazioni. È possibile accedere facilmente a questi log selezionando Guida>Apri directory dei log. Per impostazione predefinita, Storage Explorer registra a un basso livello di dettaglio. Per modificare il livello di dettaglio, passare a Impostazioni (simbolo dell'ingranaggio a sinistra) >Applicazione>Registrazione>Livello di registrazione. È quindi possibile impostare il livello di registrazione in base alle esigenze. Per la risoluzione dei problemi, è consigliabile usare il livello di log di traccia perché è il livello più dettagliato. Dopo aver modificato il livello di log, riavviare Storage Explorer e riprodurre il problema riscontrato.
I log vengono suddivisi in cartelle per ogni sessione di Storage Explorer eseguita. Per i file di log che è necessario condividere, inserirli in un archivio ZIP, con file di sessioni diverse in cartelle diverse.
Log di autenticazione
Per i problemi relativi all'accesso o alla libreria di autenticazione di Storage Explorer, è molto probabile che sia necessario raccogliere i log di autenticazione. I log di autenticazione vengono archiviati in:
- Windows: C:\Utenti\<nome utente>\AppData\Local\Temp\servicehub\log
- macOS: ~/.ServiceHub/logs
- Linux: ~/.ServiceHub/logs
In genere, è possibile seguire questa procedura per raccogliere i log:
- Passare a Impostazioni (simbolo dell'ingranaggio a sinistra) >Applicazione>Accedi. Selezionare Registrazione dettagliata per l'autenticazione. Se Storage Explorer non viene avviato a causa di un problema con la relativa libreria di autenticazione, questo passaggio viene eseguito per l'utente.
- Chiudere Azure Storage Explorer.
- Facoltativo/consigliato: cancellare i log esistenti nella cartella log. Questo passaggio riduce la quantità di informazioni da inviare.
- Aprire Storage Explorer e riprodurre il problema.
- Chiudere Azure Storage Explorer.
- Comprimere il contenuto della cartella log.
Log di AzCopy
Se si verificano problemi durante il trasferimento dei dati, potrebbe essere necessario recuperare i log di AzCopy. Per impostazione predefinita, AzCopy registra a un basso livello di dettaglio. Per modificare il livello di dettaglio, passare a Impostazioni (il simbolo a forma di ingranaggio a sinistra)> Trasferisce>il livello di log di AzCopy.> È quindi possibile impostare il livello di registrazione in base alle esigenze. Per la risoluzione dei problemi, è consigliabile usare il livello di log di debug perché è il livello più dettagliato. Dopo aver modificato il livello di log, riavviare Storage Explorer e riprodurre il problema riscontrato.
I log di AzCopy sono disponibili facilmente tramite due metodi diversi:
- Per i trasferimenti non riusciti ancora nel log attività, selezionare Passa a file di log di AzCopy.
- Per i trasferimenti non riusciti in passato, passare alla cartella dei log di AzCopy. Questa cartella è disponibile all'indirizzo:
- Windows: C:\Utenti\<nome utente>\.azcopy
- macOS: ~/.azcopy
- Linux: ~/.azcopy
Log di rete
Per alcuni problemi, è necessario fornire i log delle chiamate di rete effettuate da Storage Explorer. In Windows è possibile ottenere i log di rete usando Fiddler.
Nota
Le tracce di Fiddler possono contenere password immesse o inviate nel browser durante la raccolta della traccia. Assicurarsi di leggere le istruzioni su come purificare una traccia di Fiddler. Non caricare le tracce Fiddler in GitHub. Verrà indicato dove è possibile inviare in modo sicuro la traccia di Fiddler.
Parte 1: Installare e configurare Fiddler
- Installare Fiddler.
- Avviare Fiddler.
- Passare a Strumenti>Opzioni.
- Selezionare la scheda HTTPS.
- Assicurarsi che Acquisisci CONNECT e Decrittografa traffico HTTPS siano selezionati.
- Seleziona Azioni.
- Selezionare Trust Root Certificate (Considera attendibile certificato radice) e quindi selezionare Sì nella finestra di dialogo successiva.
- Avviare Storage Explorer.
- Passare a Impostazioni (il simbolo a forma di ingranaggio a sinistra) >Application>Proxy.
- Modificare l'elenco a discesa origine proxy in Usa proxy di sistema (anteprima).
- Riavviare Storage Explorer.
- È consigliabile iniziare a visualizzare le chiamate di rete da un processo
storageexplorer:
visualizzato in Fiddler.
Parte 2: Riprodurre il problema
- Chiudere tutte le app diverse da Fiddler.
- Cancellare il log di Fiddler usando la X nell'angolo in alto a sinistra, accanto al menu Visualizza .
- Facoltativo/consigliato: lasciare a Fiddler alcuni minuti per applicare le impostazioni. Se vengono visualizzate chiamate di rete non correlate a Storage Explorer, fare clic con il pulsante destro del mouse su di esse e selezionare Filtra ora>Nascondi <nome del processo>.
- Avviare/riavviare Storage Explorer.
- Riprodurre il problema.
- Selezionare File>Salva>Tutte le sessioni. Salvare in una posizione facile da ricordare.
- Chiudere Fiddler e Storage Explorer.
Parte 3: Purificare la traccia di Fiddler
- Fare doppio clic sulla traccia di Fiddler (file con estensione SAZ).
- Selezionare CTRL + F.
- Nella finestra di dialogo visualizzata verificare che siano impostate le opzioni seguenti: Richieste di ricerca = e risposte ed Esaminare = intestazioni e corpi.
- Cercare le password usate durante la raccolta della traccia di Fiddler e le voci evidenziate. Fare clic con il pulsante destro del mouse e selezionare Rimuovi>Sessioni selezionate.
- Se nel browser sono state sicuramente immesse password durante la raccolta della traccia, ma non si trovano voci quando si usa CTRL + F, non si vuole modificare le password o se le password usate per altri account, ignorare l'invio del file con estensione saz.
- Salvare di nuovo la traccia con un nuovo nome.
- Facoltativo: eliminare la traccia originale.
Passaggi successivi
Se nessuna di queste soluzioni funziona, usare uno dei metodi seguenti:
Inserire un problema in GitHub selezionando il pulsante Segnala un problema in GitHub nell'angolo in basso a sinistra.
Dichiarazione di non responsabilità sulle informazioni di terze parti
I prodotti di terzi citati in questo articolo sono prodotti da società indipendenti da Microsoft. Microsoft non rilascia alcuna garanzia implicita o esplicita relativa alle prestazioni o all'affidabilità di tali prodotti
Contattaci per ricevere assistenza
In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.