You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -321,6 +321,8 @@ When `--cert` is provided for a PFX file, you must provide a corresponding `--pw
321
321
azurite --cert path/server.pfx --pwd pfxpassword
322
322
```
323
323
324
+
For detailed information on creating PEM and PFX files, see [HTTPS Setup](https://github.com/Azure/Azurite/blob/master/README.md#https-setup).
325
+
324
326
### OAuth configuration
325
327
326
328
**Optional** Enable OAuth authentication for Azurite by using the `--oauth` switch.
@@ -336,7 +338,9 @@ Azurite supports basic authentication by specifying the `basic` parameter to the
336
338
337
339
## Authorization for tools and SDKs
338
340
339
-
Connect to Azurite from Azure Storage SDKs or tools, like [Azure Storage Explorer](https://azure.microsoft.com/features/storage-explorer/), by using any authentication strategy. Authentication is required. Azurite supports authorization with Shared Key and shared access signatures (SAS). Azurite also supports anonymous access to public containers.
341
+
Connect to Azurite from Azure Storage SDKs or tools, like [Azure Storage Explorer](https://azure.microsoft.com/features/storage-explorer/), by using any authentication strategy. Authentication is required. Azurite supports authorization with OAuth, Shared Key, and shared access signatures (SAS). Azurite also supports anonymous access to public containers.
342
+
343
+
If you are using the Azure SDKs, start Azurite with the `--oauth basic` option.
340
344
341
345
### Well-known storage account and key
342
346
@@ -345,10 +349,36 @@ Azurite accepts the same well-known account and key used by the legacy Azure sto
Azurite supports custom storage account names and keys by setting the `AZURITE_ACCOUNTS` environment variable in the following format: `account1:key1[:key2];account2:key1[:key2];...`.
355
+
356
+
For example, use a custom storage account that has one key:
357
+
358
+
```cmd
359
+
set AZURITE_ACCOUNTS="account1:key1"
360
+
```
361
+
362
+
```bash
363
+
export AZURITE_ACCOUNTS="account1:key1"
364
+
```
365
+
366
+
Or use multiple storage accounts with 2 keys each:
367
+
368
+
```cmd
369
+
set AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"
Azurite refreshes custom account names and keys from the environment variable every minute by default. With this feature, you can dynamically rotate the account key, or add new storage accounts without restarting Azurite.
377
+
348
378
> [!NOTE]
349
-
> In addition to SharedKey authentication, Azurite supports account and service SAS authentication. Anonymous access is also available when a container is set to allow public access.
379
+
> The default `devstoreaccount1` storage account is disabled when you set custom storage accounts.
350
380
351
-
### Connection string
381
+
### Connection strings
352
382
353
383
The easiest way to connect to Azurite from your application is to configure a connection string in your application's configuration file that references the shortcut *UseDevelopmentStorage=true*. Here's an example of a connection string in an *app.config* file:
354
384
@@ -358,34 +388,93 @@ The easiest way to connect to Azurite from your application is to configure a co
358
388
</appSettings>
359
389
```
360
390
361
-
For more information, see [Configure Azure Storage connection strings](storage-configure-connection-string.md).
391
+
#### HTTP Connection Strings
362
392
363
-
### Custom storage accounts and keys
393
+
You can pass the following connection strings to the [Azure SDKs](https://aka.ms/azsdk) or tools, like Azure CLI 2.0 or Storage Explorer.
364
394
365
-
Azurite supports custom storage account names and keys by setting the `AZURITE_ACCOUNTS` environment variable in the following format: `account1:key1[:key2];account2:key1[:key2];...`.
395
+
The full connection string is:
366
396
367
-
For example, use a custom storage account that has one key:
Azurite refreshes custom account names and keys from the environment variable every minute by default. With this feature, you can dynamically rotate the account key, or add new storage accounts without restarting Azurite.
413
+
#### HTTPS Connection Strings
380
414
381
-
> [!NOTE]
382
-
> The default `devstoreaccount1` storage account is disabled when you set custom storage accounts.
415
+
The full HTTPS connection string is:
383
416
384
-
> [!NOTE]
385
-
> Update the connection string accordingly when using custom account names and keys.
0 commit comments