Azure Storage Explorer トラブルシューティングガイド

[アーティクル]
12/23/2024

Note

この記事は役に立ちましたか? あなたの入力は私たちにとって重要です。このページの Feedback ボタンを使用して、この記事がどれだけうまく機能したか、または改善方法をお知らせください。

Microsoft Azure Storage Explorer は、Windows、macOS、Linux での Azure Storage データの操作を容易にするスタンドアロンアプリです。このアプリは、Azure、各国のクラウド、および Azure Stack でホストされているストレージアカウントに接続できます。

このガイドでは、Storage Explorer で一般に確認されている問題の解決方法を紹介しています。

Azure RBAC のアクセス許可に関する問題

Azure ロールベースのアクセス制御 (Azure RBAC) では、一連のアクセス許可をロールに組み合わせることで、Azure リソースの高度に詳細なアクセス管理が可能になります。ここでは、Storage Explorer で Azure RBAC を最適に動作させる方法について説明します。

Storage Explorer で自分のリソースにアクセスするにはどうすればいいですか?

Azure RBAC を使用したストレージリソースへのアクセスに問題がある場合は、適切なロールが割り当てられていない可能性があります。次のセクションでは、ストレージリソースにアクセスするために Storage Explorer で現在必要なアクセス許可について説明します。適切なロールまたはアクセス許可があるかどうかが不明な場合は、Azure アカウント管理者に問い合わせてください。

"読み取り:ストレージアカウントの一覧表示/取得" アクセス許可の問題

ストレージアカウントを一覧表示するためのアクセス許可が必要です。このアクセス許可を取得するには、閲覧者ロールが割り当てられている必要があります。

ストレージアカウントキーの一覧表示

Storage Explorer では、アカウントキーを使用して要求を認証することもできます。共同作成者ロールなどのより強力なロールを使用してアカウントキーにアクセスすることができます。

Note

アクセスキーは、それらを保持するすべてのユーザーに無制限のアクセス許可を付与します。そのため、これらのキーをアカウントユーザーに渡すことはお勧めしません。アクセスキーを取り消す必要がある場合は、Azure portal で再生成できます。

データロール

リソースからデータを読み取るためのアクセス権を付与するロールが少なくとも 1 つ割り当てられている必要があります。たとえば、BLOB を一覧表示またはダウンロードする場合は、少なくともストレージ BLOB データ閲覧者ロールが必要です。

Storage Explorer でリソースを表示するには、管理レイヤーのロールが必要ですか?

Azure Storage には、管理とデータという 2 つのアクセスのレイヤーがあります。サブスクリプションとストレージアカウントには管理レイヤーを介してアクセスします。コンテナー、BLOB、およびその他のデータリソースには、データレイヤーを介してアクセスします。たとえば、Azure からストレージアカウントの一覧を取得する場合は、管理エンドポイントに要求を送信します。アカウント内の BLOB コンテナーの一覧が必要な場合は、適切なサービスエンドポイントに要求を送信します。

Azure ロールでは、管理レイヤーまたはデータレイヤーにアクセスするためのアクセス許可を与えることができます。たとえば、閲覧者ロールは、管理レイヤーリソースへの読み取り専用アクセス権を付与します。

厳密に言えば、閲覧者ロールは、データレイヤーのアクセス許可を提供せず、データレイヤーにアクセスするためには必要ありません。

Storage Explorer を使用すると、Azure リソースに接続するために必要な情報を収集することで、リソースに簡単にアクセスできます。たとえば、BLOB コンテナーを表示するために、Storage Explorer は BLOB サービスエンドポイントに "コンテナーの一覧表示" 要求を送信します。そのエンドポイントを取得するために、Storage Explorer は、アクセスできるサブスクリプションとストレージアカウントの一覧を検索します。サブスクリプションとストレージアカウントを検索するには、Storage Explorer は管理レイヤーにもアクセスする必要があります。

管理レイヤー権限のあるロールがないと、Storage Explorer で、データレイヤーへの接続に必要な情報が取得できません。

管理者から管理レイヤーのアクセス許可を取得できない場合、どうすればいいですか?

BLOB コンテナー、Azure Data Lake Storage Gen2 のコンテナーやディレクトリ、キューにアクセスしたい場合は、Azure の認証情報を使ってそれらのリソースにアタッチできます。

[ Connect ダイアログボックスを開きます。
接続先のリソースの種類を選択します。
Microsoft Entra ID >Next を使用して署名を選択します。
アタッチするリソースに関連付けられているユーザーアカウントとテナントを選択し、 Next を選択します。
リソースの URL を入力し、接続の一意の表示名を入力します。 Next>Connect を選択します。

現時点では、他のリソースの種類に対する Azure RBAC 関連のソリューションはありません。回避策として、Shared Access Signature URL を要求し、それをリソースにアタッチできます。

[ Connect ダイアログボックスを開きます。
接続先のリソースの種類を選択します。
[ 共有アクセス署名 (SAS)>Next を選択します。
受信した Shared Access Signature URL を入力し、接続の一意の表示名を入力します。 Next>Connect を選択します。

リソースへのアタッチの詳細は、個々のリソースにアタッチするを参照してください。

推奨される Azure 組み込みロール

いくつかの Azure 組み込みロールは、Storage Explorer を使用するために必要なアクセス許可を提供できます。そうしたロールの一部を以下に示します。

所有者:リソースへのアクセスを含め、すべてを管理します。
共同作成者:リソースへのアクセスを除き、すべてを管理します。
閲覧者:リソースを読み取って一覧表示します。
ストレージアカウント共同作業者: ストレージアカウントの完全な管理。
ストレージ BLOB データ所有者:Azure Storage の BLOB コンテナーおよびデータに対するフルアクセス。
ストレージ BLOB データ共同作成者:Azure Storage コンテナーと BLOB の読み取り、書き込み、削除を行います。
ストレージ BLOB データ閲覧者:Azure Storage コンテナーと BLOB の読み取りと一覧表示を行います。

Note

アカウントキーへのアクセスは、所有者、共同作成者、ストレージアカウント共同作成者の各ロールによって許可されます。

SSL 証明書の問題

このセクションでは、SSL 証明書の問題について説明します。

SSL 証明書の問題を把握する

先に進む前に、Storage Explorer のネットワークに関するドキュメントSSL 証明書セクションを参照してください。

システムプロキシを使用する

システムプロキシを使用する設定をサポートする機能のみを使用している場合は、その設定を使用してみてください。 システムプロキシ設定の詳細は、Microsoft Azure Storage Explorer でのネットワーク接続を参照してください。

SSL 証明書をインポートする

自己署名証明書のコピーがある場合は、次の手順に従って、それを信頼するように Storage Explorer に指示できます。

Base-64 でエンコードされた X.509 (.cer) 証明書のコピーを取得します。
[編集]>[SSL Certificates (SSL 証明書)]>[Import Certificates (証明書のインポート)] の順に移動します。次に、ファイルピッカーを使用して、作成した .cer ファイルを検索、選択して開きます。

この問題は、複数の証明書 (ルートと中間) がある場合にも発生することがあります。このエラーを解決するには、すべての認定資格証をインポートする必要があります。

SSL 証明書の検索

自己署名認定資格証のコピーをお持ちでない場合は、IT 管理者に問い合わせてください。

次の手順に従って、検索します。

OpenSSL をインストールします。
- Windows:任意の Light バージョンで十分です。
- Mac: OpenSSL は、オペレーティングシステムに含まれます。
- Linux: OpenSSL は、オペレーティングシステムに含まれます。
OpenSSL を実行します。
- Windows: インストールディレクトリを開き、 /bin/ を選択し、openssl.exeをダブルクリックします。
- Mac: ターミナルから openssl を実行します。
- Linux: ターミナルから openssl を実行します。
ストレージリソースが背後にある Microsoft または Azure ホスト名に対して、openssl s_client -showcerts -connect <hostname>:443 コマンドを実行します。詳細は、Storage Explorer で頻繁にアクセスされるホスト名のリストを参照してください。
自己署名証明書を検索します。サブジェクト ("s:") と発行者 ("i:") が同じである場合、まず間違いなく証明書は自己署名されています。
自己署名証明書が見つかると、それぞれに対して、 -----BEGIN CERTIFICATE----- から -----END CERTIFICATE----- まですべてをコピーして、新しい.cer ファイルに貼り付けます。
Storage Explorer を開いて、 [編集]>[SSL 証明書]>[証明書のインポート] の順に移動します。次に、ファイルピッカーを使用して、作成した .cer ファイルを検索し、選択して開きます。

SSL 証明書検証の無効化

この手順で自己署名証明書が見つからない場合は、フィードバックツールを使用して Microsoft にご連絡ください。また、--ignore-certificate-errors フラグを使用して、コマンドラインから Storage Explorer を開くこともできます。このフラグを指定して開くと、Storage Explorer は証明書のエラーを無視します。 このフラグは推奨されません。

このセクションでは、発生する可能性があるサインイン情報の問題について説明します。

先に進む前に、Storage Explorer へのサインインのドキュメントを参照してください。

資格情報を頻繁に再入力する必要がある

資格情報を再入力する必要があることは、ほとんどの場合、Microsoft Entra 管理者によって設定された条件付きアクセスポリシーの結果です。Storage Explorer からアカウントパネルから資格情報の再入力を求められた場合は、 エラーの詳細 リンクが表示されます。これを選択すると、Storage Explorer によって資格情報の再入力が求められている理由が表示されます。資格情報の再入力が必要となる条件付きアクセスポリシーのエラーは、次のような内容です。

更新トークンの有効期限が切れている。
多要素認証を使用してアクセスする必要がある。
管理者が構成を変更した。

上記のようなエラーが原因で資格情報を再入力する頻度を減らすには、Microsoft Entra 管理者にお問い合わせください。

条件付きアクセスポリシー

アカウントで満たす必要がある条件付きアクセスポリシーがある場合は、[Sign in with (サインイン方法の選択)] 設定の値に [Default Web Browser (既定の Web ブラウザー)] を使用していることを確認してください。この設定の詳細は、サインインする場所の変更を参照してください。

Storage Explorer が Web ブラウザーでサインインを実行すると、サインインプロセスの最後に localhost へのリダイレクトが行われます。場合によっては、ブラウザーで、HTTPS ではなく HTTP でリダイレクトが実行されていることを示す警告またはエラーが発生する場合があります。また、HTTPS でのリダイレクトを強制的に実行しようとするブラウザーもあります。これらの問題のいずれかが発生した場合は、ブラウザーに応じて、次のオプションがあります。

警告を無視します。
localhost の例外を追加します。
グローバルに、または localhost の場合のみ、強制的に HTTPS を無効にします。

これらのオプションのいずれもできない場合は、サインインする場所の変更を行い、統合されたサインインにより、ブラウザーの使用を完全に回避できます。

トークンを取得できず、テナントがフィルターで除外されている

場合によっては、テナントがフィルター処理されているため、トークンを取得できないというエラーメッセージが表示されることがあります。これは、フィルター処理されたテナントにあるリソースにアクセスしようとしていることを意味します。テナントを含めるには、[アカウント] パネルに移動します。エラーで指定されたテナントのチェックボックスがオンになっていることを確認します。 Storage Explorer でのテナントのフィルター処理の詳細は、アカウントの管理ページを参照してください。

認証ライブラリを正常に開始できない

起動時に、Storage Explorer の認証ライブラリが正常に起動できなかったことを示すエラーメッセージが表示された場合は、インストール環境がすべての前提条件を満たしていることを確認。このエラーメッセージの原因としては、前提条件が満たされていないことが考えられます。

インストール環境ですべての前提条件が満たされていると思われる場合は、GitHub で問題を開きます。イシューを開いたら、次のものが含まれていることを確認します。

ご使用の OS。
使用を試みている Storage Explorer のバージョン。
前提条件を確認したかどうか。
Storage Explorer の起動に失敗したときの認証ログ。この種類のエラーが発生すると、詳細な認証ログが自動的に有効になります。

Integrated Sign-inを使用することを選択した場合に、空白のサインインウィンドウが表示される場合は、別のサインイン方法に切り替える必要がある可能性があります。空白のサインインダイアログボックスが表示されるのは、多くの場合、Active Directory フェデレーションサービス (AD FS) サーバーで、Storage Explorer に対してリダイレクトを実行するように指示した場合です。これは、Electron ではサポートされていません。

別のサインイン方法に変更するには、[設定]>[アプリケーション]>[サインイン] の [Sign in with (サインイン方法の選択)] 設定を変更します。さまざまな種類のサインイン方法の詳細については、サインインする場所の変更に関するページを参照してください。

再認証ループまたは UPN の変更

再認証ループに入っているか、いずれかのアカウントの UPN を変更した場合は、次の手順を実行してみてください。

ストレージエクスプローラーを開きます。
[Help (ヘルプ)]>[Reset (リセット)] に移動します。
少なくとも [認証] をチェックしてください。リセットしないその他の項目をクリアします。
[リセット] を選択します。
Storage Explorer を再起動して、もう一度サインインしてみてください。

リセット後も問題が解決しない場合は、次の手順を試してください。

ストレージエクスプローラーを開きます。
すべてのアカウントを削除した後、Storage Explorer を閉じます。
コンピューターから .IdentityService フォルダーを削除します。 Windows では、フォルダーはC:\users\<ユーザー名>\AppData\Localにあります。 Mac と Linux では、このフォルダーは、ユーザーディレクトリのルートで見つけることができます。
Mac または Linux を実行している場合は、オペレーティングシステムのキーストアから Microsoft.Developer.IdentityService エントリも削除する必要があります。 Mac では、キーストアは Gnome Keychain アプリケーションです。 Linux では、このアプリケーションは通常は Keyring という名前ですが、お使いのディストリビューションによっては名前が違うことがあります。
Storage Explorer を再起動して、もう一度サインインしてみてください。

macOS のキーチェーンは、Storage Explorer 認証ライブラリの問題を引き起こす状態になることがあります。この状態からキーチェーンを取得するには、次の手順に従います。

Storage Explorer を閉じます。
Command + Spacebar を選択してキーチェーンを開き、「keychain」と入力し、Enter を選択します。
login キーチェーンを選択します。
南京錠を選択してキーチェーンをロックします。プロセスが完了すると、南京錠がロックされた表示に変わります。開いているアプリによっては、数秒かかることがあります。
ストレージエクスプローラーを開きます。
"サービスハブがキーチェーンにアクセスする必要があります" などのメッセージが表示されます。Mac 管理者アカウントのパスワードを入力し、[ Always Allow を選択します。または、[Always Allow (常に許可)] が使用できない場合は [Allow (許可)] を選択します。
サインインを試します。

Linux: 起動時にアプリケーションウインドウまたはパスワードマネージャーエラーが発生しない

Linux システムで Storage Explorer を起動すると、次のいずれかの問題が発生する可能性があります。

アプリケーションウィンドウは表示されません。
システムのパスワードマネージャーに関するエラーが発生します。

Storage Explorer では、サインイン資格情報や SAS 接続など、システムの資格情報マネージャーを使用してデータを保護します。互換性のある資格情報マネージャーアプリケーションが検出されない場合、Storage Explorer は起動しません。システムにローカル資格情報管理ツールがインストールされていない場合は、 libsecretと互換性のあるサードパーティ製のツールをインストールします。たとえば、GNOME デスクトップ環境を使用する Linux システムでは、 Seaホースをインストールできます。

Storage Explorer は、通常、起動時に存在しない場合に既定のキーリングを作成します。ただし、場合によっては、これが発生せず、アプリケーションウィンドウまたはパスワードマネージャーサービスエラーが発生しないことがあります。問題を解決するには、既定のキーリングを手動で設定します。

シーホースを使用していて、既存のキーリングがない場合、または新しいキーリングを作成する場合は、次の手順に従って既定のキーリングを作成します。

"パスワードとキー" アプリケーションを起動します。
[+] ボタンを選択し、 Password キーリングを選択します。
新しいキーリングの名前とパスワードを設定します。
新しいキーリングを右クリックし、[ 既定として設定] を選択。

Storage Explorer スナップを使用する場合は、Storage Explorer がシステムのパスワードマネージャーに接続されていることを確認する必要もあります。そのためには、次のコマンドを実行します。

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

既定のブラウザーが開かない

サインインしようとしたときに既定のブラウザーが開かない場合は、次のすべての方法を試してください。

Storage Explorer を再起動します。
サインインを開始する前に、ブラウザーを手動で開きます。
統合サインインを使用してみてください。手順には、サインインする場所の変更を参照してください。

発生しているサインインの問題が上記のいずれも当てはまらない場合、またはサインインの問題の解決に失敗した場合は、GitHub で問題を開きます。

サブスクリプションの欠落とテナントの破損

サインインに成功した後もサブスクリプションを取得できない場合は、次のトラブルシューティング方法を試してください。

お使いのアカウントに必要なサブスクリプションへのアクセス権があることを確認します。使用しようとしている Azure 環境のポータルにサインインすることによって、アクセス権を確認できます。
適切な Azure 環境 (Azure、Azure China 21Vianet、Azure Germany、Azure US Government、またはカスタム環境) を使用してサインインしていることを確認します。
プロキシサーバーの背後にいる場合は、Storage Explorer プロキシを正しく構成していることを確認します。
アカウントを削除してから追加し直します。
[詳細] または [エラーの詳細] リンクがある場合は、障害が発生しているテナントに対してどのエラーメッセージが報告されているかを確認します。エラーメッセージへの対処方法がわからない場合は、GitHub で問題を開いてください。

AzCopy 転送中の OS Credential Store との通信に関する問題

Windows でこのメッセージが表示される場合は、Windows 資格情報マネージャーがいっぱいである可能性が最も高くなります。 Windows 資格情報マネージャーに余裕を持たせるために、次の手順に従います。

Storage Explorer を閉じます。
[スタート] メニューで [資格情報マネージャー] を検索して開きます。
[Windows 資格情報] に移動します。
[Generic Credentials (汎用資格情報)]で、使用していないプログラムに関連付けられたエントリを探して削除します。また、azcopy/aadtoken/<some number> のようなエントリを探し、それらのエントリを削除することもできます。

上記の手順を完了した後もメッセージが引き続き表示される場合、または Windows 以外のプラットフォームでこのメッセージが表示される場合は、GitHub でイシューを開くことができます。

アタッチされているストレージアカウントまたはリソースを削除できない

アタッチされているアカウントまたはストレージのリソースを UI 経由で削除できない場合は、次のフォルダーを削除することにより、接続されているすべてのリソースを手動で削除できます。

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

これらのフォルダーを削除する前に、Storage Explorer を閉じます。

Note

今までに SSL 証明書をインポートしたことがある場合は、certs ディレクトリの内容をバックアップします。後でバックアップを使用して、SSL 証明書を再インポートすることができます。

プロキシの問題

Storage Explorer では、プロキシサーバーを経由した Azure Storage リソースへの接続がサポートされています。プロキシを経由して Azure に接続する際に問題が発生した場合、推奨事項を以下に示します。

Storage Explorer では、プロキシサーバーでの基本認証のみがサポートされています。 NTLM などの他の認証方法はサポートされていません。

Note

Storage Explorer は、プロキシ設定を構成するためのプロキシ自動構成ファイルをサポートしていません。

Storage Explorer のプロキシ設定を確認する

[アプリケーション]>[プロキシ]>[Proxy configuration (プロキシ構成)] 設定では、Storage Explorer によってどのソースからプロキシ構成を取得するかを決定します。

[環境変数を使用する] を選択した場合は、HTTPS_PROXY または HTTP_PROXY の環境変数を設定してください。環境変数は大文字と小文字が区別されるので、必ず正しい変数を設定してください。これらの変数が定義されていないか無効である場合、プロキシは Storage Explorer で使用されません。環境変数を変更したら、Storage Explorer を再起動します。

[Use app proxy settings (アプリのプロキシ設定を使用する)] を選択する場合は、アプリ内プロキシ設定が正しいことを確認します。

問題を診断するための手順

引き続き問題が発生する場合は、次のトラブルシューティング方法をお試しください。

プロキシを使用せずにインターネットに接続できる場合は、プロキシの設定を有効にしなくても Storage Explorer が動作することを確認します。 Storage Explorer が正常に接続されている場合は、ご利用のプロキシサーバーに問題がある可能性があります。管理者と連携して問題を特定してください。
プロキシサーバーを使用する他のアプリケーションが想定どおりに動作することを確認します。
使用しようとしている Azure 環境のポータルに接続できることを確認します。
サービスエンドポイントからの応答を受信できるか確認します。ブラウザーに、エンドポイント URL のいずれかを入力します。接続できる場合は、 InvalidQueryParameterValue または同様の XML 応答を受け取る必要があります。
同じプロキシサーバーで Storage Explorer を使用している他の誰かが接続できるかどうかを確認します。可能であれば、プロキシサーバー管理者に連絡してください。

問題診断ツール

Fiddler などのネットワークツールを使用すると、問題の診断が容易になります。

ネットワークツールを、ローカルホスト上で実行されるプロキシサーバーとして構成します。実際のプロキシの背後で作業を続けなければならない場合は、プロキシ経由で接続するようにネットワークツールを設定する必要があるかもしれません。
ネットワークツールで使用されるポート番号を確認します。
ローカルホストとネットワークツールのポート番号 ( localhost:8888 など) を使用するように Storage Explorer プロキシ設定を構成します。

正しく設定すると、ネットワークツールは Storage Explorer によって行われたネットワーク要求を管理エンドポイントとサービスエンドポイントに記録します。

ネットワークツールによって Storage Explorer のトラフィックがログされていないようである場合は、そのツールを別のアプリケーションでテストしてみてください。たとえば、Web ブラウザーの https://contoso.blob.core.windows.net/ など、いずれかのストレージリソースのエンドポイント URL を入力します。次のコードサンプルのような応答を受け取ります。

<?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>

リソースにアクセスできなくても、この応答があれば、それが存在することになります。

ネットワークツールに他のアプリケーションからのトラフィックしか表示されない場合、Storage Explorer のプロキシ設定の調整が必要なことがあります。それ以外の場合は、ツール設定の調整が必要なことがあります。

プロキシサーバー管理者に問い合わせる

プロキシの設定が正しい場合は、プロキシサーバー管理者に連絡して次を行う必要があります。

プロキシによって Azure の管理エンドポイントまたはリソースエンドポイントへのトラフィックがブロックされていないことを確認します。
プロキシサーバーで使用されている認証プロトコルを確認します。 Storage Explorer では、基本認証プロトコルのみがサポートされます。 Storage Explorer で NTLM プロキシはサポートされていません。

"子を取得できません" エラーメッセージ

プロキシ経由で Azure に接続されている場合は、プロキシ設定が正しいことを確認します。

サブスクリプションまたはアカウントの所有者からリソースへのアクセス権が付与されている場合は、そのリソースに対する読み取りまたは一覧表示のアクセス許可があることを確認します。

接続文字列に完全な構成設定が含まれていない

このエラーメッセージが表示された場合は、ストレージアカウントのキーを取得するために必要なアクセス許可を持っていない可能性があります。確認するには、ポータルにアクセスして、自分のストレージアカウントを見つけます。ストレージアカウントのノードを右クリックし、[Open in Portal (ポータルで開く)] を選択します。次に、[アクセスキー] ウィンドウに移動します。キーを表示するアクセス許可がない場合は、"アクセス権がありません" というメッセージが表示されます。この問題を回避するには、アカウント名とキー、まはアカウントの共有アクセス署名を入手し、それを使用してストレージアカウントを接続します。

アカウントキーが表示される場合は、問題の解決に役立てることができるように、GitHub で問題を報告してください。

「新しい接続の追加中にエラーが発生しました: TypeError: 未定義のプロパティ「version」を読み取れません」

カスタム接続を追加しようとしたときにこのエラーメッセージが表示される場合は、ローカル資格情報マネージャーに格納されている接続データが破損している可能性があります。この問題を回避するには、破損したローカル接続を削除し、追加し直してみてください。

Storage Explorer を開始します。メニューから、 [ヘルプ]>[開発者ツールの切り替え] に移動します。
開いたウィンドウの [アプリケーション] タブの左側で、[Local Storage (ローカルストレージ)]>[file://] に移動します。
問題が発生している接続の種類に応じて、そのキーを探します。その値をテキストエディターにコピーします。値は、次のようなカスタム接続名の配列です。
- ストレージアカウント
  - StorageExplorer_CustomConnections_Accounts_v1
- BLOB コンテナー
  - StorageExplorer_CustomConnections_Blobs_v1
  - StorageExplorer_CustomConnections_Blobs_v2
- ファイル共有
  - StorageExplorer_CustomConnections_Files_v1
- キュー
  - StorageExplorer_CustomConnections_Queues_v1
- テーブル
  - StorageExplorer_CustomConnections_Tables_v1
現在の接続名を保存したら、開発者ツールの値を [] に設定します。

破損していない接続を維持するために、以下の手順で破損している接続を探します。既存の接続がすべて失われてもかまわない場合は、この手順を省略し、プラットフォーム固有の指示に従って接続データを消去できます。

テキストエディターから、各接続名を開発者ツールに追加し直します。その後、接続がまだ機能するかどうかを確認します。
接続が正常に機能している場合は、破損していないため、そのままにしておくことができます。接続が機能していない場合は、 Developer Tools からその値を削除し、後で追加できるように記録します。
すべての接続を検査するまで繰り返します。

接続名を削除したら、破損しているデータを消去する必要があります。その後、Storage Explorer の標準的な接続手順を使用して、接続を追加し直すことができます。

[スタート] メニューで [資格情報マネージャー] を検索して開きます。
[Windows 資格情報] に移動します。
[Generic Credentials (汎用資格情報)] で、<connection_type_key>/<corrupted_connection_name> キーが含まれているエントリを探します。たとえば StorageExplorer_CustomConnections_Accounts_v1/account1 です。
これらの接続を削除し、追加し直します。

ローカル資格情報の管理は、システム構成によって異なります。システムにローカル資格情報管理用のツールがインストールされていない場合は、libsecret と互換性があるサードパーティ製のツールをインストールしてローカル資格情報を管理できます。たとえば、GNOME を使用するシステムでは、Seahorse をインストールできます。

ローカルの資格情報管理ツールを開きます。保存した資格情報を見つける。
<connection_type_key>/<corrupted_connection_name> キーを持つエントリ (StorageExplorer_CustomConnections_Accounts_v1/account1 など) を探します。
これらの接続を削除し、追加し直します。

ローカルの資格情報管理ツールを開きます。保存した資格情報を見つける。
<connection_type_key>/<corrupted_connection_name> キーを持つエントリ (StorageExplorer_CustomConnections_Accounts_v1/account1 など) を探します。
これらの接続を削除し、追加し直します。

注意

Storage Explorer は、SLES に対してはテストされていません。お使いのシステムで Storage Explorer を使用してみることはできますが、Storage Explorer が想定どおりに動作することは保証されません。

ローカルの資格情報管理ツールを開きます。保存した資格情報を見つける。
<connection_type_key>/<corrupted_connection_name> キーを持つエントリ (StorageExplorer_CustomConnections_Accounts_v1/account1 など) を探します。
これらの接続を削除し、追加し直します。

これらの手順を実行した後もこのエラーが発生する場合、または接続の破損の原因と思われることを共有したい場合は、GitHub のページで問題を開いてください。

共有アクセス署名の URL に関する問題

共有アクセス署名の URL を使用してサービスに接続し、エラーが発生した場合:

リソースの読み取りまたは一覧表示に必要なアクセス許可が URL で提供されているかを確認します。
URL の有効期限が切れていないかを確認します。
共有アクセス署名 URL がアクセスポリシーに基づく場合は、アクセスポリシーが取り消されていないか確認します。

無効な共有アクセス署名 URL で誤ってアタッチし、デタッチできなくなった場合は、次の手順を実行します。

Storage Explorer を実行しているときに F12 選択して、Developer Tools ウィンドウを開きます。
[アプリケーション] タブの左側で、[Local Storage (ローカルストレージ)]>[file://] を選択します。
共有アクセス署名 URI のサービスの種類に関連付けられているキーを検索します。たとえば、不正な共有アクセス署名 URI が blob コンテナーのものである場合、StorageExplorer_AddStorageServiceSAS_v1_blob というキーを探します。
キーの値は JSON 配列にする必要があります。不正な URI に関連付けられたオブジェクトを見つけて削除します。
Ctrl +R を選択してストレージエクスプローラーを再読み込みします。

Storage Explorer の依存関係

Storage Explorer には、Windows で実行するために必要なすべての依存関係がパッケージ化されています。

スナップ

Storage Explorer 1.10.0 以降は、Snap Store からスナップとして入手できます。この Storage Explorer スナップは、すべての依存ファイルを自動的にインストールします。スナップの新しいバージョンが使用可能であれば更新されます。 Storage Explorer スナップのインストールは、推奨されるインストール方法です。

Storage Explorer にはパスワードマネージャーが必要です。これは、Storage Explorer が正常に動作する前に手動で接続する必要がある場合があります。次のコマンドを実行して、Storage Explorer をシステムのパスワードマネージャーに接続できます。

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

.tar.gz ファイル

アプリケーションを .tar.gz ファイルとしてダウンロードすることもできますが、依存関係を手動でインストールする必要があります。

Storage Explorer を使用するには、お使いのシステムに .NET 6 ランタイムをインストールする必要があります。 ASP.NET ランタイムは必要ありません。

Note

以前のバージョンの Storage Explorer では、別のバージョンの .NET または .NET Core が必要になる場合があります。必要なバージョンを特定するには、リリースノートまたはアプリのエラーメッセージを参照してください。

Storage Explorer で必要なライブラリの多くは、Canonical の標準 Ubuntu インストールにプレインストールされています。カスタム環境の場合、一部のライブラリが不足することがあります。 Storage Explorer を起動できない場合、お使いのシステムに次のパッケージがインストールされていることを確認します。

iproute2
libasound2
libatm1
libgconf-2-4
libnspr4
libnss3
libpulse0
libsecret-1-0
libx11-xcb1
libxss1
libxtables11
libxtst6
xdg-utils

スナップ

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

.tar.gz ファイル

Note

.tar.gzダウンロードで提供されているストレージエクスプローラーは、Ubuntu でのみサポートされています。 Storage Explorer は RHEL で動作する可能性がありますが、正式にはサポートされていません。

アプリケーションを .tar.gz ファイルとしてダウンロードすることもできますが、依存関係を手動でインストールする必要があります。

Storage Explorer を使用するには、お使いのシステムに .NET 6 ランタイムをインストールする必要があります。 ASP.NET ランタイムは必要ありません。

注意

RHEL 環境には、Storage Explorer に必要な多くのライブラリが存在しない可能性があります。 Storage Explorer を起動できない場合、お使いのシステムに次のパッケージ (または RHEL でそれらに相当するもの) がインストールされていることを確認します。

iproute2
libasound2
libatm1
libgconf-2-4
libnspr4
libnss3
libpulse0
libsecret-1-0
libx11-xcb1
libxss1
libxtables11
libxtst6
xdg-utils

Note

Storage Explorer は SLES 用にテストされていません。お使いのシステムで Storage Explorer を使用することはできますが、Storage Explorer が期待どおりに動作することを保証することはできません。

スナップ

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

.tar.gz ファイル

アプリケーションを .tar.gz ファイルとしてダウンロードすることもできますが、依存関係を手動でインストールする必要があります。

Storage Explorer を使用するには、お使いのシステムに .NET 6 ランタイムをインストールする必要があります。 ASP.NET ランタイムは必要ありません。

注意

SLES 環境には、Storage Explorer に必要な多くのライブラリが存在しない可能性があります。 Storage Explorer を起動できない場合、お使いのシステムに次のパッケージ (または SLES でそれらに相当するもの) がインストールされていることを確認します。

iproute2
libasound2
libatm1
libgconf-2-4
libnspr4
libnss3
libpulse0
libsecret-1-0
libx11-xcb1
libxss1
libxtables11
libxtst6
xdg-utils

新しいバージョンの .NET Core 用 Storage Explorer パッチ

Storage Explorer 1.7.0 以前のバージョンでは、Storage Explorer で使用される .NET Core のバージョンにパッチを適用する必要がある場合があります。

NuGet ページに移動し、右側の Download パッケージ リンクから StreamJsonRpc のバージョン 1.5.43 をダウンロードします。
パッケージをダウンロードした後、そのファイル拡張子を nupkg から zip に変更します。
パッケージを解凍します。
streamjsonrpc.1.5.43/lib/netstandard1.1/ フォルダーを開きます。
StreamJsonRpc.dll を Storage Explorer フォルダー内の次の場所にコピーします。
- StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
- StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

Azure portal の [エクスプローラーで開く] ボタンが機能しない

Azure portal の [Open In Explorer (Explorer で開く)] ボタンが機能しない場合は、互換性があるブラウザーを使用しているかを確認してください。互換性についてテスト済みのブラウザーは、次のとおりです｡

Microsoft Edge
Mozilla Firefox
Google Chrome
Microsoft Internet Explorer

ログを収集する

GitHub に問題を報告するときに、問題の診断に役立つ特定のログを収集するように求められる場合があります。

Storage Explorer のログ

Storage Explorer のアプリケーションログにはさまざまなログが記録されます。これらのログを表示するには、[Help (ヘルプ)]>[Open Logs Directory (ログディレクトリを開く)] の順に選択します。規定では、Storage Explorer のログは低い詳細レベルで記録されます。詳細レベルを変更するには、[設定] (左側の歯車記号) >[アプリケーション]>[ログ]>[ログレベル] に移動します。その後、必要に応じてログレベルを設定できます。トラブルシューティングの場合は、最も詳細なレベルであるため、 Trace ログレベルをお勧めします。ログレベルを変更した後、Storage Explorer を再起動し、発生している問題を再現します。

実行する Storage Explorer のセッションごとに、ログがフォルダーに分割されます。共有する必要があるすべてのログファイルは、異なるセッションのファイルを別々のフォルダーに入れて、zip アーカイブに格納します。

認証ログ

サインインまたは Storage Explorer の認証ライブラリに関連する問題については、ほとんどの場合、認証ログを収集する必要があります。認証ログは次の場所に格納されています。

Windows: C:\Users\< ユーザー名 >\AppData\Local\Temp\servicehub\logs
macOS: ~/.ServiceHub/logs
Linux: ~/.ServiceHub/logs

一般的には、次の手順に従ってログを収集できます。

[設定] (左側の歯車記号)>[アプリケーション]>[Sign-in (サインイン)] に移動します。 [Verbose Authentication Logging (詳細認証ログ)] を選択します。 Storage Explorer の認証ライブラリに問題があるために Storage Explorer を起動できない場合は、この手順が実行されます。
Storage Explorer を閉じます。
省略可能または推奨: ログフォルダーから既存のログを消去します。これで、送信する必要がある情報量を減らすことができます。
Storage Explorer を開いて問題を再現します。
Storage Explorer を閉じます。
ログフォルダーの内容を圧縮します。

AzCopy ログ

データの転送で問題が発生している場合は、AzCopy ログを取得する必要がある場合があります。既定では、AzCopy は低レベルの詳細度でログを記録します。詳細レベルを変更するには、 Settings (左側の gear 記号) >Transfers>AzCopy>Log Level に移動します。その後、必要に応じてログレベルを設定できます。トラブルシューティングでは、最も詳細なレベルであるため、 Debug ログレベルをお勧めします。ログレベルを変更した後、Storage Explorer を再起動し、発生している問題を再現します。

AzCopy ログは、2 つの異なる方法で簡単に見つけることができます。

失敗した転送がアクティビティログに残っている場合は、[Go to AzCopy Log File (AzCopy ログファイルに移動)] を選択します。
過去に失敗した転送の場合は、AzCopy ログのフォルダーに移動します。このフォルダーは次の場所にあります。
- Windows: C:\Users\<ユーザー名>\.azcopy
- macOS: ~/.azcopy
- Linux: ~/.azcopy

ネットワークログ

一部の問題については、Storage Explorer によって行われたネットワーク呼び出しのログを提供する必要があります。 Windows では、Fiddler を使用してネットワークログを取得できます。

Note

Fiddler トレースには、トレースの収集時にブラウザーで入力または送信したパスワードが含まれている場合があります。 Fiddler トレースをサニタイズする方法の手順を必ずお読みください。 Fiddler トレースを GitHub にアップロードしないでください。 Fiddler トレースを安全に送信できる場所が指示されます。

パート 1: Fiddler をインストールして構成する

Fiddler をインストールします。
Fiddler を起動します。
[ツール]>[オプション] に移動します。
[HTTPS] タブをクリックします。
[Capture HTTPS CONNECTs (HTTPS CONNECT をキャプチャ)] と [Decrypt HTTPS traffic (HTTPS トラフィックの暗号化解除)] がチェックされていることを確認します。
[Actions](アクション) を選択します。
[ルート証明書 を選択し 次のダイアログボックスで Yes を選択します。
Storage Explorer を開始します。
Settings (左側の gear 記号) >Application>Proxy に移動します。
[プロキシソース] ドロップダウンを [システムプロキシを使用する (プレビュー)]に変更します。
Storage Explorer を再起動します。
storageexplorer: プロセスからのネットワーク呼び出しが Fiddler に表示されるのを確認します。

パート 2: 問題を再現する

Fiddler を除くすべてのアプリを閉じます。
View メニューの近くにある左上隅にある X を使用して Fiddler ログをクリアします。
省略可能/推奨: Fiddler を数分間設定します。 Storage Explorer に関係のないネットワーク呼び出しが表示された場合は、それらを右クリックして、[Filter Now (今すぐフィルター)]>[Hide (<process name>) (非表示 <プロセス名>)] を選択してください。
Storage Explorer を起動または再起動します。
問題を再現します。
[File (ファイル)]>[Save (保存)]>[All Sessions (すべてのセッション)] を選択します。忘れることのない場所に保存します。
Fiddler と Storage Explorer を閉じます。

パート 3: Fiddler トレースのサニタイズ

Fiddler トレース (.saz ファイル) をダブルクリックします。
Ctrl + F を選択します。
表示されるダイアログボックスで、次のオプションが設定されていることを確認します: Search = Requests and responses および Examine = Headers and bodies。
Fiddler トレースの収集中に使用したパスワードと、強調表示されているエントリを検索します。右クリックし、[Remove>Selected sessions (選択されたセッションの削除)] を選択します。
トレースの収集中にブラウザーにパスワードを確実に入力したが、 Ctrl + F を使用するときにエントリが見つからない場合、パスワードを変更したくない場合、または使用したパスワードが他のアカウントに使用されている場合は、.saz ファイルの送信をスキップしてください。
新しい名前でトレースをもう一度保存します。
省略可能: 元のトレースを削除します。

次のステップ

これらのソリューションがどれもうまく機能しない場合は、次のいずれかの方法を使用します。

サポートチケットを作成します。
[Report issue to GitHub (GitHub に問題を報告する)] ボタンを選択して、GitHubでイシューを開きます。

サードパーティの情報に関する免責事項

この資料に記載されているサードパーティ製品は、マイクロソフトと関連のない他社の製品です。明示的か黙示的かにかかわらず、これらの製品のパフォーマンスや信頼性についてマイクロソフトはいかなる責任も負わないものとします。

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティサポートにお問い合わせください。 Azure フィードバックコミュニティに製品フィードバックを送信することもできます。

次の方法で共有

Azure Storage Explorer トラブルシューティング ガイド

Azure RBAC のアクセス許可に関する問題

Storage Explorer で自分のリソースにアクセスするにはどうすればいいですか?

"読み取り:ストレージ アカウントの一覧表示/取得" アクセス許可の問題

ストレージ アカウント キーの一覧表示

データ ロール

Storage Explorer でリソースを表示するには、管理レイヤーのロールが必要ですか?

管理者から管理レイヤーのアクセス許可を取得できない場合、どうすればいいですか?

推奨される Azure 組み込みロール

SSL 証明書の問題

SSL 証明書の問題を把握する

システム プロキシを使用する

SSL 証明書をインポートする

SSL 証明書の検索

SSL 証明書検証の無効化

サインインの問題

サインイン情報について

資格情報を頻繁に再入力する必要がある

条件付きアクセス ポリシー

サインイン中に HTTP リダイレクトまたはセキュリティで保護されていない接続に関するエラーがブラウザーから表示される

トークンを取得できず、テナントがフィルターで除外されている

認証ライブラリを正常に開始できない

統合サインインを使用したときに空白のウィンドウが表示される

再認証ループまたは UPN の変更

macOS: キーチェーン エラー、またはサインイン ウィンドウが表示されない

Linux: 起動時にアプリケーション ウインドウまたはパスワード マネージャーエラーが発生しない

既定のブラウザーが開かない

その他のサインインの問題

サブスクリプションの欠落とテナントの破損

AzCopy 転送中の OS Credential Store との通信に関する問題

アタッチされているストレージ アカウントまたはリソースを削除できない

プロキシの問題

Storage Explorer のプロキシ設定を確認する

問題を診断するための手順

問題診断ツール

プロキシ サーバー管理者に問い合わせる

"子を取得できません" エラー メッセージ

接続文字列に完全な構成設定が含まれていない

「新しい接続の追加中にエラーが発生しました: TypeError: 未定義のプロパティ「version」を読み取れません」

共有アクセス署名の URL に関する問題

Storage Explorer の依存関係

新しいバージョンの .NET Core 用 Storage Explorer パッチ

Azure portal の [エクスプローラーで開く] ボタンが機能しない

ログを収集する

Storage Explorer のログ

認証ログ

AzCopy ログ

ネットワーク ログ

パート 1: Fiddler をインストールして構成する

パート 2: 問題を再現する

パート 3: Fiddler トレースのサニタイズ

次のステップ

お問い合わせはこちらから

フィードバック

その他のリソース

Azure Storage Explorer トラブルシューティングガイド

"読み取り:ストレージアカウントの一覧表示/取得" アクセス許可の問題

ストレージアカウントキーの一覧表示

データロール

システムプロキシを使用する

条件付きアクセスポリシー

macOS: キーチェーンエラー、またはサインインウィンドウが表示されない

Linux: 起動時にアプリケーションウインドウまたはパスワードマネージャーエラーが発生しない

アタッチされているストレージアカウントまたはリソースを削除できない

プロキシサーバー管理者に問い合わせる

"子を取得できません" エラーメッセージ

ネットワークログ