guida alla risoluzione dei problemi di Azure Storage Explorer

Nota

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 semplifica l'uso dei dati di Archiviazione di Azure in Windows, macOS e Linux. L'app può connettersi agli account di archiviazione ospitati in Azure, cloud nazionali e Azure Stack.

In questa guida vengono riepilogate le soluzioni per i problemi comunemente riscontrati in Storage Explorer.

Problemi relativi alle autorizzazioni del 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 il funzionamento ottimale del controllo degli accessi in base al ruolo di Azure in Storage Explorer.

Ricerca per categorie accedere alle risorse in Storage Explorer?

Se si verificano problemi di accesso alle risorse di archiviazione tramite controllo degli accessi in base al ruolo di Azure, è possibile che non siano stati assegnati i ruoli appropriati. Le sezioni seguenti descrivono le autorizzazioni Storage Explorer attualmente necessarie per l'accesso alle risorse di archiviazione. Se non si è certi di avere i ruoli o le autorizzazioni appropriati, contattare l'amministratore dell'account Azure.

Problema di autorizzazioni "Read: List/Get Storage Account(s)"

È necessario disporre dell'autorizzazione per elencare gli account di archiviazione. Per ottenere questa autorizzazione, è necessario assegnare il ruolo Lettore.

Elencare le chiavi dell'account di archiviazione

Storage Explorer può anche usare le chiavi dell'account per autenticare le richieste. È possibile ottenere l'accesso alle chiavi dell'account tramite ruoli più potenti, ad esempio il ruolo Collaboratore.

Nota

Le chiavi di accesso concedono autorizzazioni senza restrizioni a chiunque le contenga. Di conseguenza, non è consigliabile distribuire queste chiavi agli utenti dell'account. Se è necessario revocare le chiavi di accesso, è possibile rigenerarle dal portale di Azure.

Ruoli dati

È necessario assegnare almeno un ruolo che conceda l'accesso alla lettura dei dati dalle risorse. Ad esempio, se si desidera elencare o scaricare BLOB, è necessario, almeno, il ruolo Lettore dati 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 tramite il livello di gestione. I contenitori, i BLOB e altre risorse di dati sono accessibili tramite il livello dati. Ad esempio, se si vuole ottenere un elenco degli account di archiviazione da Azure, si invia 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 le autorizzazioni per la gestione o l'accesso al livello dati. Il ruolo Lettore, ad esempio, concede l'accesso in sola lettura alle risorse del livello di gestione.

In senso stretto, il ruolo Lettore non fornisce autorizzazioni di livello dati e non è necessario per accedere al livello dati.

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 di "contenitori elenco" all'endpoint del servizio BLOB. Per ottenere tale endpoint, Storage Explorer cerca nell'elenco delle sottoscrizioni e degli 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 dispone di un ruolo che concede autorizzazioni al livello di gestione, Storage Explorer non è in grado di ottenere le informazioni necessarie per connettersi al livello dati.

Cosa succede se non è possibile ottenere le autorizzazioni del livello di gestione necessarie dall'amministratore?

Se si vuole accedere a contenitori BLOB, Azure Data Lake Storage Gen2 contenitori o directory o code, è possibile collegarsi a tali risorse usando le credenziali di Azure.

  1. Aprire la finestra di dialogo Connetti .
  2. Selezionare il tipo di risorsa a cui connettersi.
  3. Selezionare Accedi usando Microsoft Entra ID>Avanti.
  4. Selezionare l'account utente e il tenant associati alla risorsa a cui ci si sta collegando e quindi selezionare Avanti.
  5. Digitare l'URL della risorsa e quindi digitare un nome visualizzato univoco per la connessione. SelezionareConnettisuccessivo>.

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:

  1. Aprire la finestra di dialogo Connetti .
  2. Selezionare il tipo di risorsa a cui connettersi.
  3. Selezionare Firma di accesso condiviso (SAS)>Avanti.
  4. Digitare l'URL della firma di accesso condiviso ricevuto e immettere un nome visualizzato univoco per la connessione. SelezionareConnettisuccessivo>.

Per altre informazioni su come connettersi alle risorse, vedere Collegare a una singola risorsa.

Diversi ruoli predefiniti di Azure possono fornire le autorizzazioni necessarie per usare Storage Explorer. Alcuni di questi ruoli sono:

Nota

I ruoli Proprietario, Collaboratore e Collaboratore account di archiviazione concedono l'accesso alla chiave dell'account.

Problemi relativi ai certificati SSL

Questa sezione illustra i problemi relativi ai certificati SSL.

Informazioni sui problemi relativi ai certificati SSL

Assicurarsi di aver letto la sezione certificati SSL nella documentazione di rete Storage Explorer prima di continuare.

Usare il proxy di sistema

Se si usano solo funzionalità che supportano l'impostazione del proxy di sistema , provare a usare tale impostazione. Per altre informazioni sull'impostazione del proxy di sistema, vedere Connessioni di rete in Storage Explorer.

Importare certificati SSL

Se si dispone di una copia dei certificati autofirmati, è possibile indicare a Storage Explorer di considerarli attendibili:

  1. Ottenere una copia X.509 (.cer) con codifica Base 64 del certificato.
  2. Passare a Modifica>certificati SSLImporta certificati>. Usare quindi la selezione file per trovare, selezionare e aprire il file .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.

Seguire questa procedura per trovarli:

  1. Installare OpenSSL:

    • Windows: tutte le versioni light devono essere sufficienti.
    • Mac: OpenSSL deve essere incluso nel sistema operativo.
    • Linux: OpenSSL deve essere incluso nel sistema operativo.
  2. Eseguire OpenSSL:

    • Windows: aprire la directory di installazione, selezionare /bin/, quindi fare doppio clic su openssl.exe.
    • Mac: eseguire openssl da un terminale.
    • Linux: eseguito openssl da un terminale.
  3. Eseguire il comando openssl s_client -showcerts -connect <hostname>:443 per uno dei nomi host di Microsoft o Azure in cui si trovano le risorse di archiviazione. Per altre informazioni, vedere questo elenco di nomi host a cui si accede di frequente da Storage Explorer.

  4. Cercare i certificati autofirmati. Se l'oggetto ("s:") e l'autorità di certificazione ("i:") sono gli stessi, è molto probabile che il certificato sia autofirmati.

  5. Quando si trovano i certificati autofirmati, copiare e incollare tutti gli elementi da -----BEGIN CERTIFICATE----- a in -----END CERTIFICATE----- un nuovo file di .cer.

  6. Aprire Storage Explorer e passare a Modifica>certificati> SSLImporta certificati. Usare quindi la selezione file per trovare, selezionare e aprire i file .cer creati.

Disabilitare la convalida del certificato SSL

Se non è possibile trovare certificati autofirmati seguendo questi passaggi, contattare Microsoft tramite lo strumento di feedback. È anche possibile aprire Storage Explorer dalla riga di comando con il --ignore-certificate-errors flag . 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

Assicurarsi di aver letto la documentazione accedi a Storage Explorer prima di continuare.

Spesso è necessario immettere di nuovo le credenziali

La necessità di immettere nuovamente le credenziali è probabilmente il risultato dei criteri di accesso condizionale impostati dall'amministratore Microsoft Entra. Quando Storage Explorer chiede di immettere nuovamente le credenziali dal pannello dell'account, verrà visualizzato un collegamento Dettagli errore. Selezionarlo per vedere perché Storage Explorer chiede di immettere di nuovo 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 reimmissione delle credenziali a causa di errori come quelli precedenti, rivolgersi all'amministratore Microsoft Entra.

Criteri di accesso condizionale

Se sono presenti criteri di accesso condizionale che devono essere soddisfatti per l'account, assicurarsi di usare il valore del Web browser predefinito per l'impostazione Accedi con . Per informazioni su tale impostazione, vedere Modifica della posizione in cui si verifica l'accesso.

Il browser si lamenta del reindirizzamento HTTP o della 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 anziché CON HTTPS. Alcuni browser potrebbero anche provare a forzare l'esecuzione del reindirizzamento con HTTPS. Se si verifica uno di questi problemi, a seconda del browser sono disponibili opzioni:

  • Ignorare l'avviso.
  • Aggiungere un'eccezione per localhost.
  • Disabilitare force HTTPS, a livello globale o solo per localhost.

Se non è possibile eseguire alcuna di queste opzioni, è anche possibile modificare la posizione in cui si verifica l'accesso integrato per evitare di usare completamente il browser.

Non è possibile acquisire il token, il tenant viene filtrato

A volte è possibile che venga visualizzato un messaggio di errore che indica che non è possibile acquisire un token perché un tenant è filtrato. Ciò significa che si sta provando ad accedere a una risorsa in un tenant filtrato. Per includere il tenant, passare al pannello account. Assicurarsi che sia selezionata la casella di controllo per il tenant specificato nell'errore. Per altre informazioni sul filtro dei 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. Non soddisfare i prerequisiti è la causa più probabile di questo messaggio di errore.

Se si ritiene che l'ambiente di installazione soddisfi tutti i prerequisiti, aprire un problema in GitHub. Quando si apre il problema, assicurarsi di includere:

  • Il sistema operativo.
  • Quale versione di Storage Explorer si sta tentando di usare.
  • Indica se sono stati controllati i prerequisiti.
  • Log di autenticazione da 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 più spesso quando un server Active Directory Federation Services richiede Storage Explorer di eseguire un reindirizzamento non supportato da Electron.

Per passare a un metodo di accesso diverso, modificare l'impostazione Accedi con inImpostazioni>Accesso applicazione>. Per informazioni sui diversi tipi di metodi di accesso, vedere Modifica del percorso di accesso.

Ciclo di riautenticazione o modifica upn

Se si è in un ciclo di riautenticazione o si è modificato l'UPN di uno degli account, provare a seguire questa procedura:

  1. Aprire Storage Explorer.
  2. Passare a Reimpostazione della Guida>.
  3. Assicurarsi che sia selezionata almeno l'opzione Autenticazione . Cancella altri elementi che non vuoi reimpostare.
  4. Selezionare Reimposta.
  5. Riavviare Storage Explorer e provare di nuovo ad accedere.

Se si continuano a riscontrare problemi dopo aver eseguito una reimpostazione, provare a eseguire questa procedura:

  1. Aprire Storage Explorer.
  2. Rimuovere tutti gli account e quindi chiudere Storage Explorer.
  3. Eliminare l'oggetto . Cartella IdentityService dal computer. In Windows la cartella si trova in C:\users\<username>\AppData\Local. Per Mac e Linux, è possibile trovare la cartella nella radice della directory utente.
  4. Se si esegue Mac o Linux, è anche necessario eliminare la Microsoft.Developer.IdentityService voce dall'archivio chiavi del sistema operativo. Nel Mac, l'archivio chiavi è l'applicazione Gnome Keychain. In Linux l'applicazione è in genere denominata Keyring, ma il nome potrebbe variare a seconda della distribuzione.
  5. Riavviare Storage Explorer e provare di nuovo ad accedere.

macOS: errori di keychain o nessuna finestra di accesso

MacOS Keychain può talvolta immettere uno stato che causa problemi per la libreria di autenticazione Storage Explorer. Per uscire da questo stato, seguire questa procedura:

  1. Chiudere Storage Explorer.

  2. Aprire Keychain selezionandoBarra spaziatricecomandi + , digitare keychain e selezionare INVIO.

  3. Selezionare il keychain di accesso .

  4. Selezionare il lucchetto per bloccare il portachiava. Al termine del processo, il lucchetto viene visualizzato bloccato. Potrebbero essere necessari alcuni secondi, a seconda delle app aperte.

    Screenshot che mostra il lucchetto.

  5. Aprire Storage Explorer.

  6. Viene visualizzato un messaggio come "L'hub del servizio vuole accedere al keychain". Digitare la password dell'account amministratore Mac e selezionare Always Allow.Type your Mac admin account password and select Always Allow. In alternativa, selezionare Consenti se Always Allow non è disponibile.

  7. Provare ad accedere.

Linux: nessuna finestra dell'applicazione o errori di gestione password 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 alla gestione password del sistema.

Storage Explorer usa la gestione credenziali del sistema per proteggere i dati, incluse le credenziali di accesso e le connessioni sas. Se non viene rilevata alcuna applicazione di gestione credenziali compatibile, Storage Explorer non verrà avviata. 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 in genere crea un keyring predefinito se non esiste all'avvio. In alcuni casi, tuttavia, ciò potrebbe non verificarsi, causando errori del servizio gestione password o finestra dell'applicazione. Per risolvere i problemi, impostare manualmente un keyring predefinito.

Se si usa Seahorse e non sono presenti keyring esistenti o se si vuole crearne uno nuovo, seguire questa procedura per creare un keyring predefinito:

  1. Avviare l'applicazione "Password e chiavi".
  2. Selezionare il pulsante "+" e quindi selezionare Keyring password.
  3. Impostare un nome e una password per il nuovo keyring.
  4. Fare clic con il pulsante destro del mouse sul nuovo keyring e scegliere Imposta come predefinito.

Se si usa lo snap Storage Explorer, è anche necessario assicurarsi che Storage Explorer sia connesso alla gestione 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:

Altri problemi di accesso

Se nessuna delle istruzioni precedenti si applica al problema di accesso o se non riesce a risolvere il problema di accesso, aprire 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 accedendo al portale per l'ambiente azure che si sta tentando di usare.
  • Assicurarsi di aver eseguito l'accesso tramite l'ambiente Azure corretto, ad esempio Azure, Azure Cina 21Vianet, Azure Germania, Azure US Government o Ambiente personalizzato.
  • Se si è dietro un server proxy, assicurarsi di aver configurato correttamente il proxy Storage Explorer.
  • Provare a rimuovere e aggiungere di nuovo l'account.
  • Se è presente un collegamento "Altre informazioni" o "Dettagli 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, aprire un problema in GitHub.

Problema durante l'interazione con l'archivio credenziali del sistema operativo durante un trasferimento AzCopy

Se viene visualizzato questo messaggio in Windows, Windows Credential Manager è molto probabilmente pieno. Per fare spazio in Windows Credential Manager, seguire questa procedura:

  1. Chiudere Storage Explorer.
  2. Nel menu Start cercare Credential Manager e aprirlo.
  3. Passare a Credenziali di Windows.
  4. In Credenziali generiche cercare le voci associate ai programmi che non vengono più usate ed eliminarle. È anche possibile cercare voci come azcopy/aadtoken/<some number> ed eliminare tali voci.

Se il messaggio continua a essere visualizzato dopo aver completato i passaggi precedenti o se questo messaggio viene visualizzato su piattaforme diverse da Windows, è possibile aprire un problema in GitHub.

Non è possibile rimuovere un account di archiviazione collegato o una risorsa

Se non è possibile rimuovere un account collegato o una risorsa di archiviazione tramite l'interfaccia utente, è possibile eliminare manualmente tutte le risorse collegate eliminando le cartelle seguenti:

  • Windows: %AppData%/StorageExplorer
  • macOS: /Users/<your_name>/Library/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 certs . Successivamente, è possibile usare il backup per reimportare i certificati SSL.

Problemi relativi al proxy

Storage Explorer supporta la connessione alle risorse di 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 proxy autoconfig per la configurazione delle impostazioni proxy.

Verificare Storage Explorer impostazioni proxy

L'impostazione diconfigurazione proxydell'applicazione>> determina da quale Storage Explorer di origine ottiene la configurazione del proxy.

Se si seleziona Usa variabili di ambiente, assicurarsi di impostare le HTTPS_PROXY variabili di ambiente 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 valide, Storage Explorer non userà un proxy. Riavviare Storage Explorer dopo aver modificato le variabili di ambiente.

Se si seleziona Usa impostazioni proxy dell'app, verificare che le impostazioni proxy in-app siano corrette.

Passaggi per la diagnosi dei problemi

Se si verificano ancora problemi, provare questi metodi di risoluzione dei problemi:

  1. Se è possibile connettersi a Internet senza usare il proxy, verificare che Storage Explorer funzioni senza impostazioni proxy abilitate. Se Storage Explorer si connette correttamente, potrebbe verificarsi un problema con il server proxy. Collaborare con l'amministratore per identificare i problemi.
  2. Verificare che le altre applicazioni che usano il server proxy funzionino come previsto.
  3. Verificare che sia possibile connettersi al portale per l'ambiente azure che si sta tentando di usare.
  4. Verificare che sia possibile ricevere risposte dagli endpoint di servizio. Immettere uno degli URL dell'endpoint nel browser. Se è possibile connettersi, si riceverà una InvalidQueryParameterValue risposta XML o simile.
  5. Controllare se un altro utente che usa Storage Explorer con lo stesso server proxy può connettersi. Se possibile, 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.

  1. 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.
  2. Controllare il numero di porta usato dallo strumento di rete.
  3. Configurare Storage Explorer impostazioni proxy per l'uso dell'host locale e del numero di porta dello strumento di rete, ad localhost:8888esempio .

Se impostato correttamente, lo strumento di rete registra le richieste di rete effettuate da Storage Explorer agli endpoint di gestione e di servizio.

Se lo strumento di rete non sembra registrare Storage Explorer traffico, provare a testare lo strumento con un'applicazione diversa. Ad esempio, immettere l'URL dell'endpoint per una delle risorse di archiviazione, ad https://contoso.blob.core.windows.net/ esempio 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 proxy in Storage Explorer. In caso contrario, potrebbe essere necessario modificare le impostazioni dello strumento.

Contattare l'amministratore del server proxy

Se le impostazioni 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 di 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 "Impossibile recuperare elementi figlio"

Se si è connessi ad Azure tramite un proxy, verificare che le impostazioni proxy siano corrette.

Se il proprietario di una sottoscrizione o di un account ha concesso l'accesso a una risorsa, verificare di disporre delle autorizzazioni di lettura o elencate per tale risorsa.

La stringa di connessione non dispone di impostazioni di configurazione complete

Se viene visualizzato questo messaggio di errore, è possibile che non si disponga delle autorizzazioni necessarie per ottenere le chiavi per l'account di archiviazione. Per confermare, passare al portale e individuare l'account di archiviazione. Fare clic con il pulsante destro del mouse sul nodo per l'account di archiviazione e scegliere Apri nel portale. Passare quindi al riquadro Chiavi di accesso . Se non si dispone dell'autorizzazione per visualizzare le chiavi, verrà visualizzato un messaggio "Non si ha accesso". Per risolvere questo problema, è possibile ottenere un nome account e una chiave o una firma di accesso condiviso dell'account e usarlo per collegare l'account di archiviazione.

Se vengono visualizzate le chiavi dell'account, creare un problema in GitHub per consentire di risolvere il problema.

"Errore durante l'aggiunta di una nuova connessione: TypeError: Impossibile leggere la proprietà 'version' di undefined"

Se viene visualizzato questo messaggio di errore quando si tenta di aggiungere una connessione personalizzata, i dati di connessione archiviati in Gestione credenziali locale potrebbero essere danneggiati. Per risolvere questo problema, provare a eliminare e aggiungere nuovamente le connessioni locali danneggiate:

  1. Avviare Storage Explorer. Dal menu passare a Guida>per attivare/disattivare strumenti di sviluppo.

  2. Nella finestra aperta, nella scheda Applicazione passare a Archiviazione> localefile:// sul lato sinistro.

  3. A seconda del tipo di connessione con cui si sta verificando un problema, cercare la relativa chiave. Copiarne quindi il valore in un editor di testo. Il valore è una matrice dei nomi di connessione personalizzati, 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
  4. Dopo aver salvato i nomi di connessione correnti, impostare il valore in Strumenti di sviluppo su [].

Per mantenere le connessioni non danneggiate, seguire questa procedura per individuare le connessioni danneggiate. Se non si ha problemi a perdere tutte le connessioni esistenti, ignorare questi passaggi e seguire le istruzioni specifiche della piattaforma per cancellare i dati di connessione.

  1. Da un editor di testo, aggiungere di nuovo ogni nome di connessione a Strumenti di sviluppo. Controllare quindi se la connessione è ancora funzionante.
  2. Se una connessione funziona correttamente, non è danneggiata; si può tranquillamente lasciarlo lì. Se una connessione non funziona, rimuovere il relativo valore da Strumenti di sviluppo e registrarlo in modo da poterlo aggiungere in un secondo momento.
  3. Ripetere fino a quando non sono state esaminate tutte le connessioni.

Dopo aver rimosso i nomi di connessione, è necessario cancellarne i dati danneggiati. È quindi possibile aggiungere nuovamente le connessioni usando i passaggi di connessione standard in Storage Explorer.

  1. Nel menu Start cercare Credential Manager e aprirlo.
  2. Passare a Credenziali di Windows.
  3. In Credenziali generiche cercare le voci che hanno la <connection_type_key>/<corrupted_connection_name> chiave. Un esempio è StorageExplorer_CustomConnections_Accounts_v1/account1.
  4. Eliminare e aggiungere nuovamente queste connessioni.

Se si verifica ancora questo errore dopo aver eseguito questi passaggi o se si vuole condividere ciò che si sospetta abbia danneggiato le connessioni, aprire un problema nella pagina GitHub.

Problemi relativi a un URL di firma di accesso condiviso

Se ci si connette a un servizio tramite un URL di firma di accesso condiviso e si verifica un errore:

  • Verificare che l'URL fornisca le autorizzazioni necessarie per leggere o elencare le risorse.
  • Verificare che l'URL non sia scaduto.
  • Se l'URL della firma di accesso condiviso è basato su criteri di accesso, verificare che i criteri di accesso non siano stati revocati.

Se si è accidentalmente collegati usando un URL di firma di accesso condiviso non valido e ora non è possibile scollegarsi, seguire questa procedura:

  1. Quando si esegue Storage Explorer, selezionare F12 per aprire la finestra Strumenti di sviluppo.
  2. Nella scheda Applicazione selezionare Archiviazione> localefile:// sul lato sinistro.
  3. Trovare la chiave associata al tipo di servizio dell'URI della firma di accesso condiviso. Ad esempio, se l'URI di firma di accesso condiviso non valido è per un contenitore BLOB, cercare la chiave denominata StorageExplorer_AddStorageServiceSAS_v1_blob.
  4. Il valore della chiave deve essere una matrice JSON. Trovare l'oggetto associato all'URI non valido ed eliminarlo.
  5. Selezionare CTRL +R per ricaricare Storage Explorer.

Storage Explorer dipendenze

Storage Explorer viene fornito in pacchetto con tutte le dipendenze necessarie per l'esecuzione in Windows.

Patch 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:

  1. Passare alla pagina NuGet e scaricare la versione 1.5.43 di StreamJsonRpc dal collegamento Scarica pacchetto a destra.

  2. Dopo aver scaricato il pacchetto, modificare l'estensione del file da nupkg a .zip.

  3. Decomprimere il pacchetto.

  4. Aprire la cartella streamjsonrpc.1.5.43/lib/netstandard1.1/ .

  5. Copiare StreamJsonRpc.dll nei percorsi seguenti nella cartella Storage Explorer:

    • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
    • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

Il pulsante "Apri in Esplora" nel portale di Azure non funziona

Se il pulsante Apri in Esplora risorse 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 a GitHub, potrebbe essere richiesto di raccogliere determinati log per diagnosticare il problema.

Storage Explorer log

Storage Explorer registra vari elementi nei propri log dell'applicazione. È possibile accedere facilmente a questi log selezionando HelpOpen Logs Directory (Aprire la directory dei logdella Guida>). Per impostazione predefinita, Storage Explorer log a un livello basso di dettaglio. Per modificare il livello di dettaglio, passare a Impostazioni (simbolo a ingranaggio a sinistra) >Livello di logdi registrazione>applicazioni>. È quindi possibile impostare il livello di log in base alle esigenze. Per la risoluzione dei problemi, è consigliabile usare il livello di log di traccia perché è il livello più dettagliato.

I log vengono suddivisi in cartelle per ogni sessione di Storage Explorer eseguita. Per tutti 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:\Users\<nomeutente>\AppData\Local\Temp\servicehub\logs
  • macOS: ~/. ServiceHub/logs
  • Linux: ~/. ServiceHub/logs

In genere, è possibile seguire questa procedura per raccogliere i log:

  1. Passare a Impostazioni (simbolo dell'ingranaggio a sinistra) >Accesso all'applicazione>. Selezionare Registrazione autenticazione dettagliata. Se Storage Explorer non viene avviato a causa di un problema con la relativa libreria di autenticazione, questo passaggio viene eseguito per l'utente.
  2. Chiudere Storage Explorer.
  3. Facoltativo/consigliato: cancellare i log esistenti dalla cartella logs . Questo passaggio riduce la quantità di informazioni che è necessario inviare.
  4. Aprire Storage Explorer e riprodurre il problema.
  5. Chiudere Storage Explorer.
  6. Comprimere il contenuto della cartella logs .

Log di AzCopy

Se si verificano problemi durante il trasferimento dei dati, potrebbe essere necessario ottenere i log di AzCopy. I log di AzCopy possono essere trovati facilmente tramite due metodi diversi:

  • Per i trasferimenti non riusciti ancora nel log attività, selezionare Vai a AzCopy Log File.For failed transfers still in the Activity Log, select Go to AzCopy Log File.

  • Per i trasferimenti non riusciti in passato, passare alla cartella log AzCopy. Questa cartella è disponibile all'indirizzo:

    • Windows: C:\Users\<your username>\.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 potrebbero 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 tracce di Fiddler in GitHub. Ti verrà detto dove puoi inviare in modo sicuro la traccia di Fiddler.

Parte 1: Installare e configurare Fiddler

  1. Installare Fiddler.
  2. Avviare Fiddler.
  3. Passare a Opzioni strumenti>.
  4. Selezionare la scheda HTTPS .
  5. Assicurarsi che l'opzione Acquisisci CONNECT e Decrittografa il traffico HTTPS sia selezionata.
  6. Selezionare Azioni.
  7. Selezionare Attendibilità certificato radice e quindi selezionare nella finestra di dialogo successiva.
  8. Avviare Storage Explorer.
  9. Passare a Impostazioni (simbolo dell'ingranaggio a sinistra) >Application>Proxy.
  10. Modificare l'elenco a discesa dell'origine proxy in Usare il proxy di sistema (anteprima).Change the proxy source dropdown to Use system proxy (preview).
  11. Riavviare Storage Explorer.
  12. È consigliabile iniziare a visualizzare le chiamate di rete da un storageexplorer: processo in Fiddler.

Parte 2: Riprodurre il problema

  1. Chiudere tutte le app diverse da Fiddler.
  2. Cancellare il log di Fiddler usando la X nell'angolo superiore sinistro, accanto al menu Visualizza .
  3. Facoltativo/consigliato: impostare Fiddler per alcuni minuti. Se vengono visualizzate chiamate di rete non correlate a Storage Explorer, fare clic con il pulsante destro del mouse su di esse e scegliere Filtra ora>Nascondi <nome> processo.
  4. Avviare/riavviare Storage Explorer.
  5. Riprodurre il problema.
  6. Selezionare Salva>>file tutte le sessioni. Salvalo da qualche parte che non dimenticherai.
  7. Chiudere Fiddler e Storage Explorer.

Parte 3: Purificare la traccia di Fiddler

  1. Fare doppio clic sulla traccia Fiddler (file con estensione saz).
  2. Selezionare CTRL + F.
  3. Nella finestra di dialogo visualizzata verificare che siano impostate le opzioni seguenti: Search = Richiesta e risposte ed Esaminare = intestazioni e corpi.
  4. Search per tutte le password usate durante la raccolta della traccia di Fiddler e delle voci evidenziate. Fare clic con il pulsante destro del mouse e scegliere Rimuovi>sessioni selezionate.
  5. Se nel browser sono state 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 vengono usate per altri account, ignorare l'invio del file SAZ.
  6. Salvare di nuovo la traccia con un nuovo nome.
  7. Facoltativo: eliminare la traccia originale.

Passaggi successivi

Se nessuna di queste soluzioni funziona correttamente, usare uno dei metodi seguenti:

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.