Skip to content

Commit 0d8206b

Browse files
Updates auth guidance
1 parent 690dd01 commit 0d8206b

6 files changed

+22
-5
lines changed

articles/storage/blobs/storage-blob-dotnet-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ To learn more about each of these authorization mechanisms, see [Authorize acces
6464

6565
<a name='azure-ad'></a>
6666

67-
## [Microsoft Entra ID](#tab/azure-ad)
67+
## [Microsoft Entra ID (recommended)](#tab/azure-ad)
6868

6969
To authorize with Microsoft Entra ID, you'll need to use a security principal. The type of security principal you need depends on where your application runs. Use this table as a guide.
7070

articles/storage/blobs/storage-blob-go-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ You can authorize a client object using a Microsoft Entra authorization token (r
6767

6868
<a name='azure-ad'></a>
6969

70-
## [Microsoft Entra ID](#tab/azure-ad)
70+
## [Microsoft Entra ID (recommended)](#tab/azure-ad)
7171

7272
To authorize with Microsoft Entra ID, you need to use a [security principal](../../active-directory/develop/app-objects-and-service-principals.md). The following articles provide guidance on different authentication scenarios:
7373

articles/storage/blobs/storage-blob-java-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ You can authorize a `BlobServiceClient` object by using a Microsoft Entra author
124124

125125
<a name='azure-ad-recommended'></a>
126126

127-
## [Microsoft Entra ID (Recommended)](#tab/azure-ad)
127+
## [Microsoft Entra ID (recommended)](#tab/azure-ad)
128128

129129
To authorize with Microsoft Entra ID, you'll need to use a [security principal](../../active-directory/develop/app-objects-and-service-principals.md). Which type of security principal you need depends on where your application runs. Use the following table as a guide:
130130

articles/storage/blobs/storage-blob-javascript-get-started.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,9 @@ The `dotenv` package is used to read your storage account name and key from a `.
130130
131131
For information about how to obtain account keys and best practice guidelines for properly managing and safeguarding your keys, see [Manage storage account access keys](../common/storage-account-keys-manage.md).
132132
133+
> [!IMPORTANT]
134+
> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
135+
133136
## [SAS token](#tab/sas-token)
134137
135138
Create a Uri to your resource by using the blob service endpoint and SAS token. Then, create a [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) with the Uri. The SAS token is a series of name/value pairs in the querystring in the format such as:
@@ -173,6 +176,8 @@ Create the [ContainerClient](/javascript/api/@azure/storage-blob/containerclient
173176
174177
:::code language="javascript" source="~/azure_storage-snippets/blobs/howto/JavaScript/NodeJS-v12/dev-guide/create-container-client-with-account-name-and-key.js" highlight="18-21, 29-32":::
175178
179+
> [!IMPORTANT]
180+
> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
176181
177182
#### [SAS token](#tab/sas-token)
178183
@@ -209,6 +214,9 @@ List of Blob clients:
209214
210215
:::code language="javascript" source="~/azure_storage-snippets/blobs/howto/JavaScript/NodeJS-v12/dev-guide/create-blob-client-with-account-name-and-key.js" highlight="19-22, 34-37":::
211216
217+
> [!IMPORTANT]
218+
> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
219+
212220
#### [SAS token](#tab/sas-token)
213221
214222
:::code language="javascript" source="~/azure_storage-snippets/blobs/howto/JavaScript/NodeJS-v12/dev-guide/create-blob-client-with-sas-token.js" highlight="17, 36":::

articles/storage/blobs/storage-blob-python-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ You can authorize a `BlobServiceClient` object by using a Microsoft Entra author
9393

9494
<a name='azure-ad'></a>
9595

96-
## [Microsoft Entra ID](#tab/azure-ad)
96+
## [Microsoft Entra ID (recommended)](#tab/azure-ad)
9797

9898
To authorize with Microsoft Entra ID, you need to use a [security principal](../../active-directory/develop/app-objects-and-service-principals.md). Which type of security principal you need depends on where your application runs. Use the following table as a guide:
9999

articles/storage/blobs/storage-blob-typescript-get-started.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ Each type of resource is represented by one or more associated JavaScript client
109109
110110
The [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) object is the top object in the SDK. This client allows you to manipulate the service, containers and blobs.
111111
112-
## [Passwordless](#tab/azure-ad)
112+
## [Microsoft Entra ID (recommended)](#tab/azure-ad)
113113
114114
Once your Azure storage account identity roles and your local environment are set up, create a TypeScript file which includes the [``@azure/identity``](https://www.npmjs.com/package/@azure/identity) package. Create a credential, such as the [DefaultAzureCredential](/javascript/api/overview/azure/identity-readme#defaultazurecredential), to implement passwordless connections to Blob Storage. Use that credential to authenticate with a [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) object.
115115
@@ -129,6 +129,9 @@ The `dotenv` package is used to read your storage account name and key from a `.
129129
130130
For information about how to obtain account keys and best practice guidelines for properly managing and safeguarding your keys, see [Manage storage account access keys](../common/storage-account-keys-manage.md).
131131
132+
> [!IMPORTANT]
133+
> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
134+
132135
## [SAS token](#tab/sas-token)
133136
134137
Create a Uri to your resource by using the blob service endpoint and SAS token. Then, create a [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) with the Uri. The SAS token is a series of name/value pairs in the querystring in the format such as:
@@ -172,6 +175,9 @@ Create the [ContainerClient](/javascript/api/@azure/storage-blob/containerclient
172175
173176
:::code language="typescript" source="~/azure_storage-snippets/blobs/howto/TypeScript/NodeJS-v12/dev-guide/src/auth-container-client-from-account-name-and-key.ts" :::
174177
178+
> [!IMPORTANT]
179+
> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
180+
175181
176182
#### [SAS token](#tab/sas-token)
177183
@@ -208,6 +214,9 @@ List of Blob clients:
208214
209215
:::code language="typescript" source="~/azure_storage-snippets/blobs/howto/TypeScript/NodeJS-v12/dev-guide/src/auth-blob-client-from-account-name-and-key.ts" :::
210216
217+
> [!IMPORTANT]
218+
> The account access key should be used with caution. If your account access key is lost or accidentally placed in an insecure location, your service may become vulnerable. Anyone who has the access key is able to authorize requests against the storage account, and effectively has access to all the data. `DefaultAzureCredential` provides enhanced security features and benefits and is the recommended approach for managing authorization to Azure services.
219+
211220
#### [SAS token](#tab/sas-token)
212221
213222
:::code language="typescript" source="~/azure-storage-snippets/blobs/howto/TypeScript/NodeJS-v12/dev-guide/src/auth-blob-client-from-blob-sas-token.ts":::

0 commit comments

Comments
 (0)