Průvodce odstraňováním potíží s Průzkumníkem služby Azure Storage

Průzkumník služby Azure Storage je samostatná aplikace, která usnadňuje práci s daty ve službě Azure Storage v operačních systémech Windows, macOS a Linux. Tato aplikace se může připojit k účtům úložiště hostovaným v Azure, národních cloudech nebo ve službě Azure Stack.

tato příručka shrnuje řešení problémů, které se běžně zobrazují v Průzkumník služby Storage.

Problémy s oprávněními Azure RBAC

Řízení přístupu na základě role Azure RBAC Azure umožňuje vysoce detailní správu přístupu prostředků Azure tím, že kombinuje sady oprávnění s rolemi. tady jsou některé strategie pro optimální fungování Azure RBAC v Průzkumník služby Storage.

Návody přistupovat k prostředkům v Průzkumník služby Storage?

Pokud máte problémy s přístupem k prostředkům úložiště prostřednictvím Azure RBAC, možná nebudete mít přiřazeny příslušné role. následující části popisují oprávnění Průzkumník služby Storage aktuálně vyžadují přístup k prostředkům úložiště. Pokud si nejste jistí, že máte příslušné role nebo oprávnění, obraťte se na správce účtu Azure.

problém s oprávněním pro čtení: List/Get Storage účtů

Musíte mít oprávnění k vypsání účtů úložiště. Chcete-li získat toto oprávnění, musíte být přiřazeni k roli Čtenář .

Výpis klíčů účtu úložiště

Průzkumník služby Storage můžou k ověřování požadavků používat taky klíče účtu. Přístup k klíčům účtu můžete získat pomocí výkonnějších rolí, jako je například role Přispěvatel .

Poznámka

Přístupové klíče udělují neomezená oprávnění komukoli, kdo je drží. Proto nedoporučujeme tyto klíče pro uživatele účtů vysílat. Pokud potřebujete odvolat přístupové klíče, můžete je znovu vygenerovat z Azure Portal.

Role dat

Musíte mít přiřazenou aspoň jednu roli, která uděluje přístup ke čtení dat z prostředků. pokud například chcete zobrazit nebo stáhnout objekty blob, budete potřebovat alespoň roli Storage blob Data Reader .

proč potřebuji roli vrstvy správy, aby se zobrazily moje prostředky v Průzkumník služby Storage?

Azure Storage má dvě vrstvy přístupu: správu a data. K předplatným a účtům úložiště se dostanete prostřednictvím vrstvy správy. K kontejnerům, objektům blob a dalším datovým prostředkům se dostanete přes datovou vrstvu. Pokud například chcete získat seznam účtů úložiště z Azure, odešlete žádost do koncového bodu správy. Pokud chcete v účtu vytvořit seznam kontejnerů objektů blob, odešlete požadavek na příslušný koncový bod služby.

Role Azure vám můžou udělit oprávnění pro správu nebo přístup k datové vrstvě. Role čtenář například uděluje přístup jen pro čtení k prostředkům vrstvy správy.

Výhradně řečeno, role čtenářů neposkytuje žádná oprávnění k datové vrstvě a není nutná pro přístup k datové vrstvě.

Průzkumník služby Storage usnadňuje přístup k prostředkům tím, že shromáždí potřebné informace pro připojení k prostředkům Azure. pokud například chcete zobrazit kontejnery objektů blob, Průzkumník služby Storage odešle požadavek na seznam kontejnerů do koncového bodu služby blob service. pokud chcete tento koncový bod získat, Průzkumník služby Storage prohledá seznam předplatných a účtů úložiště, ke kterým máte přístup. chcete-li najít vaše předplatná a účty úložiště, Průzkumník služby Storage také potřebovat přístup ke vrstvě správy.

pokud nemáte roli, která uděluje žádná oprávnění vrstvy správy, Průzkumník služby Storage nemůže získat informace potřebné pro připojení k datové vrstvě.

Co když mi nejde získat oprávnění pro vrstvu správy, které potřebuji od správce?

Pokud chcete získat přístup k kontejnerům objektů blob, ADLS Gen2 kontejnerů nebo adresářů nebo front, můžete k těmto prostředkům připojit pomocí svých přihlašovacích údajů Azure.

  1. otevřete dialog Připojení.
  2. Vyberte typ prostředku, ke kterému se chcete připojit.
  3. Vyberte Přihlásit se pomocí Azure Active Directory (Azure AD). Vyberte Další.
  4. Vyberte uživatelský účet a tenanta přidružený k prostředku, ke kterému se připojujete. Vyberte Další.
  5. Zadejte adresu URL prostředku a zadejte jedinečný zobrazovaný název pro připojení. vyberte další a potom Připojení.

U jiných typů prostředků momentálně nepoužíváme řešení související se službou Azure RBAC. Alternativním řešením je, že si můžete vyžádat adresu URL SAS a pak se připojit k prostředku pomocí následujících kroků:

  1. otevřete dialog Připojení.
  2. Vyberte typ prostředku, ke kterému se chcete připojit.
  3. Vyberte sdílený přístupový podpis (SAS). Vyberte Další.
  4. Zadejte adresu URL SAS, kterou jste dostali, a zadejte jedinečný zobrazovaný název pro připojení. vyberte další a potom Připojení.

Další informace o připojení k prostředkům najdete v tématu věnovaném připojení k individuálnímu prostředku.

k dispozici je několik předdefinovaných rolí Azure, které mohou poskytnout oprávnění potřebná k použití Průzkumník služby Storage. Některé z těchto rolí:

Poznámka

role přispěvatele účtu vlastník, přispěvatel a Storage udělují přístup k klíči účtu.

Problémy s certifikátem SSL

Porozumění problémům s certifikátem SSL

než budete pokračovat, ujistěte se, že jste si přečetli část certifikáty SSL v dokumentaci k síti Průzkumník služby Storage.

Použít systémový proxy server

Pokud používáte jenom funkce, které podporují nastavení proxy serveru , měli byste zkusit použít toto nastavení. Tadysi můžete přečíst další informace o nastavení systémových proxy serverů .

Import certifikátů SSL

pokud máte kopii certifikátů podepsaných svým držitelem, můžete Průzkumník služby Storage k jejich důvěřování pomocí následujících kroků:

  1. Získejte kopii certifikátu X. 509 (. cer) s kódováním Base-64.
  2. Přejít na Upravit > certifikáty SSL > Import certifikátů a potom pomocí nástroje pro výběr souborů vyhledejte, vyberte a otevřete soubor. cer.

K tomuto problému může dojít také v případě, že existuje více certifikátů (root a zprostředkující). Chcete-li tuto chybu opravit, je nutné naimportovat všechny certifikáty.

Hledání certifikátů SSL

Pokud nemáte kopii certifikátů podepsaných svým držitelem, požádejte o podporu svého správce IT.

Můžete zkusit najít tyto kroky:

  1. Nainstalujte OpenSSL.
    • Windows: všechny verze světla by měly být dostatečné.
    • Mac a Linux: měla by být součástí vašeho operačního systému.
  2. Spusťte OpenSSL.
    • Windows: otevřete instalační adresář, vyberte /bin/ a dvakrát klikněte na openssl.exe.
    • Mac a Linux: Spusťte openssl z terminálu.
  3. Spusťte tento příkaz: openssl s_client -showcerts -connect <hostname>:443 pro libovolný název hostitele Microsoft nebo Azure, na kterém jsou prostředky úložiště za sebou. seznam názvů hostitelů, ke kterým se často používá Průzkumník služby Storage najdete tady.
  4. Vyhledejte certifikáty podepsané svým držitelem. Pokud je předmět ("s:") a vydavatel ("i:") stejný, je certifikát pravděpodobně podepsaný svým svým podpisem.
  5. Po nalezení certifikátů podepsaných svým držitelem pro každý z nich zkopírujte a vložte vše z (a včetně) -----BEGIN CERTIFICATE----- do -----END CERTIFICATE----- nového souboru. cer.
  6. otevřete Průzkumník služby Storage a pokračujte v úpravách > certifikátů SSL > Import certifikátů. Pak pomocí nástroje pro výběr souborů vyhledejte, vyberte a otevřete soubory. CER, které jste vytvořili.

Zákaz ověřování certifikátu SSL

Pokud nemůžete najít žádné certifikáty podepsané svým držitelem pomocí následujících kroků, kontaktujte nás prostřednictvím nástroje pro zpětnou vazbu. můžete také otevřít Průzkumník služby Storage z příkazového řádku s --ignore-certificate-errors příznakem. Při otevření s tímto příznakem Průzkumník služby Storage chyby certifikátu. Tento příznak se nedoporučuje.

Problémy s přihlašováním

Principy přihlašování

Než budete pokračovat, ujistěte se, že jste si přečetli Průzkumník služby Storage dokumentaci.

Často se musí znovu zadat přihlašovací údaje.

Museli jste znovu zadat přihlašovací údaje, je pravděpodobně výsledkem zásad podmíněného přístupu nastavených AAD správcem. Když Průzkumník služby Storage požádáte o opětovné zadání přihlašovacích údajů z panelu účtu, měl by se zobrazit odkaz Podrobnosti o chybě. Klikněte na něj a podívejte se, Průzkumník služby Storage vás žádá o opětovné zadání přihlašovacích údajů. Chyby zásad podmíněného přístupu, které vyžadují opětovné zadání přihlašovacích údajů, mohou vypadat nějak takto:

  • Platnost tokenu aktualizace vypršela...
  • Vícefaktorové ověřování musíte použít pro přístup...
  • Z důvodu změny konfigurace provedené správcem...

Pokud chcete snížit četnost opětovného zadání přihlašovacích údajů kvůli chybám, jako jsou chyby uvedené výše, budete se muset obrátit na AAD správce.

Zásady podmíněného přístupu

Pokud máte zásady podmíněného přístupu, které musí být pro váš účet splněné, ujistěte se, že používáte hodnotu Výchozí webový prohlížeč pro nastavení Přihlásit se pomocí. Informace o tomto nastavení najdete v tématu Změna místa přihlášení.

Prohlížeč si během přihlašování stěžuje na přesměrování HTTP nebo nezabezpečené připojení.

Když Průzkumník služby Storage ve webovém prohlížeči provede přihlášení, na konci procesu přihlášení se provede přesměrování localhost na . V prohlížečích se někdy zobrazí upozornění nebo chyba, že se přesměrování provádí pomocí protokolu HTTP místo protokolu HTTPS. Některé prohlížeče se také mohou pokusit vynutit provedení přesměrování pomocí protokolu HTTPS. Pokud dojde k jedné z těchto možností, máte v závislosti na prohlížeči různé možnosti:

  • Upozornění ignorujte.
  • Přidejte výjimku pro localhost .
  • Zakažte vynucení HTTPS, buď globálně, nebo jenom pro localhost .

Pokud žádnou z těchto možností nemůžete provést, můžete také změnit místo přihlášení k integrovanému přihlášení, abyste se vyhnuli tomu, že budete prohlížeč používat úplně.

Token se nepokusí získat, tenant je vyfiltrovaný

Pokud se zobrazí chybová zpráva s oznámením, že token nelze získat, protože je tenant odfiltrovaný, znamená to, že se pokoušíte získat přístup k prostředku, který je v tenantovi, který jste vyfiltroval. Pokud chcete tenanta zrušit, přejděte na panel Účtů a ujistěte se, že je zaškrtnuté políčko pro tenanta určeného v chybě. Další informace o filtrování tenantů v azure najdete v tématu Správa účtů Průzkumník služby Storage.

Knihovně ověřování se nepodařilo správně spustit

Pokud se při spuštění zobrazí chybová zpráva s Průzkumník služby Storage, že se nepodařilo správně spustit knihovnu ověřování služby Průzkumník služby Storage, ujistěte se, že vaše instalační prostředí splňuje všechny požadavky. Nejpravděpodobnější příčinou této chybové zprávy je splnění požadavků.

Pokud se domníváte, že vaše instalační prostředí splňuje všechny požadavky, otevřete problémna GitHub . Při otevření problému nezapomeňte zahrnout:

  • Váš operační systém.
  • Jakou verzi Průzkumník služby Storage se pokoušíte použít?
  • Pokud jste zkontrolovali požadavky.
  • Protokoly ověřování z neúspěšného spuštění Průzkumník služby Storage. Podrobné protokolování ověřování se automaticky povolí, jakmile dojde k tomuto typu chyby.

Prázdné okno při použití integrovaného přihlašování

Pokud jste se rozhodli použít integrované přihlašování a zobrazí se prázdné přihlašovací okno, budete pravděpodobně muset přepnout na jinou metodu přihlašování. K prázdným přihlašovacím dialogům nejčastěji dochází, když server služby Active Directory Federation Services (AD FS) (ADFS) vyzve Průzkumník služby Storage k provedení přesměrování, které není společností Electron podporováno.

Pokud chcete změnit na jinou metodu přihlašování změnou nastavení Přihlásit se pomocí v Nastavení přihlášení k > > aplikaci. Informace o různých typech metod přihlašování najdete v tématu Změna místa přihlášení.

Smyčka opětovného ověření nebo změna název uživatele (UPN)

Pokud jste ve smyčce opětovného ověření nebo jste změnili hlavní název uživatele (UPN) jednoho z vašich účtů, vyzkoušejte tyto kroky:

  1. Otevřít Průzkumník služby Storage
  2. Přejděte do nápovědy k > resetování.
  3. Ujistěte se, že je zaškrtnuté alespoň políčko Ověřování. Můžete zrušit zaškrtnutí u ostatních položek, které nechcete resetovat.
  4. Klikněte na tlačítko Resetovat.
  5. Restartujte Průzkumník služby Storage a zkuste se znovu přihlásit.

Pokud po resetování stále dochází k problémům, zkuste následující kroky:

  1. Otevřít Průzkumník služby Storage
  2. Odeberte všechny účty a zavřete Průzkumník služby Storage.
  3. Odstraňte .IdentityService složku z počítače. V Windows se složka nachází v umístění C:\users\<username>\AppData\Local . Pro Mac a Linux najdete složku v kořenovém adresáři vašeho uživatelského adresáře.
  4. Pokud používáte Mac nebo Linux, budete také muset odstranit položku Microsoft.Developer.IdentityService z úložiště klíčů vašeho operačního systému. Na počítači Mac je úložištěm klíčů aplikace s klíčenovou klíčenovou klíčen. V Linuxu se aplikace obvykle nazývá Keyring, ale název se může lišit v závislosti na vaší distribuci.
  5. Restartujte Průzkumník služby Storage a zkuste se znovu přihlásit.

macOS: Chyby klíčenka nebo žádné přihlašovací okno

Klíčen pro macOS může někdy zadat stav, který způsobuje problémy s knihovnou Průzkumník služby Storage ověřování. Pokud chcete klíčku z tohoto stavu dostat, postupujte takto:

  1. Zavřete Průzkumník služby Storage.

  2. Otevřete keychain (stiskněte Command+Mezerník, zadejte keychain a stiskněte Enter).

  3. Vyberte "login" Keychain.

  4. Výběrem ikony zámku uzamknoute klíčník. (Po dokončení procesu se visací zámek zobrazí jako uzamčený. V závislosti na tom, jaké aplikace máte otevřené, může to trvat několik sekund.

    Ikona zámku

  5. Otevřete Průzkumníka služby Storage.

  6. Zobrazí se výzva se zprávou jako "Centrum služeb chce získat přístup ke klíčce". Zadejte heslo účtu správce Mac a vyberte Vždy povolit (nebo Povolit, pokud není k dispozici možnost Vždy povolit).

  7. Zkuste se přihlásit.

Výchozí prohlížeč se neotevře

Pokud se výchozí prohlížeč při pokusu o přihlášení neotevře, vyzkoušejte všechny následující techniky:

  • Restartování Průzkumník služby Storage
  • Před zahájením přihlášení ručně otevřete prohlížeč.
  • Zkuste použít integrované přihlašování . Pokyny k tomu, jak to provést, najdete v tématu Změna místa přihlášení.

Další problémy s přihlášením

Pokud se na váš problém s přihlášením nevztahuje žádná z výše uvedených možností nebo pokud se vám nepovede problém s přihlášením vyřešit, otevřete problém na GitHub.

Chybějící předplatná a nefunkční tenanti

Pokud po úspěšném přihlášení nemůžete načíst předplatná, vyzkoušejte následující metody řešení potíží:

  • Ověřte, že váš účet má přístup k předplatným, která očekáváte. Přístup můžete ověřit tak, že se přihlásíte k portálu pro prostředí Azure, které se pokoušíte použít.
  • Ujistěte se, že jste se přihlásili přes správné prostředí Azure (Azure, Azure China 21Vianet, Azure Germany, Azure US Government nebo Vlastní prostředí).
  • Pokud jste za serverem proxy server, ujistěte se, že jste správně nakonfigurovali Průzkumník služby Storage proxy serveru.
  • Zkuste účet odebrat a znovu přidat.
  • Pokud existuje odkaz Další informace nebo Podrobnosti o chybě, zkontrolujte, které chybové zprávy se hlásí u tenantů, kteří selhávají. Pokud si nejste jistí, jak na chybové zprávy reagovat, můžete otevřít problém v GitHub.

Není možné odebrat připojený účet úložiště nebo prostředek

Pokud nemůžete odebrat připojený účet nebo prostředek úložiště prostřednictvím uživatelského rozhraní, můžete ručně odstranit všechny připojené prostředky odstraněním následujících složek:

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

Poznámka

Před Průzkumník služby Storage složek zavřete okno.

Poznámka

Pokud jste někdy importoval nějaké certifikáty SSL, zálohujte obsah certs adresáře. Později můžete zálohu použít k opětovného importu certifikátů SSL.

Problémy s proxy serverem

Průzkumník služby Storage podporuje připojení k prostředkům Azure Storage prostřednictvím proxy server. Pokud se setkáte se všemi problémy, které se připojují k Azure prostřednictvím proxy serveru, tady je několik návrhů.

Poznámka

Průzkumník služby Storage podporuje jenom základní ověřování s proxy servery. Jiné metody ověřování, jako je například NTLM, nejsou podporovány.

Poznámka

Průzkumník služby Storage nepodporuje soubory automatické konfigurace proxy serveru pro konfiguraci nastavení proxy serveru.

ověření nastavení proxy serveru Průzkumník služby Storage

nastavení konfigurace proxy serveru → proxy serveru aplikace určuje, ze kterého zdrojového Průzkumník služby Storage získá konfiguraci Proxy serveru.

Pokud vyberete možnost použít proměnné prostředí, ujistěte se, že jste nastavili HTTPS_PROXY HTTP_PROXY proměnné prostředí nebo (proměnné prostředí rozlišují velká a malá písmena, proto nezapomeňte nastavit správné proměnné). pokud tyto proměnné nejsou definovány nebo jsou neplatné, Průzkumník služby Storage nepoužívají proxy server. po úpravě všech proměnných prostředí restartujte Průzkumník služby Storage.

Pokud vyberete možnost použít nastavení proxy serveru, ujistěte se, že je nastavení proxy v aplikaci správné.

Kroky pro diagnostiku problémů

Pokud stále dochází k problémům, zkuste tyto metody řešení potíží:

  1. pokud se můžete připojit k internetu bez použití proxy serveru, ověřte, že Průzkumník služby Storage funguje bez povoleného nastavení proxy serveru. pokud se Průzkumník služby Storage úspěšně připojí, může se jednat o problém s proxy server. Spolupracujte s vaším správcem a Identifikujte problémy.
  2. Ověřte, že další aplikace, které používají proxy server fungují podle očekávání.
  3. Ověřte, že se můžete připojit k portálu pro prostředí Azure, které se pokoušíte použít.
  4. Ověřte, že můžete přijímat odpovědi z koncových bodů služby. Do prohlížeče zadejte jednu z adres URL koncového bodu. Pokud se můžete připojit, měli byste obdržet InvalidQueryParameterValue odpověď XML nebo podobnou.
  5. ověřte, jestli se může připojit někdo jiný, který používá Průzkumník služby Storage se stejným proxy server. Pokud je to možné, možná budete muset kontaktovat správce proxy server.

Nástroje pro diagnostiku problémů

Síťový nástroj, například Fiddler, může pomáhat s diagnostikou problémů.

  1. Nakonfigurujte síťový nástroj jako proxy server běžící na místním hostiteli. Pokud budete chtít pokračovat v práci za aktuálním proxy serverem, bude pravděpodobně nutné nakonfigurovat síťový nástroj pro připojení prostřednictvím proxy serveru.
  2. Ověřte číslo portu používaného síťovým nástrojem.
  3. nakonfigurujte Průzkumník služby Storage nastavení proxy serveru tak, aby používal místního hostitele a číslo portu nástroje sítě (například localhost: 8888).

při správném nastavení nástroj sítě bude protokolovat požadavky sítě vytvořené Průzkumník služby Storage do koncových bodů správy a služby.

pokud se zdá, že váš síťový nástroj nevypadá jako protokolování Průzkumník služby Storage provozu, zkuste otestovat nástroj s jinou aplikací. Například zadejte adresu URL koncového bodu pro jeden ze svých prostředků úložiště (například https://contoso.blob.core.windows.net/ ) ve webovém prohlížeči a dostanete odpověď podobnou této:

Ukázka kódu

Odpověď naznačuje, že prostředek existuje, i když k němu nemáte přístup.

pokud síťový nástroj zobrazuje jenom provoz z jiných aplikací, budete možná muset upravit nastavení proxy serveru v Průzkumník služby Storage. V opačném případě je potřeba upravit nastavení nástroje.

Kontaktujte správce proxy server

Pokud je vaše nastavení proxy serveru správné, možná budete muset požádat správce proxy server, aby:

  • Ujistěte se, že proxy neblokuje provoz do koncových bodů prostředků nebo správy Azure.
  • Ověřte protokol ověřování používaný vaším proxy server. Průzkumník služby Storage podporuje jenom základní ověřovací protokoly. Průzkumník služby Storage nepodporuje proxy servery NTLM.

Chybová zpráva Nelze načíst podřízené položky.

Pokud jste připojení k Azure prostřednictvím proxy serveru, ověřte správnost nastavení proxy serveru.

Pokud vlastník předplatného nebo účtu udělil přístup k prostředku, ověřte, že máte oprávnění číst nebo zobrazit seznam pro daný prostředek.

Připojovací řetězec nemá kompletní konfigurační nastavení.

Pokud se zobrazí tato chybová zpráva, je možné, že nemáte potřebná oprávnění k získání klíčů pro váš účet úložiště. Pokud chcete potvrdit, že se jedná o tento případ, přejděte na portál a Najděte svůj účet úložiště. To můžete provést tak, že kliknete pravým tlačítkem na uzel svého účtu úložiště a vyberete otevřít na portálu. Pak přejděte do okna přístupové klíče . Pokud nemáte oprávnění k zobrazení klíčů, zobrazí se zpráva, že nemáte přístup. Pokud chcete tento problém obejít, můžete buď získat klíč účtu od někoho jiného a připojit se přes jméno a klíč, nebo můžete požádat někoho o SAS k účtu úložiště a použít ho k připojení účtu úložiště.

pokud se zobrazí klíče účtu, zapište problém v GitHub, abychom vám mohli problém vyřešit.

Došlo k chybě při přidávání nového připojení: TypeError: nejde číst vlastnost Version nedefinovaného.

Pokud se zobrazí tato chybová zpráva, když se pokusíte přidat vlastní připojení, může dojít k poškození dat připojení uložených v místním Správci přihlašovacích údajů. Pokud chcete tento problém obejít, zkuste odstranit vaše poškozená místní připojení a pak je znovu přidat:

  1. spusťte Průzkumník služby Storage. V nabídce přejděte na příkaz help > Toggle vývojářské nástroje.
  2. v otevřeném okně na kartě aplikace přejdete na místní Storage (levá strana) > file://.
  3. V závislosti na typu připojení, se kterým máte potíže, vyhledejte jeho klíč a zkopírujte jeho hodnotu do textového editoru. Hodnota je pole vlastních názvů připojení, například následující:
    • Účty úložiště
      • StorageExplorer_CustomConnections_Accounts_v1
    • Kontejnery objektů blob
      • StorageExplorer_CustomConnections_Blobs_v1
      • StorageExplorer_CustomConnections_Blobs_v2
    • Sdílené složky
      • StorageExplorer_CustomConnections_Files_v1
    • Fronty
      • StorageExplorer_CustomConnections_Queues_v1
    • Tabulky
      • StorageExplorer_CustomConnections_Tables_v1
  4. Po uložení aktuálních názvů připojení nastavte hodnotu v Vývojářské nástroje na [] .

Pokud chcete zachovat nepoškozená připojení, můžete pomocí následujících kroků vyhledat poškozená připojení. Pokud si nejste vědomi, že ztratíte všechna existující připojení, můžete tyto kroky přeskočit a podle pokynů pro konkrétní platformu vymazat data o připojení.

  1. V textovém editoru znovu přidejte název každého připojení do Vývojářské nástroje a potom zkontrolujte, zda připojení stále funguje.
  2. Pokud připojení funguje správně, není poškozeno a můžete ho bezpečně opustit. Pokud připojení nefunguje, odeberte jeho hodnotu z Vývojářské nástroje a zaznamenejte si ho, abyste ho mohli později přidat zpátky.
  3. Opakujte, dokud nezkontrolovali všechna připojení.

po prozatím všech připojeních, u všech názvů připojení, která nejsou přidaná zpět, je nutné vymazat poškozená data (pokud existují) a přidat je zpět pomocí standardních kroků v Průzkumník služby Storage:

  1. V nabídce Start vyhledejte Správce přihlašovacích údajů a otevřete ho.
  2. přejít na Windows přihlašovací údaje.
  3. V části Obecné přihlašovací údaje vyhledejte položky, které mají <connection_type_key>/<corrupted_connection_name> klíč (například StorageExplorer_CustomConnections_Accounts_v1/account1 ).
  4. Odstraňte tyto položky a přidejte připojení znovu.

pokud k této chybě dochází i po spuštění těchto kroků, nebo pokud chcete sdílet, co máte v případě poškození poškozená, otevřete problém na naší GitHub stránce.

Problémy s adresou URL SAS

Pokud se připojujete ke službě prostřednictvím adresy URL SAS a dochází k chybě:

  • Ověřte, že adresa URL poskytuje potřebná oprávnění ke čtení nebo vypsání prostředků.
  • Ověřte, že platnost adresy URL nevypršela.
  • Pokud je adresa URL SAS založená na zásadách přístupu, ověřte, že zásady přístupu nebyly odvolány.

Pokud omylem připojíte neplatnou adresu URL SAS a teď se nedá odpojit, postupujte podle těchto kroků:

  1. když spouštíte Průzkumník služby Storage, otevřete Vývojářské nástroje okně stisknutím klávesy F12.
  2. na kartě aplikace vyberte ve stromu vlevo možnost místní Storage > file:// .
  3. Vyhledejte klíč přidružený k typu služby problematického identifikátoru URI SAS. Pokud je například špatný identifikátor URI SAS pro kontejner objektů blob, vyhledejte klíč s názvem StorageExplorer_AddStorageServiceSAS_v1_blob .
  4. Hodnota klíče by měla být pole JSON. Najděte objekt přidružený k chybnému identifikátoru URI a odstraňte ho.
  5. stisknutím kombinace kláves Ctrl + R znovu načtěte Průzkumník služby Storage.

Závislosti Linux

Moduly snap

Průzkumník služby Storage 1.10.0 a novější je k dispozici jako modul snap z obchodu s modulem snap-in. modul snap-in Průzkumník služby Storage automaticky nainstaluje všechny závislosti a aktualizuje se, až bude k dispozici nová verze modulu snap-in. instalace modulu snap-in Průzkumník služby Storage je doporučovanou metodou instalace.

Průzkumník služby Storage vyžaduje použití správce hesel, ke kterému se možná budete muset ručně připojit, jinak bude Průzkumník služby Storage fungovat správně. pomocí následujícího příkazu se můžete připojit Průzkumník služby Storage k vašemu systému správce hesel.

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

Soubor. tar. gz

Aplikaci můžete také stáhnout jako soubor. tar. gz, ale budete muset nainstalovat závislosti ručně.

Průzkumník služby Storage, jak je uvedeno v souborech. tar. gz, jsou podporovány pouze v následujících verzích Ubuntu. Průzkumník služby Storage mohou fungovat i na dalších distribucích systému Linux, ale nejsou oficiálně podporovány.

  • Ubuntu 20,04 x64
  • Ubuntu 18,04 x64
  • Ubuntu 16,04 x64

Průzkumník služby Storage vyžaduje, aby byl v systému nainstalovaný .net Core 3,1.

Poznámka

Průzkumník služby Storage verze 1.8.0 prostřednictvím 1.20.1 vyžadují .net Core 2,1. Průzkumník služby Storage verze 1.7.0 a starší vyžadují .net Core 2,0.

  1. stáhněte soubor Průzkumník služby Storage. tar. gz.

  2. Instalace modulu runtime .NET Core:

    wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb; \
      sudo dpkg -i packages-microsoft-prod.deb; \
      sudo apt-get update; \
      sudo apt-get install -y apt-transport-https && \
      sudo apt-get update && \
      sudo apt-get install -y dotnet-runtime-3.1
    

mnoho knihoven potřebných v Průzkumník služby Storage přináší předinstalované standardní instalace Ubuntu v kanonickém stavu. Pro vlastní prostředí můžou chybět některé z těchto knihoven. pokud máte problémy se spouštěním Průzkumník služby Storage, doporučujeme, abyste se ujistili, že jsou v systému nainstalované následující balíčky:

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

oprava Průzkumník služby Storage pro novější verze .net Core

pro Průzkumník služby Storage 1.7.0 nebo starší možná budete muset opravit verzi rozhraní .net Core, kterou používá Průzkumník služby Storage:

  1. Stáhněte si 1.5.43 verze StreamJsonRpc z NuGet. Vyhledejte odkaz Stáhnout balíček na pravé straně stránky.
  2. Po stažení balíčku změňte jeho příponu z .nupkg na .zip .
  3. Rozbalíte balíček.
  4. Otevřete streamjsonrpc.1.5.43/lib/netstandard1.1/ složku.
  5. zkopírujte StreamJsonRpc.dll do následujících umístění ve složce Průzkumník služby Storage:
    • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
    • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

Možnost "otevřít v Průzkumníkovi" z Azure Portal nefunguje

Pokud tlačítko otevřít v Průzkumníkovi na Azure Portal nefunguje, ujistěte se, že používáte kompatibilní prohlížeč. Následující prohlížeče byly testovány na kompatibilitu:

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

Shromažďování protokolů

když nahlásíte problém GitHub, možná budete požádáni o shromáždění určitých protokolů, které vám pomůžou problém diagnostikovat.

protokoly Průzkumník služby Storage

počínaje verzí 1.16.0 Průzkumník služby Storage zaznamenává různé věci do vlastních aplikačních protokolů. K těmto protokolům se můžete snadno dostat kliknutím na Nápověda > otevřete adresář protokoly. ve výchozím nastavení Průzkumník služby Storage protokoly na nízké úrovni podrobností. Chcete-li změnit úroveň podrobností, přidejte proměnnou prostředí s názvem STG_EX_LOG_LEVEL a některou z následujících hodnot:

  • silent
  • critical
  • error
  • warning
  • info (výchozí úroveň)
  • verbose
  • debug

protokoly jsou rozdělené do složek pro každou relaci Průzkumník služby Storage, kterou spustíte. U jakýchkoli souborů protokolu, které potřebujete sdílet, je doporučujeme umístit je do archivu zip a soubory z různých relací v různých složkách.

Protokoly ověřování

pro problémy související s přihlašováním nebo knihovnou ověřování Průzkumník služby Storage pravděpodobně budete potřebovat shromažďovat protokoly ověřování. Protokoly ověřování jsou uloženy v:

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

Obecně platí, že ke shromáždění protokolů můžete použít následující postup:

  1. přejít na Nastavení (ikona ozubeného kolečka vlevo) > > přihlášení k aplikaci > kontrolu podrobného protokolování ověřování. pokud se Průzkumník služby Storage nedaří spustit z důvodu problému s knihovnou ověřování, bude to provedeno za vás.
  2. zavřete Průzkumník služby Storage.
  3. Volitelné/doporučené: Vymažte existující protokoly ze logs složky. Tím se sníží množství informací, které budete muset poslat nám.
  4. otevřete Průzkumník služby Storage a reprodukování problému.
  5. zavřít Průzkumník služby Storage
  6. Obsah logs složky zip

Protokoly AzCopy

Pokud máte potíže s přenosem dat, možná budete muset získat protokoly AzCopy. Protokoly AzCopy lze snadno najít pomocí dvou různých metod:

  • U neúspěšných přenosů stále v protokolu aktivit klikněte na přejít do souboru protokolu AzCopy.
  • V případě přenosů, které se v minulosti nezdařily, přejdete do složky AzCopy Logs. Tuto složku najdete na adrese:
    • Windows: C:\Users\<your username>\.azcopy
    • macOS a Linux ' ~/.AzCopy

Síťové protokoly

v případě některých problémů budete potřebovat poskytnout protokoly síťových volání prováděných Průzkumník služby Storage. v Windows to můžete provést pomocí Fiddler.

Poznámka

Trasování Fiddler můžou obsahovat hesla, která jste zadali nebo odeslali v prohlížeči během shromažďování trasování. Ujistěte se, že jste si přečetli pokyny k upravení Fiddler trasování. Nenahrávat Fiddler trasování do GitHub. Budete se dozvěděli, kde můžete bezpečně odeslat Fiddler trasování.

Část 1: instalace a konfigurace Fiddler

  1. Nainstalovat Fiddler
  2. Spustit Fiddler
  3. Přejít na nástroje > možnosti
  4. Klikněte na kartu HTTPS.
  5. Ujistěte se, že je zaškrtnuté políčko zachytit připojení a dešifrovat přenosy HTTPS.
  6. Klikněte na tlačítko akce.
  7. Zvolte "důvěryhodný kořenový certifikát" a pak "Ano" v dalším dialogovém okně
  8. Znovu klikněte na tlačítko akce.
  9. Výběr možnosti Exportovat kořenový certifikát do plochy
  10. Přejít na plochu
  11. Najít soubor FiddlerRoot. cer
  12. Dvakrát klikněte pro otevření.
  13. Přejít na kartu Podrobnosti
  14. Klikněte na tlačítko Kopírovat do souboru...
  15. V Průvodci exportem vyberte následující možnosti.
    • X. 509, kódovaný na bázi Base-64
    • Pro název souboru, Procházet... C:\Users\<your user dir>\AppData\Roaming\StorageExplorer\certsa pak ho můžete uložit jako libovolný název souboru.
  16. Zavřít okno certifikátu
  17. spustit Průzkumník služby Storage
  18. Přejít na Upravit > konfigurace proxy serveru
  19. V dialogovém okně vyberte použít nastavení proxy aplikací a nastavte adresu URL na http://localhost a port na 8888.
  20. Klikněte na OK.
  21. restartovat Průzkumník služby Storage
  22. Měli byste začít se zobrazením síťových volání z storageexplorer: procesu v Fiddler.

Část 2: reprodukce problému

  1. Zavřít všechny aplikace kromě Fiddler
  2. Vymažte ikonu protokolu Fiddler (X v levém horním rohu vedle nabídky zobrazení).
  3. volitelné/doporučené: nechte Fiddler sadu několik minut, pokud se zobrazí síťová volání, která nejsou Průzkumník služby Storage související, klikněte na ně pravým tlačítkem myši a vyberte ' filtrovat teď > ' skrýt (název procesu) '
  4. spustit Průzkumník služby Storage
  5. Reprodukujte problém.
  6. Klikněte na soubor > Uložit > všechny relace..., uložte si ho někam, Nezapomněli jste se
  7. zavřít Fiddler a Průzkumník služby Storage

Část 3: Úprava trasování Fiddler

  1. Dvakrát klikněte na trasování Fiddler (soubor. saz).
  2. Stisk ctrl+f
  3. V zobrazeném dialogovém okně se ujistěte, že jsou nastavené následující možnosti: Hledat = žádosti a odpovědi, zkontrolovat = hlavičky a texty.
  4. Vyhledejte všechna hesla, která jste použili při shromažďování trasování Fiddler, všechny zvýrazněné položky, klikněte pravým tlačítkem myši a vyberte možnost odebrat > vybrané relace.
  5. Pokud jste při shromažďování trasování v prohlížeči jednoznačně zadali hesla, ale při používání kombinace kláves Ctrl + f nenajdete žádné položky, nechcete měnit hesla nebo hesla, která jste použili, se používají pro jiné účty, takže stačí přeskočit odeslání souboru. saz. Lepší je bezpečné, než je líto. :)
  6. Uložte trasování znovu s novým názvem.
  7. Volitelné: odstraňte původní trasování.

Další kroky

Pokud žádná z těchto řešení nefunguje za vás, můžete:

  • Vytvoření lístku podpory
  • Otevřete problém v GitHub. můžete to udělat i tak, že v levém dolním rohu vyberete tlačítko GitHubte zprávu problém .

Váš názor