Felsökningsguide för Azure Storage Explorer

Microsoft Azure Storage Explorer är en fristående app som gör det enkelt att arbeta med Azure Storage-data i Windows, macOS och Linux. Appen kan anslutas till lagringskonton som finns i Azure, nationella moln och Azure Stack.

Den här guiden sammanfattar lösningar på problem som ofta förekommer i Storage Explorer.

Problem med Azure RBAC-behörigheter

Rollbaserad åtkomstkontroll i Azure RBAC möjliggör mycket detaljerad åtkomsthantering av Azure-resurser genom att kombinera uppsättningar med behörigheter i roller. Här är några strategier för att få Azure RBAC att fungera optimalt i Storage Explorer.

Hur gör jag för att åtkomst till mina resurser i Storage Explorer?

Om du har problem med att komma åt lagringsresurser via Azure RBAC kanske du inte har tilldelats lämpliga roller. I följande avsnitt beskrivs de behörigheter Storage Explorer för närvarande kräver för åtkomst till dina lagringsresurser. Kontakta din Azure-kontoadministratör om du inte är säker på att du har rätt roller eller behörigheter.

Problem med behörigheterna "Läsa: Visa/Storage/hämta konto(er)"

Du måste ha behörighet att lista lagringskonton. Du måste ha tilldelats rollen Läsare för att få den här behörigheten.

Lista lagringskontonycklar

Storage Explorer kan också använda kontonycklar för att autentisera begäranden. Du kan få åtkomst till kontonycklar via mer kraftfulla roller, till exempel rollen Deltagare.

Dataroller

Du måste tilldelas minst en roll som ger åtkomst till att läsa data från resurser. Om du till exempel vill visa eller ladda ned blobar behöver du minst rollen Storage Blob Data Reader.

Varför behöver jag en hanteringslagerroll för att se mina resurser i Storage Explorer?

Azure Storage har två åtkomstlager: hantering och data. Prenumerationer och lagringskonton nås via hanteringslagret. Containrar, blobar och andra dataresurser nås via datalagret. Om du till exempel vill hämta en lista över dina lagringskonton från Azure skickar du en begäran till hanteringsslutpunkten. Om du vill ha en lista över blobcontainrar i ett konto skickar du en begäran till lämplig tjänstslutpunkt.

Azure-roller kan ge dig behörighet för hanterings- eller datalageråtkomst. Rollen Läsare ger till exempel skrivskyddad åtkomst till resurser på hanteringslagret.

Strikt sett ger rollen Läsare inga behörigheter för datalager och är inte nödvändig för åtkomst till datalagret.

Storage Explorer gör det enkelt att komma åt dina resurser genom att samla in nödvändig information för att ansluta till dina Azure-resurser. Om du till exempel vill visa dina blobcontainrar Storage Explorer en begäran om att "lista containrar" till blobtjänstens slutpunkt. För att få den slutpunkten Storage Explorer i listan över prenumerationer och lagringskonton som du har åtkomst till. För att hitta dina prenumerationer och lagringskonton Storage Explorer också åtkomst till hanteringslagret.

Om du inte har en roll som beviljar behörigheter för hanteringslager kan Storage Explorer inte få den information som behövs för att ansluta till datalagret.

Vad händer om jag inte kan få de behörigheter för hanteringslagret som jag behöver från min administratör?

Om du vill komma åt blobcontainrar, ADLS Gen2 eller kataloger, eller köer, kan du ansluta till dessa resurser med dina autentiseringsuppgifter för Azure.

1. Öppna Anslut dialogrutan.
2. Välj den resurstyp som du vill ansluta till.
3. Välj Logga in med Azure Active Directory (Azure AD). Välj Nästa.
4. Välj det användarkonto och den klientorganisation som är associerad med den resurs som du kopplar till. Välj Nästa.
5. Ange URL:en till resursen och ange ett unikt visningsnamn för anslutningen. Välj Nästa och Anslut.

För andra resurstyper har vi för närvarande inte någon Azure RBAC-relaterad lösning. Som en tillfällig lösning kan du begära en SAS-URL och sedan ansluta till resursen genom att följa dessa steg:

1. Öppna Anslut dialogrutan.
2. Välj den resurstyp som du vill ansluta till.
3. Välj Signatur för delad åtkomst (SAS). Välj Nästa.
4. Ange DEN SAS-URL som du fick och ange ett unikt visningsnamn för anslutningen. Välj Nästa och Anslut.

Mer information om hur du kopplar till resurser finns i Koppla till en enskild resurs.

Rekommenderade inbyggda Roller i Azure

Det finns flera inbyggda Roller i Azure som kan ge de behörigheter som krävs för att använda Storage Explorer. Några av dessa roller är:

• Ägare:Hantera allt, inklusive åtkomst till resurser.
• Deltagare:Hantera allt, exklusive åtkomst till resurser.
• Läsare:Läsa och lista resurser.
• Storage kontodeltagare:Fullständig hantering av lagringskonton.
• Storage Blob Data-ägare:Fullständig åtkomst till Azure Storage blobcontainrar och data.
• Storage Blob Data-deltagare:Läsa, skriva och ta bort Azure Storage containrar och blobar.
• Storage Blob Data Reader:Läsa och lista Azure Storage containrar och blobar.

Problem med SSL-certifikat

Förstå problem med SSL-certifikat

Kontrollera att du har läst avsnittet SSL-certifikat i dokumentationen Storage Explorer om nätverk innan du fortsätter.

Använda systemproxy

Om du bara använder funktioner som stöder inställningen för systemproxy bör du försöka använda den inställningen. Du kan läsa mer om systemproxyinställningen här.

Importera SSL-certifikat

Om du har en kopia av de själv signerade certifikaten kan du instruera Storage Explorer lita på dem genom att följa dessa steg:

1. Hämta en Base-64-kodad X.509-kopia (.cer) av certifikatet.
2. Gå till Redigera SSL-certifikat Importera certifikat och använd > > sedan filväljaren för att hitta, välja och öppna CER-filen.

Det här problemet kan också inträffa om det finns flera certifikat (rot och mellanliggande). För att åtgärda det här felet måste alla certifikat importeras.

Hitta SSL-certifikat

Om du inte har en kopia av de själv signerade certifikaten kan du försöka kontakta IT-administratören för att få hjälp.

Du kan prova att följa dessa steg för att hitta dem:

1. Installera OpenSSL.
   • Windows:Vilken som helst av de ljusa versionerna bör vara tillräcklig.
   • Mac och Linux: Bör ingå i ditt operativsystem.
2. Kör OpenSSL.
   • Windows: Öppna installationskatalogen, välj /bin/ och dubbelklicka sedan på openssl.exe.
   • Mac och Linux: Kör openssl från en terminal.
3. Kör det här kommandot: openssl s_client -showcerts -connect <hostname>:443 , för alla Microsoft- eller Azure-värdnamn som dina lagringsresurser finns bakom. Du hittar en lista över värdnamn som används ofta av Storage Explorer här.
4. Leta efter självsignerade certifikat. Om ämne och ("s:") ("i:") utfärdare är samma, är certifikatet förmodligen själv signerat.
5. När du hittar de själv signerade certifikaten kopierar och klistrar du in allt från (och inklusive) till i -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- en ny .cer-fil för vart och ett.
6. Öppna Storage Explorer och gå till Redigera > SSL-certifikat > Importera certifikat. Använd sedan filväljaren för att hitta, markera och öppna de CER-filer som du skapade.

Inaktivera validering av SSL-certifikat

Om du inte hittar några själv signerade certifikat genom att följa dessa steg kan du kontakta oss via feedbackverktyget. Du kan också Storage Explorer från kommandoraden med --ignore-certificate-errors flaggan . När den öppnas med den här Storage Explorer ignorerar certifikatfel. Den här flaggan rekommenderas inte.

Inloggningsproblem

Förstå inloggning

Kontrollera att du har läst dokumentationen Logga in Storage Explorer innan du fortsätter.

Ofta måste du återentera autentiseringsuppgifter

Att behöva ange autentiseringsuppgifter igen beror troligen på principer för villkorlig åtkomst som angetts av AAD administratören. När Storage Explorer ber dig att återautentiseringsuppgifter från kontopanelen bör du se länken Felinformation.... Klicka på det för att se Storage Explorer du ber dig att återautentiseringsuppgifter. Fel med principer för villkorsstyrd åtkomst som kräver omkodning av autentiseringsuppgifter kan se ut ungefär så här:

• Uppdateringstoken har upphört att gälla...
• Du måste använda multifaktorautentisering för att komma åt...
• På grund av en konfigurationsändring som gjorts av administratören...

För att minska frekvensen för att behöva återautentiseringsuppgifter på grund av fel som de ovan, måste du prata med din AAD administratör.

Villkorliga åtkomstprinciper

Om du har principer för villkorlig åtkomst som måste uppfyllas för ditt konto kontrollerar du att du använder standardwebbläsaren för inställningen Logga in med. Information om den inställningen finns i Ändra var inloggning sker.

Webbläsaren klagar på HTTP-omdirigering eller osäker anslutning under inloggningen

När Storage Explorer utför inloggningen i webbläsaren görs en omdirigering till localhost i slutet av inloggningsprocessen. Webbläsare höjer ibland en varning eller ett fel om att omdirigeringen utförs med HTTP i stället för HTTPS. Vissa webbläsare kan också försöka tvinga omdirigeringen att utföras med HTTPS. Om något av dessa inträffar har du, beroende på din webbläsare, olika alternativ:

• Ignorera varningen.
• Lägg till ett undantag för localhost .
• Inaktivera tvinga HTTPS, antingen globalt eller bara för localhost .

Om du inte kan göra något av dessa alternativ kan du också ändra var inloggningen sker vid integrerad inloggning för att undvika att behöva använda webbläsaren helt och hållet.

Det går inte att hämta token, klientorganisationen filtreras bort

Om du ser ett felmeddelande om att en token inte kan förvärvas eftersom en klientorganisation är filtrerad innebär det att du försöker komma åt en resurs som finns i en klientorganisation som du har filtrerat bort. Om du vill avfiltrera klienten går du till kontopanelen och kontrollerar att kryssrutan för den klientorganisation som anges i felet är markerad. Se Hantera konton för mer information om hur du filtrerar klienter i Storage Explorer.

Autentiseringsbiblioteket kunde inte starta korrekt

Om du vid start ser ett felmeddelande om att Storage Explorer autentiseringsbiblioteketinte startade korrekt kontrollerar du att installationsmiljön uppfyller alla krav. Att inte uppfylla kraven är den troligaste orsaken till det här felmeddelandet.

Om du tror att din installationsmiljö uppfyller alla krav kan du öppna ett ärende GitHub. När du öppnar problemet ska du se till att inkludera:

• Ditt operativsystem.
• Vilken version Storage Explorer du försöker använda.
• Om du har kontrollerat förutsättningarna.
• Autentiseringsloggar från en misslyckad start Storage Explorer. Utförlig autentiseringsloggning aktiveras automatiskt när den här typen av fel inträffar.

Tomt fönster vid användning av integrerad inloggning

Om du har valt att använda integrerad inloggning och ser ett tomt fönster måste du förmodligen växla till en annan inloggningsmetod. Tomma dialogrutor för inloggning inträffar oftast när en Active Directory Federation Services (AD FS) (ADFS)-server uppmanar Storage Explorer att utföra en omdirigering som inte stöds av Electron.

Om du vill ändra till en annan inloggningsmetod genom att ändra inställningen Logga in med under Inställningar > > inloggningsprogram. Information om de olika typerna av inloggningsmetoder finns i Ändra var inloggning sker.

Omauthenticeringsloop eller UPN-ändring

Om du är i en omauthenticeringsloop eller har ändrat UPN för ett av dina konton kan du prova följande steg:

1. Öppna Storage Explorer
2. Gå till Hjälp > Återställning
3. Kontrollera att minst Autentisering är markerat. Du kan avmarkera andra objekt som du inte vill återställa.
4. Klicka på knappen Återställ
5. Starta Storage Explorer och försök att logga in igen.

Om du fortsätter att ha problem när du har återställt kan du prova följande steg:

1. Öppna Storage Explorer
2. Ta bort alla konton och stäng Storage Explorer.
3. Ta bort .IdentityService mappen från datorn. På Windows finns mappen på C:\users\<username>\AppData\Local . För Mac och Linux hittar du mappen i roten för användarkatalogen.
4. Om du kör Mac eller Linux måste du också ta bort posten Microsoft.Developer.IdentityService från operativsystemets nyckellager. På Mac är nyckelarkivet Programmet För nyckelring. I Linux kallas programmet vanligtvis nyckelring, men namnet kan variera beroende på din distribution.
5. Starta Storage Explorer och försök att logga in igen.

macOS: nyckelringsfel eller inget inloggningsfönster

MacOS-nyckelringen kan ibland ange ett tillstånd som orsakar problem för Storage Explorer autentiseringsbiblioteket. Följ dessa steg för att få nyckelringen ur det här tillståndet:

1. Stäng Storage Explorer.

2. Öppna nyckelringen (tryck på Kommando +blanksteg, skriv nyckelring och tryck på Retur).

3. Välj nyckelringen "logga in".

4. Välj hänglåsikonen för att låsa nyckelringen. (Hänglås visas låst när processen är klar. Det kan ta några sekunder, beroende på vilka appar du har öppen).

   

5. Öppna Storage Explorer.

6. Du uppmanas att ange ett meddelande som "Tjänsthubb vill komma åt nyckelringen". Ange lösenordet för ditt Mac-administratörskonto och välj Tillåt alltid (eller Tillåt om Tillåt alltid inte är tillgängligt).

7. Försök att logga in.

Standardwebbläsaren öppnas inte

Om standardwebbläsaren inte öppnas när du försöker logga in kan du prova alla följande metoder:

• Starta om Storage Explorer
• Öppna webbläsaren manuellt innan du startar inloggningen
• Prova att använda integrerad inloggning . Mer information om hur du gör detta finns i Ändra var inloggning sker.

Andra inloggningsproblem

Om inget av ovanstående gäller ditt inloggningsproblem eller om de inte kan lösa inloggningsproblemet öppnar du ett problem på GitHub.

Saknade prenumerationer och brutna klienter

Om du inte kan hämta dina prenumerationer när du har loggat in kan du prova följande felsökningsmetoder:

• Kontrollera att ditt konto har åtkomst till de prenumerationer som du förväntar dig. Du kan verifiera din åtkomst genom att logga in på portalen för den Azure-miljö som du försöker använda.
• Kontrollera att du har loggat in via rätt Azure-miljö (Azure, Azure China 21Vianet, Azure Tyskland, Azure US Government eller Anpassad miljö).
• Om du är bakom en proxyserver kontrollerar du att du har konfigurerat Storage Explorer proxyn korrekt.
• Försök att ta bort och lägga till kontot igen.
• Om det finns länken "Mer information" eller "Felinformation" kontrollerar du vilka felmeddelanden som rapporteras för klienterna som misslyckas. Om du inte vet hur du ska svara på felmeddelandena kan du öppna ett ärende i GitHub.

Det går inte att ta bort ett anslutet lagringskonto eller en resurs

Om du inte kan ta bort ett anslutet konto eller en lagringsresurs via användargränssnittet kan du manuellt ta bort alla anslutna resurser genom att ta bort följande mappar:

• Windows: %AppData%/StorageExplorer
• Macos: /Users/<your_name>/Library/Application Support/StorageExplorer
• Linux: ~/.config/StorageExplorer

Proxyproblem

Storage Explorer stöder anslutning till Azure Storage via en proxyserver. Här är några förslag om du får problem med att ansluta till Azure via proxy.

Kontrollera Storage Explorer proxyinställningar

Konfigurationsinställningen → Proxy → Proxy avgör vilken Storage Explorer hämtar proxykonfigurationen från.

Om du väljer "Använd miljövariabler" måste du ange miljövariablerna eller (miljövariablerna är fallkänsliga, så se till att ange HTTPS_PROXY HTTP_PROXY rätt variabler). Om dessa variabler är odefinierade eller ogiltiga Storage Explorer inte använda en proxyserver. Starta Storage Explorer när du har modifierat miljövariabler.

Om du väljer "Använd appproxyinställningar" kontrollerar du att proxyinställningarna i appen är korrekta.

Steg för att diagnostisera problem

Om du fortfarande har problem kan du prova följande felsökningsmetoder:

1. Om du kan ansluta till Internet utan att använda proxyservern kontrollerar du att Storage Explorer fungerar utan att proxyinställningarna är aktiverade. Om Storage Explorer ansluter korrekt kan det finnas ett problem med proxyservern. Ta hjälp av administratören för att identifiera problemen.
2. Kontrollera att andra program som använder proxyservern fungerar som förväntat.
3. Kontrollera att du kan ansluta till portalen för den Azure-miljö som du försöker använda.
4. Kontrollera att du kan ta emot svar från dina tjänstslutpunkter. Ange en av slutpunkts-URL:erna i webbläsaren. Om du kan ansluta bör du få ett eller InvalidQueryParameterValue liknande XML-svar.
5. Kontrollera om någon annan som Storage Explorer med samma proxyserver kan ansluta. Om de kan det kan du behöva kontakta proxyserveradministratören.

Verktyg för att diagnostisera problem

Ett nätverksverktyg, till exempel Fiddler, kan hjälpa dig att diagnostisera problem.

1. Konfigurera ditt nätverksverktyg som en proxyserver som körs på den lokala värden. Om du måste fortsätta arbeta bakom en faktisk proxy kan du behöva konfigurera ditt nätverksverktyg för att ansluta via proxyn.
2. Kontrollera det portnummer som används av ditt nätverksverktyg.
3. Konfigurera Storage Explorer proxyinställningar för att använda den lokala värden och nätverksverktygets portnummer (till exempel "localhost:8888").

När nätverksverktyget är korrekt inställt loggar det nätverksbegäranden som görs av Storage Explorer till hanterings- och tjänstslutpunkter.

Om ditt nätverksverktyg inte verkar logga in med Storage Explorer kan du prova att testa verktyget med ett annat program. Ange till exempel slutpunkts-URL:en för en av dina lagringsresurser (till exempel ) i en webbläsare så får du https://contoso.blob.core.windows.net/ ett svar som liknar följande:

Svaret antyder att resursen finns, även om du inte kan komma åt den.

Om ditt nätverksverktyg endast visar trafik från andra program kan du behöva justera proxyinställningarna i Storage Explorer. Annars behövde du justera inställningarna för verktyget.

Kontakta proxyserveradministratören

Om proxyinställningarna är korrekta kan du behöva kontakta proxyserveradministratören för att:

• Kontrollera att proxyn inte blockerar trafik till Azure-hanterings- eller resursslutpunkter.
• Kontrollera autentiseringsprotokollet som används av proxyservern. Storage Explorer stöder endast grundläggande autentiseringsprotokoll. Storage Explorer stöder inte NTLM-proxy.

Felmeddelandet "Det går inte att hämta underordnade" visas

Om du är ansluten till Azure via en proxyserver kontrollerar du att proxyinställningarna är korrekta.

Om ägaren av en prenumeration eller ett konto har gett dig åtkomst till en resurs kontrollerar du att du har läs- eller listbehörigheter för den resursen.

Anslutningssträngen har inte fullständiga konfigurationsinställningar

Om du får det här felmeddelandet är det möjligt att du inte har de behörigheter som krävs för att hämta nycklarna för ditt lagringskonto. Bekräfta att så är fallet genom att gå till portalen och leta upp ditt lagringskonto. Du kan göra detta genom att högerklicka på noden för ditt lagringskonto och välja Öppna i portalen. Gå sedan till bladet Åtkomstnycklar. Om du inte har behörighet att visa nycklar visas meddelandet "Du har inte åtkomst". Du kan lösa det här problemet genom att antingen hämta kontonyckeln från någon annan och ansluta via namn och nyckel, eller så kan du be någon om en SAS till lagringskontot och använda den för att ansluta lagringskontot.

Om du ser kontonycklarna kan du öppna ett GitHub så att vi kan hjälpa dig att lösa problemet.

Fel uppstod när ny anslutning skulle läggs till: TypeError: Det går inte att läsa egenskapen "version" för odefinierad

Om du får det här felmeddelandet när du försöker lägga till en anpassad anslutning kan anslutningsdata som lagras i den lokala hanteraren för autentiseringsuppgifter vara skadade. Du kan komma runt det här problemet genom att försöka ta bort de skadade lokala anslutningarna och sedan lägga till dem igen:

1. Starta Storage Explorer. Från menyn går du till Hjälp > Växla Utvecklarverktyg.
2. I fönstret som öppnas går du till Lokal Storage (vänster) på fliken Program > file://.
3. Beroende på vilken typ av anslutning du har problem med letar du upp dess nyckel och kopierar sedan dess värde till en textredigerare. Värdet är en matris med dina anpassade anslutningsnamn, som följande:
   • Lagringskonton
     • StorageExplorer_CustomConnections_Accounts_v1
   • Blobcontainrar
     • StorageExplorer_CustomConnections_Blobs_v1
     • StorageExplorer_CustomConnections_Blobs_v2
   • Filresurser
     • StorageExplorer_CustomConnections_Files_v1
   • Köer
     • StorageExplorer_CustomConnections_Queues_v1
   • Tabeller
     • StorageExplorer_CustomConnections_Tables_v1
4. När du har sparat dina aktuella anslutningsnamn anger du värdet i Utvecklarverktyg till [] .

Om du vill bevara de anslutningar som inte är skadade kan du använda följande steg för att hitta de skadade anslutningarna. Om du inte har något emot att förlora alla befintliga anslutningar kan du hoppa över de här stegen och följa de plattformsspecifika anvisningarna för att rensa dina anslutningsdata.

1. Från en textredigerare lägger du till varje anslutningsnamn i Utvecklarverktyg och kontrollerar sedan om anslutningen fortfarande fungerar.
2. Om en anslutning fungerar som den ska är den inte skadad och du kan lämna den där på ett säkert sätt. Om en anslutning inte fungerar tar du bort dess värde från Utvecklarverktyg och registrerar den så att du kan lägga till den igen senare.
3. Upprepa tills du har undersökt alla dina anslutningar.

När du har gått igenom alla anslutningar måste du rensa deras skadade data (om det finns några) för alla anslutningsnamn som inte har lagts till igen och sedan lägga till dem igen med hjälp av standardstegen i Storage Explorer:

Om du fortfarande stöter på det här felet när du har kört de här stegen, eller om du vill dela det du misstänker har skadat anslutningarna, öppnar du ett ärende på GitHub sidan.

Problem med SAS-URL

Om du ansluter till en tjänst via en SAS-URL och får ett fel:

• Kontrollera att URL:en innehåller de behörigheter som krävs för att läsa eller lista resurser.
• Kontrollera att URL:en inte har upphört att gälla.
• Om SAS-URL:en baseras på en åtkomstprincip kontrollerar du att åtkomstprincipen inte har återkallats.

Om du av misstag har kopplats med en ogiltig SAS-URL och nu inte kan koppla från följer du dessa steg:

1. När du kör en Storage Explorer trycker du på F12 för att öppna Utvecklarverktyg fönstret.
2. På fliken Program väljer du Lokal Storage > file:// i trädet till vänster.
3. Hitta nyckeln som är associerad med tjänsttypen för den problematiska SAS-URI:en. Om till exempel den dåliga SAS-URI:en är för en blobcontainer letar du efter nyckeln med namnet StorageExplorer_AddStorageServiceSAS_v1_blob .
4. Värdet för nyckeln ska vara en JSON-matris. Hitta objektet som är associerat med den dåliga URI:en och ta sedan bort det.
5. Tryck på Ctrl + R för att läsa Storage Explorer.

Linux-beroenden

Snapin

Storage Explorer 1.10.0 och senare är tillgänglig som en fäst från Snapin-butiken. Den Storage Explorer snapin-modulen installerar alla sina beroenden automatiskt och uppdateras när en ny version av snapin-modulen är tillgänglig. Att installera Storage Explorer snapin-modulen är den rekommenderade installationsmetoden.

Storage Explorer kräver användning av en lösenordshanterare, som du kan behöva ansluta manuellt innan Storage Explorer fungerar korrekt. Du kan Storage Explorer till systemets lösenordshanterare genom att köra följande kommando:

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

.tar.gz-fil

Du kan också ladda ned programmet som en .tar.gz-fil, men du måste installera beroenden manuellt.

Storage Explorer som anges i .tar.gz-nedladdningen stöds endast för följande versioner av Ubuntu. Storage Explorer kan fungera på andra Linux-distributioner, men de stöds inte officiellt.

• Ubuntu 20.04 x64
• Ubuntu 18.04 x64
• Ubuntu 16.04 x64

Storage Explorer kräver att .NET Core 3.1 är installerat på datorn.

Många bibliotek som behövs Storage Explorer finns förinstallerade med Canonicals standardinstallationer av Ubuntu. Vissa av de här biblioteken kanske saknas i anpassade miljöer. Om du har problem med Storage Explorer rekommenderar vi att du kontrollerar att följande paket är installerade på datorn:

• iproute2
• libaunda2
• libatm1
• libgconf2-4
• libnspr4
• libnss3
• libpulse0
• libsecret-1-0
• libx11-xcb1
• libxss1
• libxtables11
• libxtst6
• xdg-utils

Uppdatering Storage Explorer nyare versioner av .NET Core

För Storage Explorer 1.7.0 eller tidigare kan du behöva korrigera den version av .NET Core som används av Storage Explorer:

1. Ladda ned version 1.5.43 av StreamJsonRpc från NuGet. Leta efter länken "Download package" (Ladda ned paket) till höger på sidan.
2. När du har hämtat paketet ändrar du dess filnamnstillägg .nupkg från till .zip .
3. Packa upp paketet.
4. Öppna mappen streamjsonrpc.1.5.43/lib/netstandard1.1/.
5. Kopiera StreamJsonRpc.dll till följande platser i Storage Explorer mappen:
   • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
   • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

"Öppna i Utforskaren" Azure Portal inte fungerar

Om knappen Öppna i Utforskaren på Azure Portal inte fungerar kontrollerar du att du använder en kompatibel webbläsare. Följande webbläsare har testats för kompatibilitet:

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

Samla in loggar

När du rapporterar ett problem till GitHub kan du bli ombedd att samla in vissa loggar för att diagnostisera problemet.

Storage Explorer loggar

Från och med version 1.16.0 Storage Explorer olika saker i sina egna programloggar. Du kan enkelt komma åt loggarna genom att klicka på Hjälp > Öppna loggkatalog. Som standard Storage Explorer loggar på en låg nivå av verbositet. Om du vill ändra verbositetsnivån lägger du till en miljövariabel med namnet STG_EX_LOG_LEVEL och något av följande värden:

• silent
• critical
• error
• warning
• info (standardnivå)
• verbose
• debug

Loggar delas upp i mappar för varje session Storage Explorer som du kör. För de loggfiler som du behöver dela rekommenderar vi att du placerar dem i ett ZIP-arkiv med filer från olika sessioner i olika mappar.

Autentiseringsloggar

För problem som rör inloggning eller Storage Explorer autentiseringsbiblioteket behöver du troligen samla in autentiseringsloggar. Autentiseringsloggar lagras på:

• Windows: C:\Users\<your username>\AppData\Local\Temp\servicehub\logs
• macOS och Linux ~/.ServiceHub/logs

I allmänhet kan du följa dessa steg för att samla in loggarna:

1. Gå till Inställningar (kugghjulsikonen till vänster) > > Programinloggning > kontrollera Utförlig autentiseringsloggning. Om Storage Explorer inte kan starta på grund av ett problem med autentiseringsbiblioteket görs detta åt dig.
2. Stäng Storage Explorer.
3. Valfritt/rekommenderat: ta bort befintliga loggar från logs mappen. Detta minskar mängden information som du behöver skicka till oss.
4. Öppna Storage Explorer och återskapa problemet
5. Stäng Storage Explorer
6. Zippa innehållet i logs mappen.

AzCopy-loggar

Om du har problem med att överföra data kan du behöva hämta AzCopy-loggarna. AzCopy-loggar kan enkelt hittas via två olika metoder:

• För misslyckade överföringar som fortfarande finns i aktivitetsloggen klickar du på "Gå till AzCopy-loggfil"
• För tidigare misslyckade överföringar går du till mappen AzCopy logs. Den här mappen finns på:
  • Windows: C:\Users\<your username>\.azcopy
  • macOS och Linux '~/.azcopy

Nätverksloggar

För vissa problem måste du ange loggar för nätverkssamtalen som görs av Storage Explorer. På Windows kan du göra detta med hjälp av Fiddler.

Del 1: Installera och konfigurera Fiddler

1. Installera Fiddler
2. Starta Fiddler
3. Gå till Verktyg > alternativ
4. Klicka på fliken HTTPS
5. Kontrollera att Capture CONNECTs och dekryptera HTTPS-trafik är markerade
6. Klicka på knappen Åtgärder
7. Välj "Lita på rotcertifikat" och sedan "Ja" i nästa dialogruta
8. Klicka på knappen Åtgärder igen
9. Välj "Exportera rotcertifikat till skrivbordet"
10. Gå till skrivbordet
11. Hitta FiddlerRoot.cer-filen
12. Dubbelklicka för att öppna
13. Gå till fliken "Information"
14. Klicka på "Kopiera till fil..."
15. Välj följande alternativ i exportguiden
    • Base-64-kodad X.509
    • För filnamn, Bläddra... till C:\Users\<your user dir>\AppData\Roaming\StorageExplorer\certs och sedan kan du spara den som ett filnamn
16. Stäng certifikatfönstret
17. Starta Storage Explorer
18. Gå till Redigera > Konfigurera proxy
19. I dialogrutan väljer du "Använd appproxyinställningar" och anger URL:en till http://localhost och porten till 8888
20. Klicka på OK
21. Starta om Storage Explorer
22. Du bör börja se nätverkssamtal från en storageexplorer: process som visas i Fiddler

Del 2: Återskapa problemet

1. Stäng alla andra appar än Fiddler
2. Rensa Fiddler-loggen (X-ikonen längst upp till vänster, nära menyn Visa)
3. Valfritt/rekommenderat: Låt Fiddler ange i några minuter. Om du ser nätverkssamtal som inte är Storage Explorer-relaterade högerklickar du på dem och väljer Filtrera nu > Dölj (processnamn)"
4. Starta Storage Explorer
5. Återskapa problemet
6. Klicka på Arkiv > Spara > alla sessioner..., spara någonstans som du inte glömmer
7. Stäng Fiddler och Storage Explorer

Del 3: Sanera Fiddler-spårningen

1. Dubbelklicka på Fiddler-spårningen (.saz-fil)
2. Tryck ctrl+f
3. Kontrollera att följande alternativ är inställda i dialogrutan som visas: Search = Requests and responses (Sök = Begäranden och svar) Examine = Headers and bodies (Granska = rubriker och text)
4. Sök efter eventuella lösenord som du använde när du samlade in Fiddler-spårningen, alla poster som är markerade, högerklicka och välj Ta bort > valda sessioner
5. Om du definitivt har angett lösenord i webbläsaren när du samlar in spårningen men inte hittar några poster när du använder ctrl + f och du inte vill ändra dina lösenord/de lösenord som du använde används för andra konton kan du hoppa över att skicka .saz-filen till oss. Det är bättre att vara säker än att vara säker. :)
6. Spara spårningen igen med ett nytt namn
7. Valfritt: ta bort den ursprungliga spårningen

Nästa steg

Om ingen av dessa lösningar fungerar för dig kan du:

• Skapa ett supportärende
• Öppna ett ärende på GitHub. Du kan också göra detta genom att välja knappen GitHub i det nedre vänstra hörnet.