From 2fc96831dd3ab7dd4c0746f0ee1296cd61ab6320 Mon Sep 17 00:00:00 2001 From: Matthew Rayermann Date: Mon, 11 Dec 2023 23:38:07 +0000 Subject: [PATCH 1/3] Simplify HTTPS steps for Storage Explorer --- README.md | 35 +++++++++++++---------------------- 1 file changed, 13 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index c6751e424..05372e443 100644 --- a/README.md +++ b/README.md @@ -764,31 +764,22 @@ var client = new QueueClient(new Uri("https://127.0.0.1:10001/devstoreaccount1/q #### Storage Explorer with Azurite HTTP -Connect to Azurite by click "Add Account" icon, then select "Attach to a local emulator" and click "Connect". +To connect Storage Explorer to Azurite over HTTP: +1. Open the connect dialog, via the plug icon in the vertial toolbar. +2. Select "Local storage emulator" and change values as needed. You can also select 'Storage account or service" on the first page, and enter in your own connection string. +3. Click "Next" and review the connection settings. +4. Finally click "Connect". #### Storage Explorer with Azurite HTTPS -By default Storage Explorer will not open an HTTPS endpoint that uses a self-signed certificate. If you are running Azurite with HTTPS, then you are likely using a self-signed certificate. Fortunately, Storage Explorer allows you to import SSL certificates via the Edit -> SSL Certificates -> Import Certificates dialog. - -##### Import Certificate to Storage Explorer - -1. Find the certificate on your local machine. - - **OpenSSL**: You can find the PEM file at the location you created in the [HTTPS Setup](#https-setup) section above. - - **mkcert**: You need to import the RootCA.pem file, which can be found by executing this command in the terminal: `mkcert -CAROOT`. For mkcert, you want to import the RootCA.pem file, not the certificate file you created. - - **dotnet dev-certs**: Storage Explorer doesn't currently work with certs produced by `dotnet dev-certs`. We are tracking this issue on GitHub here: -2. Open Storage Explorer -> Edit -> SSL Certificates -> Import Certificates and import your certificate. - -If you do not set this, then you will get the following error: - -``` -unable to verify the first certificate -``` - -or - -``` -self signed certificate in chain -``` +To connect Storage Explorer to Azurite over HTTPS: +1. Open Settings, via the gear icon in the vertical toolbar. +2. Enter "system proxy" in the search box at the top of the settings page. +3. Under the "Proxy Configuration" setting, click the dropdown and choose "Use system proxy". +4. Open the connect dialog, via the plug icon in the vertial toolbar. +5. Select "Local storage emulator", change values as needed, and check the "Use HTTPS" checkbox. You can also select "Storage account or service" on the first page, and enter in your own connection string. +6. Click "Next" and review the connection settings. +7. Finally click "Connect". ##### Add Azurite via HTTPS Connection String From c86b1572f39a0a56a3b3cd88c33a28de06ce450c Mon Sep 17 00:00:00 2001 From: Matthew Rayermann Date: Mon, 11 Dec 2023 23:40:54 +0000 Subject: [PATCH 2/3] Add back warning about dotnet dev-certs --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 05372e443..942be5126 100644 --- a/README.md +++ b/README.md @@ -772,6 +772,8 @@ To connect Storage Explorer to Azurite over HTTP: #### Storage Explorer with Azurite HTTPS +> Storage Explorer does not currently work with certificates produced by `dotnet dev-certs`. While you can use them for Azurite and Azure SDKs, you won't be able to access the Azurite endpoints with Storage Explorer if you are using the certs created with dotnet dev-certs. We are tracking this issue on GitHub here: + To connect Storage Explorer to Azurite over HTTPS: 1. Open Settings, via the gear icon in the vertical toolbar. 2. Enter "system proxy" in the search box at the top of the settings page. From 51d69b3e04fe11d693339c8362636c4165fef0f0 Mon Sep 17 00:00:00 2001 From: Matthew Rayermann Date: Mon, 11 Dec 2023 23:42:13 +0000 Subject: [PATCH 3/3] Remove not needed section --- README.md | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/README.md b/README.md index 942be5126..8399a9e48 100644 --- a/README.md +++ b/README.md @@ -783,17 +783,6 @@ To connect Storage Explorer to Azurite over HTTPS: 6. Click "Next" and review the connection settings. 7. Finally click "Connect". -##### Add Azurite via HTTPS Connection String - -Follow these steps to add Azurite HTTPS to Storage Explorer: - -1. Right click on Local & Attached -> Storage Accounts and select "Connect to Azure Storage...". -2. Select "Use a connection string" and click Next. -3. Enter a name, i.e Azurite. -4. Enter the [HTTPS connection string](#https-connection-strings) from the previous section of this document and click Next. - -You can now explore the Azurite HTTPS endpoints with Storage Explorer. - ## Workspace Structure Following files or folders may be created when initializing Azurite in selected workspace location.