Skip to content

Commit 03b0831

Browse files
Add SAS recommendations
1 parent 91c1180 commit 03b0831

6 files changed

+28
-5
lines changed

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,9 @@ To learn more about generating and managing SAS tokens, see the following articl
116116
- [Create a user delegation SAS for a container with .NET](storage-blob-container-user-delegation-sas-create-dotnet.md)
117117
- [Create a user delegation SAS for a blob with .NET](storage-blob-user-delegation-sas-create-dotnet.md)
118118

119+
> [!NOTE]
120+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key.
121+
119122
## [Account key](#tab/account-key)
120123

121124
Create a [StorageSharedKeyCredential](/dotnet/api/azure.storage.storagesharedkeycredential) by using the storage account name and account key. Then use that object to initialize a [BlobServiceClient](/dotnet/api/azure.storage.blobs.blobserviceclient).

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ To use a shared access signature (SAS) token, append the token to the account UR
8888
:::code language="go" source="~/blob-devguide-go/cmd/client-auth/client_auth.go" id="snippet_get_service_client_SAS":::
8989

9090
> [!NOTE]
91-
> A user delegation SAS offers superior security to a SAS that is signed with the storage account key. Microsoft recommends using a user delegation SAS when possible. For more information, see [Grant limited access to data with shared access signatures (SAS)](../common/storage-sas-overview.md).
91+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. For more information, see [Grant limited access to data with shared access signatures (SAS)](../common/storage-sas-overview.md).
9292
9393
## [Account key](#tab/account-key)
9494

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,9 @@ To learn more about generating and managing SAS tokens, see the following articl
160160
- [Create a user delegation SAS for a container with Java](storage-blob-container-user-delegation-sas-create-java.md)
161161
- [Create a user delegation SAS for a blob with Java](storage-blob-user-delegation-sas-create-java.md)
162162

163+
> [!NOTE]
164+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key.
165+
163166
## [Account key](#tab/account-key)
164167

165168
Create a [StorageSharedKeyCredential](/java/api/com.azure.storage.common.storagesharedkeycredential) by using the storage account name and account key. Then use that object to initialize a [BlobServiceClient](/java/api/com.azure.storage.blob.blobserviceclient) object.

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,14 +145,16 @@ Depending on which tool you use to generate your SAS token, the querystring `?`
145145
146146
:::code language="javascript" source="~/azure_storage-snippets/blobs/howto/JavaScript/NodeJS-v12/dev-guide/connect-with-sas-token.js" highlight="13-16":::
147147
148-
The `dotenv` package is used to read your storage account name and sas token from a `.env` file. This file should not be checked into source control.
148+
The `dotenv` package is used to read your storage account name and SAS token from a `.env` file. This file should not be checked into source control.
149149
150150
To generate and manage SAS tokens, see any of these articles:
151151
152152
- [Grant limited access to Azure Storage resources using shared access signatures (SAS)](../common/storage-sas-overview.md?toc=/azure/storage/blobs/toc.json)
153-
154153
- [Create a service SAS for a container or blob](sas-service-create.md)
155154
155+
> [!NOTE]
156+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. To learn more, see [Create a user delegation SAS with JavaScript](storage-blob-create-user-delegation-sas-javascript.md).
157+
156158
---
157159
158160
## Create a ContainerClient object
@@ -183,6 +185,8 @@ Create the [ContainerClient](/javascript/api/@azure/storage-blob/containerclient
183185
184186
:::code language="javascript" source="~/azure_storage-snippets/blobs/howto/JavaScript/NodeJS-v12/dev-guide/create-container-client-with-sas-token.js" highlight="19, 24":::
185187
188+
> [!NOTE]
189+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. To learn more, see [Create a user delegation SAS with JavaScript](storage-blob-create-user-delegation-sas-javascript.md).
186190
187191
-----------------
188192
@@ -221,6 +225,9 @@ List of Blob clients:
221225
222226
:::code language="javascript" source="~/azure_storage-snippets/blobs/howto/JavaScript/NodeJS-v12/dev-guide/create-blob-client-with-sas-token.js" highlight="17, 36":::
223227
228+
> [!NOTE]
229+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. To learn more, see [Create a user delegation SAS with JavaScript](storage-blob-create-user-delegation-sas-javascript.md).
230+
224231
-----------------
225232
226233
The `dotenv` package is used to read your storage account name from a `.env` file. This file should not be checked into source control.

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,9 @@ To learn more about generating and managing SAS tokens, see the following articl
151151
- [Create a user delegation SAS for a container with Python](storage-blob-container-user-delegation-sas-create-python.md)
152152
- [Create a user delegation SAS for a blob with Python](storage-blob-user-delegation-sas-create-python.md)
153153

154+
> [!NOTE]
155+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key.
156+
154157
## [Account key](#tab/account-key)
155158

156159
To use a storage account shared key, provide the key as a string and initialize a [BlobServiceClient](/python/api/azure-storage-blob/azure.storage.blob.blobserviceclient) object.

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -144,14 +144,16 @@ Depending on which tool you use to generate your SAS token, the querystring `?`
144144
145145
:::code language="typescript" source="~/azure_storage-snippets/blobs/howto/TypeScript/NodeJS-v12/dev-guide/src/auth-service-connect-from-sas-token.ts" :::
146146
147-
The `dotenv` package is used to read your storage account name and sas token from a `.env` file. This file should not be checked into source control.
147+
The `dotenv` package is used to read your storage account name and SAS token from a `.env` file. This file should not be checked into source control.
148148
149149
To generate and manage SAS tokens, see any of these articles:
150150
151151
- [Grant limited access to Azure Storage resources using shared access signatures (SAS)](../common/storage-sas-overview.md?toc=/azure/storage/blobs/toc.json)
152-
153152
- [Create a service SAS for a container or blob](sas-service-create.md)
154153
154+
> [!NOTE]
155+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. To learn more, see [Create a user delegation SAS with JavaScript](storage-blob-create-user-delegation-sas-javascript.md).
156+
155157
---
156158
157159
## Create a ContainerClient object
@@ -183,6 +185,8 @@ Create the [ContainerClient](/javascript/api/@azure/storage-blob/containerclient
183185
184186
:::code language="typescript" source="~/azure_storage-snippets/blobs/howto/TypeScript/NodeJS-v12/dev-guide/src/auth-container-client-from-sas-token.ts" :::
185187
188+
> [!NOTE]
189+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. To learn more, see [Create a user delegation SAS with JavaScript](storage-blob-create-user-delegation-sas-javascript.md).
186190
187191
-----------------
188192
@@ -221,6 +225,9 @@ List of Blob clients:
221225
222226
:::code language="typescript" source="~/azure-storage-snippets/blobs/howto/TypeScript/NodeJS-v12/dev-guide/src/auth-blob-client-from-blob-sas-token.ts":::
223227
228+
> [!NOTE]
229+
> For scenarios where shared access signatures (SAS) are used, Microsoft recommends using a user delegation SAS. A user delegation SAS is secured with Microsoft Entra credentials instead of the account key. To learn more, see [Create a user delegation SAS with JavaScript](storage-blob-create-user-delegation-sas-javascript.md).
230+
224231
-----------------
225232
226233
The `dotenv` package is used to read your storage account name from a `.env` file. This file should not be checked into source control.

0 commit comments

Comments
 (0)