Skip to content

Commit bdf0d49

Browse files
Merge pull request #244587 from pauljewellmsft/pauljewell-issue-azurite
Add clarification around DefaultAzureCredential
2 parents 5c4fb84 + 8ca6f09 commit bdf0d49

File tree

1 file changed

+12
-6
lines changed

1 file changed

+12
-6
lines changed

articles/storage/common/storage-use-azurite.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Use Azurite emulator for local Azure Storage development
33
description: The Azurite open-source emulator provides a free local environment for testing your Azure storage applications.
44
author: pauljewellmsft
55
ms.author: pauljewell
6-
ms.date: 04/26/2023
6+
ms.date: 07/11/2023
77
ms.service: azure-storage
88
ms.subservice: storage-common-concepts
99
ms.topic: how-to
@@ -433,7 +433,7 @@ azurite --oauth basic --cert path/server.pem --key path/key.pem
433433
> [!NOTE]
434434
> OAuth requires an HTTPS endpoint. Make sure HTTPS is enabled by providing `--cert` switch along with the `--oauth` switch.
435435
436-
Azurite supports basic authentication by specifying the `basic` parameter to the `--oauth` switch. Azurite performs basic authentication, like validating the incoming bearer token, checking the issuer, audience, and expiry. Azurite doesn't check the token signature or permissions.
436+
Azurite supports basic authentication by specifying the `basic` parameter to the `--oauth` switch. Azurite performs basic authentication, like validating the incoming bearer token, checking the issuer, audience, and expiry. Azurite doesn't check the token signature or permissions. To learn more about authorization, see [Authorization for tools and SDKs](#authorization-for-tools-and-sdks).
437437

438438
### Skip API Version Check
439439

@@ -455,7 +455,7 @@ azurite --disableProductStyleUrl
455455

456456
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.
457457

458-
If you're using the Azure SDKs, start Azurite with the `--oauth basic and --cert --key/--pwd` options.
458+
If you're using the Azure SDKs, start Azurite with the `--oauth basic and --cert --key/--pwd` options. To learn more about using Azurite with the Azure SDKs, see [Azure SDKs](#azure-sdks).
459459

460460
### Well-known storage account and key
461461

@@ -564,7 +564,9 @@ azurite --oauth basic --cert certname.pem --key certname-key.pem
564564

565565
#### Azure Blob Storage
566566

567-
You can then instantiate a BlobContainerClient, BlobServiceClient, or BlobClient.
567+
To interact with Blob Storage resources, you can instantiate a `BlobContainerClient`, `BlobServiceClient`, or `BlobClient`.
568+
569+
The following examples show how to authorize a `BlobContainerClient` object using three different authorization mechanisms: [DefaultAzureCredential](/dotnet/api/azure.identity.defaultazurecredential), connection string, and shared key. `DefaultAzureCredential` provides a Bearer token-based authentication mechanism, and uses a chain of credential types used for authentication. Once authenticated, this credential provides the OAuth token as part of client instantiation. To learn more, see the [DefaultAzureCredential class reference](/dotnet/api/azure.identity.defaultazurecredential).
568570

569571
```csharp
570572
// With container URL and DefaultAzureCredential
@@ -586,7 +588,9 @@ var client = new BlobContainerClient(
586588

587589
#### Azure Queue Storage
588590

589-
You can also instantiate a QueueClient or QueueServiceClient.
591+
To interact with Queue Storage resources, you can instantiate a `QueueClient` or `QueueServiceClient`.
592+
593+
The following examples show how to create and authorize a `QueueClient` object using three different authorization mechanisms: [DefaultAzureCredential](/dotnet/api/azure.identity.defaultazurecredential), connection string, and shared key. `DefaultAzureCredential` provides a Bearer token-based authentication mechanism, and uses a chain of credential types used for authentication. Once authenticated, this credential provides the OAuth token as part of client instantiation. To learn more, see the [DefaultAzureCredential class reference](/dotnet/api/azure.identity.defaultazurecredential).
590594

591595
```csharp
592596
// With queue URL and DefaultAzureCredential
@@ -608,7 +612,9 @@ var client = new QueueClient(
608612

609613
#### Azure Table Storage
610614

611-
You can also instantiate a TableClient or TableServiceClient.
615+
To interact with Table Storage resources, you can instantiate a `TableClient` or `TableServiceClient`.
616+
617+
The following examples show how to create and authorize a `TableClient` object using three different authorization mechanisms: [DefaultAzureCredential](/dotnet/api/azure.identity.defaultazurecredential), connection string, and shared key. `DefaultAzureCredential` provides a Bearer token-based authentication mechanism, and uses a chain of credential types used for authentication. Once authenticated, this credential provides the OAuth token as part of client instantiation. To learn more, see the [DefaultAzureCredential class reference](/dotnet/api/azure.identity.defaultazurecredential).
612618

613619
```csharp
614620
// With table URL and DefaultAzureCredential

0 commit comments

Comments
 (0)