Risolvere i problemi di Azure Storage Explorer

Sommario

Microsoft Azure Storage Explorer è un'app autonoma che semplifica l'uso dei dati di Azure Storage su 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 con le autorizzazioni 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 far funzionare Azure RBAC in modo ottimale in Storage Explorer.

Come si accede alle risorse in Storage Explorer?

Se non puoi accedere alle risorse di archiviazione tramite Azure RBAC, potresti non avere i ruoli corretti assegnati. Le sezioni seguenti descrivono le autorizzazioni attualmente richieste da Storage Explorer per l'accesso alle risorse di archiviazione. Contattare l'amministratore dell'account Azure se non si è certi di avere i ruoli o le autorizzazioni appropriati.

Problema di autorizzazioni per "Read: List/Get Storage Accounts"

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

Elencare le 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.

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?

Azure Storage ha due livelli di accesso: gestione e dati. È possibile accedere alle sottoscrizioni e agli account di archiviazione tramite il livello di gestione. È possibile accedere a contenitori, BLOB e altre risorse dati tramite 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 vuoi ottenere un elenco di contenitori BLOB in un account, invia 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.

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

Attualmente non esiste una soluzione correlata all'Azure RBAC per altri tipi di risorsa. 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 si desidera 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. Selezionare Avanti>Connetti.

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

Ruoli predefiniti di Azure consigliati

Diversi ruoli predefiniti di Azure forniscono le autorizzazioni necessarie per usare Storage Explorer. Alcuni di questi ruoli includono:

• 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.
• Responsabile account di archiviazione: gestione completa degli account di archiviazione.
• Proprietario dei dati Blob di Storage: accesso completo ai contenitori e ai dati Blob di Storage 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: leggere ed elencare i contenitori e i BLOB di archiviazione di Azure.

Problemi relativi al certificato TLS/SSL

In questa sezione vengono illustrati i problemi relativi ai certificati TLS/SSL.

Informazioni sui problemi relativi ai certificati TLS/SSL

Assicurarsi di comprendere la sezione Certificati TLS/SSL nella documentazione sulla 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 del proxy di sistema , vedere Connessioni di rete in Storage Explorer.

Importare certificati TLS/SSL

Se tuttavia si dispone di una copia del certificato autofirmato, è possibile indicare a Storage Explorer di considerarlo attendibile:

1. Ottenere una copia del certificato X.509 (.cer) con codifica Base64
2. Passare a Modifica>Certificati SSL>Importa certificati. Quindi, usando lo strumento di selezione file, trovare, selezionare e aprire i file con estensione .cer.

Questo errore può verificarsi anche se sono presenti più certificati (radice e intermedio). Per correggere questo errore, è necessario importare tutti i certificati.

Trovare certificati TLS/SSL

Se non si dispone di una copia dei certificati autofirmati, chiedere assistenza all'amministratore IT.

Per trovare i certificati, seguire questa procedura:

1. Installare OpenSSL:

   • Windows: qualsiasi versione leggera è sufficiente.
   • Mac: OpenSSL è incluso nel sistema operativo.
   • Linux: OpenSSL è 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: eseguire openssl da un terminale.

3. Eseguire il comando openssl s_client -showcerts -connect <hostname>:443 per uno dei nomi host di Microsoft o Azure dietro cui si trovano le vostre 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 uguali, è probabile che il certificato sia autofirmato.

5. Quando si trovano i certificati autofirmati, per ciascuno, copiare e incollare tutto da -----BEGIN CERTIFICATE----- a -----END CERTIFICATE----- in un nuovo file .cer.

6. 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 TLS/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.

Problemi di accesso

Questa sezione illustra i problemi di accesso che potrebbero verificarsi.

Informazioni sull'accesso

Assicurati di aver compreso la documentazione di accesso a Storage Explorer prima di continuare.

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 Entra di Microsoft. Quando Storage Explorer chiede di immettere nuovamente le credenziali dal pannello dell'account, verrà visualizzato un collegamento ai Dettagli dell'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 reinserizione delle credenziali potrebbero essere simili a questi errori:

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.

Altri problemi relativi ai criteri di accesso condizionale

Se per l'account devono essere soddisfatti altri criteri di accesso condizionale, provare a usare il valore di Authentication Broker o Default Web Browser per l'impostazione Accedi con . Per informazioni su questa impostazione, vedere Modifica della posizione in cui si veridica l'accesso.

Problemi relativi al broker di autenticazione in Windows

Il sistema operativo Windows usa Web Account Manager (WAM) come gestore di autenticazione. Se si usa il metodo di accesso di Authentication Broker in Windows e si verificano problemi, vedere questa guida per la procedura per risolvere gli errori comuni.

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 reindirizzato 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 il protocollo HTTPS forzato, 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 è filtrato.

A volte viene visualizzato un messaggio di errore che indica che non è possibile acquisire un token perché un tenant viene filtrato. Questo errore indica che si sta tentando di accedere a una risorsa che si trova in un tenant filtrato. Per includere il tenant, passare al Pannello 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.

La libreria di autenticazione non è stata avviata correttamente

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 crei il tuo problema, assicurati di indicare:

• Il proprio sistema operativo
• La tua versione di Storage Explorer
• I tuoi log di autenticazione da un tentativo di 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 del nome principale utente (UPN)

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

1. Aprire Storage Explorer.
2. Vai a Aiuto>Ripristina.
3. Assicurarsi che sia selezionata almeno l'opzione Autenticazione. Cancellare gli altri elementi che non si desidera reimpostare.
4. Selezionare Reimposta.
5. Riavviare lo strumento di esplorazione dell’archiviazione e riprovare ad accedere.

Se si continuano a verificarsi problemi dopo la reimpostazione, provare questa procedura:

1. Aprire Storage Explorer.
2. Rimuovere tutti gli account e quindi chiudere Storage Explorer.
3. Eliminare la cartella .IdentityService dal computer. In Windows trovare la cartella in C:\Users\<username>\AppData\Local. Per macOS e Linux, trovare la cartella nella radice della directory utente.
4. Se si esegue macOS o Linux, eliminare anche la Microsoft.Developer.IdentityService voce dall'archivio chiavi del sistema operativo. In macOS 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.
5. Riavviare lo strumento di esplorazione dell’archiviazione e riprovare ad accedere.

macOS: errori di Portachiavi o nessuna finestra di accesso

Il keychain macOS può talvolta entrare in uno stato che causa problemi per la libreria di autenticazione di Storage Explorer. Per far uscire Keychain da questo stato, seguire questa procedura:

1. Chiudere Storage Explorer.

2. Apri Keychain selezionando Command + spazio, digita "portachiavi" nella casella di ricerca e seleziona INVIO.

3. Selezionare il portachiavi di accesso.

4. 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.

   

5. Aprire Storage Explorer.

6. 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.

7. Provare a effettuare l'accesso.

Linux: Nessun errore della finestra dell'applicazione o del gestore 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 al gestore delle password del sistema.

Storage Explorer usa il gestore delle credenziali del sistema per proteggere i tuoi dati, incluse le credenziali di accesso e le connessioni SAS (Shared Access Signature). Se non rileva un'applicazione di gestione delle credenziali compatibile, Storage Explorer non può essere avviato. Se nel sistema non è installato uno strumento di gestione delle credenziali locale, è possibile installare uno strumento 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, non viene creato un keyring predefinito, 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:

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 di Storage Explorer, è anche necessario assicurarsi che Storage Explorer sia connesso al gestore delle password del sistema. Per connettere lo strumento di gestione password, eseguire il comando seguente:

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 non risolve 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 effettuando l'accesso al portale per l'ambiente di Azure che si sta tentando di usare.
• Assicurarsi di accedere all'ambiente Azure corretto (Azure, Azure Cina 21Vianet, Azure US Government o Ambiente personalizzato).
• Assicurati di aver configurato correttamente il proxy di Storage Explorer se sei dietro un server proxy.
• Rimuovere e aggiungere di nuovo l'account.
• Controllare quali messaggi di errore vengono segnalati per i tenant che presentano errori se è presente un collegamento Altre informazioni o Dettagli dell'errore. Se non si è certi di come rispondere ai messaggi di errore, aprire 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:

1. Chiudere Storage Explorer.
2. Nel menu Start cercare Gestione credenziali e aprirlo.
3. Passare a Credenziali di Windows.
4. 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 continua a essere visualizzato dopo aver completato i passaggi precedenti o se viene visualizzato questo messaggio su piattaforme diverse da Windows, è possibile aprire 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:

Chiudere Storage Explorer prima di eliminare queste cartelle.

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 New Technology LAN Manager (NTLM), non sono supportati.

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 predefinite o non valide, Storage Explorer non usa 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 dell'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 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.
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 di Azure che si sta tentando di usare.
4. 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 risposta XML, come InvalidQueryParameterValue o simile.
5. 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.

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 della porta usato dallo strumento di rete.
3. 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 inviate da Storage Explorer agli endpoint di gestione e 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 dovrebbe ricevere 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 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 disporre delle autorizzazioni di "lettura" o "elenco" 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 verificare, accedi al portale e individua il tuo 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 dispone dell'autorizzazione per visualizzare le chiavi, potrebbe essere visualizzato un messaggio "Non si ha accesso". Per risolvere questo problema, ottenere un nome e una chiave dell'account o una firma di accesso condiviso e usarli per collegare l'account di archiviazione.

Se vengono visualizzate le chiavi dell'account, segnalare un problema in GitHub in modo che sia possibile risolvere il problema.

L'aggiunta di connessioni personalizzate risulta in un TypeError

Gestione credenziali locali potrebbe archiviare dati di connessione danneggiati se viene visualizzato il messaggio di errore seguente quando si tenta di aggiungere una connessione personalizzata:

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

Per risolvere questo problema, provare a eliminare e aggiungere di nuovo le connessioni locali danneggiate:

1. Avviare Storage Explorer. Dal menu passare a Guida>Attiva/Disattiva strumenti di sviluppo.

2. Nella scheda Applicazione della finestra aperta passare ad Archiviazione locale>file:// a sinistra.

3. 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

4. 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.

1. Da un editor di testo aggiungere di nuovo ogni nome della connessione in Strumenti di sviluppo. Controllare quindi se la connessione funziona ancora correttamente.
2. Se una connessione funziona correttamente, non è danneggiata; si può tranquillamente lasciare lì. Se una connessione non funziona, rimuovere il valore da Strumenti di sviluppo e registrarlo in modo da poterlo aggiungere in un secondo momento.
3. Ripetere per ogni connessione.

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.

Se si verifica ancora questo errore dopo l'esecuzione di questi passaggi o se si vuole condividere ciò che si sospetta che le connessioni siano danneggiate, aprire 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 di firma di accesso condiviso e si verifica un errore, verificare le condizioni seguenti:

• L'URL fornisce le autorizzazioni necessarie per leggere o elencare le risorse.
• L'URL non è scaduto.
• I criteri di accesso non vengono revocati se l'URL della firma di accesso condiviso si basa su un criterio di accesso.

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

1. Quando si esegue Storage Explorer, selezionare F12 per aprire la finestra Strumenti di sviluppo.
2. Nella scheda Applicazione selezionare Archiviazione locale>file:// a sinistra.
3. 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.
4. Il valore della chiave è una matrice JSON. Individuare l'oggetto associato all'URI non valido e rimuoverlo.
5. Selezionare CTRL +R per ricaricare Storage Explorer.

Dipendenze di Storage Explorer

snap connect storage-explorer:password-manager-service :password-manager-service

snap connect storage-explorer:password-manager-service :password-manager-service

snap connect storage-explorer:password-manager-service :password-manager-service

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:

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 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 vengono testati per la compatibilità:

• Microsoft Edge
• Mozilla Firefox
• Google Chrome
• Microsoft Internet Explorer

Raccogliere i registri di sistema

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 eventi nei propri log applicazioni. È possibile accedere facilmente a questi log selezionando Guida>per aprire la directory dei log. Per impostazione predefinita, Storage Explorer effettua registrazioni a un livello basso di verbosità. Utilizzare il livello di log Trace durante la risoluzione di problemi tecnici, poiché è il livello più dettagliato.

Per modificare il livello di dettaglio, andare su Impostazioni (il simbolo di ingranaggio nella barra degli strumenti verticale) >Registrazione delle Applicazioni>Livello di Log> e selezionare il livello di log desiderato. Riavviare Storage Explorer e quindi riprodurre il problema.

I log vengono suddivisi in cartelle per ogni sessione di Storage Explorer eseguita. Per condividere i file di log, inserirli in un archivio ZIP. Usare cartelle diverse per i file di sessioni 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. Storage Explorer archivia i log di autenticazione nei percorsi seguenti:

In genere, seguire questa procedura per raccogliere i log:

1. Passare a Impostazioni (il simbolo a forma di ingranaggio nella barra degli strumenti verticale)> Accesso dell'applicazione>. Selezionare Registrazione estesa dell'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.
2. Chiudere Storage Explorer.
3. (Facoltativo) Cancellare i log esistenti dalla logs cartella. Questo passaggio riduce la quantità di informazioni da inviare.
4. Aprire Storage Explorer e riprodurre il problema.
5. Chiudere Storage Explorer.
6. Comprimere il contenuto della logs cartella.

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 una bassa verbosità. Il livello log di Traccia è consigliato per la risoluzione dei problemi perché è il livello più dettagliato.

Per modificare il livello di log, vai a Impostazioni (il simbolo a forma di ingranaggio nella barra degli strumenti verticale) Transfers AzCopy Log Level e imposta il livello di log desiderato. Riavviare Storage Explorer, quindi riprodurre il problema riscontrato.

È possibile trovare i log di AzCopy tramite due metodi diversi:

• Per i trasferimenti non riusciti che sono ancora nel log delle attività, selezionare Vai al file di log di AzCopy.

• Per i trasferimenti non riusciti in passato, passare alla cartella dei log di AzCopy. Questa cartella è disponibile in:

  Piattaforma	Percorso cartella
  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.

Parte 1: Installare e configurare Fiddler

1. Installare Fiddler.
2. Avvia Fiddler.
3. Passare a Strumenti>Opzioni.
4. Selezionare la scheda HTTPS.
5. Assicurarsi che Acquisisci CONNECT e Decrittografa traffico HTTPS siano selezionati.
6. Seleziona Azioni.
7. Selezionare Certificato radice attendibile e quindi selezionare Sì nella finestra di dialogo successiva.
8. Avviare Storage Explorer.
9. Vai a Impostazioni (l'ingranaggio nella barra degli strumenti verticale) Proxy dell'applicazione.
10. Modificare il dropdown di origine proxy in Usa proxy di sistema (anteprima).
11. Riavviare Storage Explorer.
12. Dovresti iniziare a vedere le chiamate di rete da un processo storageexplorer: che compaiono in Fiddler.

Parte 2: Riprodurre il problema

1. Chiudere tutte le app diverse da Fiddler.
2. Svuotare il log di Fiddler usando X nell'angolo in alto a sinistra, accanto al menu Visualizza.
3. (Facoltativo) Lasciare che Fiddler si esegua per alcuni minuti. Se vengono visualizzate chiamate di rete non correlate a Storage Explorer, fare clic con il pulsante destro del mouse e scegliere Filtra ora>Nascondi <nome> processo.
4. Avvia o riavvia Storage Explorer.
5. Riprodurre il problema.
6. Selezionare File>Salva>Tutte le sessioni. Salvarlo in una posizione facile da ricordare.
7. Chiudi Fiddler e Storage Explorer.

Parte 3: Purificare la traccia di Fiddler

1. Fare doppio clic sulla traccia di Fiddler (file .saz).
2. Selezionare Ctrl + F.
3. Nella finestra di dialogo visualizzata, verificare che siano impostate le opzioni seguenti: Cerca = Richieste e risposte e Esamina = Intestazioni e corpi.
4. Cerca eventuali password che hai utilizzato durante la raccolta della traccia di Fiddler ed eventuali voci che risultano evidenziate. Fare clic con il pulsante destro del mouse e selezionare Rimuovi>Sessioni selezionate.
5. È possibile ignorare l'invio del file con estensione saz se sono soddisfatte le condizioni seguenti:
   • Hai sicuramente inserito le password nel browser mentre raccoglievi la traccia, ma non trovi nessuna voce quando usi Ctrl + F.
   • Non si vuole modificare le password.
   • Le password usate sono per altri account.
6. Salvare di nuovo la traccia con un nuovo nome.
7. (Facoltativo) Eliminare la traccia originale.

Storage Explorer non riesce a trovare i contenitori Azurite

Se Storage Explorer non riesce a trovare i contenitori Azurite Docker o Podman, seguire questa procedura per risolvere il problema:

1. Verificare che sia installata la versione più recente di Storage Explorer

Assicurarsi di usare la versione più recente di Storage Explorer. Per verificare la disponibilità di aggiornamenti, passare alla Guida>Per verificare la disponibilità di aggiornamenti.

2. Verificare che il motore del contenitore sia installato

Verificare che il motore del contenitore sia installato e funzionante nel tuo computer.

# If using Docker
docker --version

# If using Podman
podman --version

Se il motore non è in esecuzione, riavviare i servizi del motore del contenitore e riprovare.

3. Verificare i percorsi dei canali di comunicazione

A partire dalla versione 1.41.0, Storage Explorer deve comunicare con il motore di contenitori tramite pipe denominate (Windows) o socket di dominio Unix (Linux e macOS).

Per impostazione predefinita, Storage Explorer cerca i percorsi seguenti per questi canali di comunicazione:

Verificare la posizione dei motori di contenitori che si prevede di usare. Se non si trovano nelle posizioni predefinite, modificare l'impostazione Dei canali di comunicazione di Azurite (services.storageAccounts.containerSocketPaths) per includere i percorsi assoluti nelle posizioni corrette.

4. Impostazione di Snap per Linux

L'ambiente sandbox snap impedisce a Storage Explorer di accedere ai file di sistema. È possibile aggirare le limitazioni di snap aprendo un socket che inoltra le comunicazioni al motore del container usando socat:

1. Verificare la posizione del socket del motore del contenitore, ad esempio /var/run/docker.sock.
2. Creare un socket di inoltro in un percorso accessibile, ad esempio nella tua home directory:

socat UNIX-LISTEN:$HOME/docker.sock,fork UNIX-CONNECT:/var/run/docker.sock &

1. Avviare Storage Explorer.
2. Modificare l'impostazione Dei canali di comunicazione di Azurite in modo da includere il percorso assoluto del socket di inoltro (in questo caso, /home/<username>/docker.sock​).
3. Aggiornare il Emulators & Attached nodo.

Se si usa Docker, potrebbe anche essere necessario unirsi al docker gruppo.

sudo groupadd docker
sudo usermod -aG docker $USER

Dopo aver aggiunto l'utente al gruppo docker, riavvia il computer. Per altre informazioni, vedere La procedura di post-installazione di Linux per il motore Docker.

5. Verificare il contesto del motore di contenitori

Assicurarsi di usare il contesto corretto che gestisce i contenitori.

# If using Docker
docker context ls
docker context use <context name>

# If using Podman
podman context ls
podman context use <context name>

6. Controllare lo stato del contenitore Azurite

Verificare che i contenitori di Azurite siano in esecuzione. Assicurati che i contenitori di Azurite siano elencati e che il relativo stato sia Up. Avviare qualsiasi contenitore che non sia in esecuzione.

# If using Docker
docker container list --all

Assicurarsi che i contenitori di Azurite siano elencati e che il loro stato sia Up. Se un contenitore non è in esecuzione, è possibile avviarlo usando:

docker start <container name>

# If using Podman
podman container list --all
podman start <container name>

7. Verificare le porte di Azurite

Verificare che le configurazioni delle porte di accesso dei contenitori di Azurite siano corrette.

# If using Docker
docker inspect <container name>

# If using Podman
podman inspect <container name>

Cerca la sezione NetworkSettings.Ports nell'output per verificare le mappature delle porte. Ad esempio, supponiamo che l'endpoint blob di un contenitore Azurite sia configurato per l'ascolto sulla porta 10000 e che la sua porta sia mappata alla porta 10010 del computer host; si vedrebbe un'entrata simile alla seguente.

"10000/tcp": [
  {
    "HostIp": "0.0.0.0",
    "HostPort": "10010"
  }
]

8. Verificare che gli account personalizzati siano validi

Se si usano account personalizzati, assicurarsi che i nomi e le chiavi dell'account siano validi e configurati correttamente in Storage Explorer.

# If using Docker
docker exec <container name> printenv AZURITE_ACCOUNTS

# If using Podman
podman exec <container name> printenv AZURITE_ACCOUNTS

9. Controllare le impostazioni di rete

Assicurarsi che nessun problema di rete impedisca a Storage Explorer di connettersi al contenitore Azurite. Verificare che il firewall o il software antivirus non blocchi la connessione.

Riavviare il contenitore Azurite

Se il problema persiste, provare a riavviare il contenitore Azurite.

# If using Docker
docker restart <container name>

# If using Podman
podman restart <container name>

Ricreare il contenitore Azurite

Se nessuno dei passaggi precedenti risolve il problema, provare a ricreare il contenitore Azurite. Per esempio:

# If using Docker
docker stop <container name>
docker rm <container name>
docker run -d \
  --name <container-name> \
  -e AZURITE_ACCOUNTS="<custom account name>:<custom key>" \
  -p <blob-host-port>:10000 \
  -p <queue-host-port>:10001 \
  -p <table-host-port>:10002 \
  mcr.microsoft.com/azure-storage/azurite

# If using Podman
podman stop <container name>
podman rm <container name>
podman run -d \
  --name <container-name> \
  -e AZURITE_ACCOUNTS="<custom account name>:<custom key>" \
  -p <blob-host-port>:10000 \
  -p <queue-host-port>:10001 \
  -p <table-host-port>:10002 \
  mcr.microsoft.com/azure-storage/azurite

Storage Explorer non viene eseguito all'interno della sessione FSLogix

Se FSLogix gestisce il profilo utente, Storage Explorer potrebbe non essere in grado di eseguire a causa di un EEXIST errore. L'errore si verifica a causa di un problema noto con determinate versioni di FSLogix. Se si verifica l'errore, assicurarsi di usare la versione più recente di FSLogix. Se il problema persiste, è possibile risolverlo seguendo questa procedura:

1. Aprire la Console di Gestione Criteri di gruppo (gpmc.msc).

2. Creare o modificare un oggetto Criteri di gruppo (GPO) specifico per gli host di sessione AVD.

3. Vai a Configurazione del Computer>Preferenze>Impostazioni di Windows>Registro.

4. Aggiungere un nuovo elemento del Registro di sistema con le impostazioni seguenti:

   Action	Update
   Alveare	HKEY_LOCAL_MACHINE
   Percorso chiave	SYSTEM\CurrentControlSet\Services\frxdrvvt
   Nome del valore	FunzionalitàSupportate
   Tipo di valore	REG_DWORD
   Valore dei dati	11 (0xB)

5. Applicare il GPO e riavviare gli host di sessione.

Passaggi successivi

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

• Crea un ticket di supporto.

• 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