Skip to content

Commit b22f1dc

Browse files
committed
improve acrolinx scores
1 parent 0a0f3a8 commit b22f1dc

File tree

3 files changed

+38
-40
lines changed

3 files changed

+38
-40
lines changed

articles/event-hubs/passwordless-migration-event-hubs.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
title: Migrate applications to use passwordless authentication with Azure Event Hubs
33
titleSuffix: Azure Event Hubs
44
description: Learn to migrate existing applications away from Shared Key authorization with the account key to instead use Microsoft Entra ID and Azure role-based access control (RBAC) for enhanced security with Azure Event Hubs.
5-
author: alexwolfmsft
6-
ms.author: alexwolf
75
ms.date: 06/12/2023
86
ms.topic: how-to
97
ms.custom: devx-track-csharp, passwordless-java, passwordless-js, passwordless-python, passwordless-dotnet, passwordless-go, devx-track-azurecli, devx-track-azurepowershell

articles/service-bus-messaging/service-bus-migrate-azure-credentials.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Migrate applications to use passwordless authentication with Azure Service Bus
33
titleSuffix: Azure Service Bus
4-
description: Learn to migrate existing Service Bus applications away from connection strings to use Microsoft Entra ID and Azure RBAC for enhanced security.
4+
description: Learn to migrate existing Service Bus applications away from connection strings and use Microsoft Entra ID and Azure Role Based Access Control (RBAC) for enhanced security.
55
ms.reviewer: randolphwest
66
ms.date: 07/25/2025
77
ms.topic: how-to
@@ -22,7 +22,7 @@ Application requests to Azure Service Bus must be authenticated using either acc
2222

2323
## Security risks associated with access keys
2424

25-
The following code example demonstrates how to connect to Azure Service Bus using a connection string that includes an access key. When you create a Service Bus, Azure generates these keys and connection strings automatically. Many developers gravitate towards this solution because it feels familiar to options they've worked with in the past. If your application currently uses connection strings, consider migrating to passwordless connections using the steps described in this document.
25+
The following code example demonstrates how to connect to Azure Service Bus using a connection string that includes an access key. When you create a Service Bus, Azure generates these keys and connection strings automatically. Many developers gravitate towards this solution because it feels familiar to options they worked with in the past. If your application currently uses connection strings, consider migrating to passwordless connections using the steps described in this document.
2626

2727
## [.NET](#tab/dotnet)
2828

@@ -89,15 +89,15 @@ client = ServiceBusClient(
8989

9090
---
9191

92-
Connection strings should be used with caution. Developers must be diligent to never expose the keys in an unsecure location. Anyone who gains access to the key is able to authenticate. For example, if an account key is accidentally checked into source control, sent through an unsecure email, pasted into the wrong chat, or viewed by someone who shouldn't have permission, there's risk of a malicious user accessing the application. Instead, consider updating your application to use passwordless connections.
92+
Connection strings should be used with caution. Developers must be diligent to never expose the keys in an unsecure location. Anyone who gains access to the key is able to authenticate. For example, if an account key is accidentally checked into source control, sent through an unsecure email, or viewed by someone who shouldn't have permission, there's risk of a malicious user accessing the application. Instead, consider updating your application to use passwordless connections.
9393

9494
## Migrate to passwordless connections
9595

9696
[!INCLUDE [migrate-to-passwordless-overview](../../includes/passwordless/migration-guide/migrate-to-passwordless-overview.md)]
9797

9898
## Steps to migrate an app to use passwordless authentication
9999

100-
The following steps explain how to migrate an existing application to use passwordless connections instead of a key-based solution. You'll first configure a local development environment, and then apply those concepts to an Azure app hosting environment. These same migration steps should apply whether you're using access keys directly, or through connection strings.
100+
The following steps explain how to migrate an existing application to use passwordless connections instead of a key-based solution. You first configure a local development environment, and then apply those concepts to an Azure app hosting environment. These same migration steps should apply whether you're using access keys directly, or through connection strings.
101101

102102
### Configure roles and users for local development authentication
103103

@@ -296,11 +296,11 @@ Next, update your code to use passwordless connections.
296296
297297
#### Run the app locally
298298
299-
After making these code changes, run your application locally. The new configuration should pick up your local credentials, such as the Azure CLI, Visual Studio, or IntelliJ. The roles you assigned to your local dev user in Azure will allow your app to connect to the Azure service locally.
299+
After making these code changes, run your application locally. The new configuration should pick up your local credentials, such as the Azure CLI, Visual Studio, or IntelliJ. The roles you assigned to your local dev user in Azure allows your app to connect to the Azure service locally.
300300
301301
### Configure the Azure hosting environment
302302
303-
Once your application is configured to use passwordless connections and runs locally, the same code can authenticate to Azure services after it's deployed to Azure. For example, an application deployed to an Azure App Service instance that has a managed identity enabled can connect to Azure Service Bus.
303+
Once your application is configured to use passwordless connections and runs locally, the same code can authenticate to Azure services when deployed to Azure. For example, an application deployed to an Azure App Service instance that has a managed identity enabled can connect to Azure Service Bus.
304304
305305
#### Create the managed identity using the Azure portal
306306
@@ -403,7 +403,7 @@ az aks update \
403403
404404
#### Assign roles to the managed identity
405405
406-
Next, you need to grant permissions to the managed identity you created to access your Service Bus. You can do this by assigning a role to the managed identity, just like you did with your local development user.
406+
Next, you need to grant permissions to the managed identity you created to access your Service Bus. Assign a role to the managed identity, just like you did with your local development user.
407407
408408
### [Service Connector](#tab/assign-role-service-connector)
409409

0 commit comments

Comments
 (0)