Skip to content

Commit 99e828b

Browse files
committed
Edit pass on Azure SDK guidance for MSI
1 parent 63ebad0 commit 99e828b

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

msal-dotnet-articles/advanced/managed-identity.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,16 +18,16 @@ A common challenge for developers is the management of secrets, credentials, cer
1818

1919
For a complete list, refer to [Azure services that can use managed identities to access other services](/azure/active-directory/managed-identities-azure-resources/managed-identities-status).
2020

21-
## Which SDK to use - Azure SDK or MSAL?
21+
## Which SDK to use - Azure Identity library or MSAL?
2222

23-
MSAL libraries provide lower level APIs that are closer to the OAuth2 and OIDC protocols.
23+
MSAL libraries provide lower-level APIs that are closer to the OAuth2 and OIDC protocols.
2424

25-
Both MSAL.NET and [Azure SDK](/dotnet/api/overview/azure/identity-readme?view=azure-dotnet&preserve-view=true) allow to acquire tokens via managed identity. Internally, Azure SDK uses MSAL.NET, and it provides a higher-level API via its `DefaultAzureCredential` and `ManagedIdentityCredential` abstractions.
25+
Both MSAL.NET and the [Azure Identity library for .NET](/dotnet/api/overview/azure/identity-readme?view=azure-dotnet&preserve-view=true) allow you to acquire tokens via managed identity. Internally, the Azure Identity library uses MSAL.NET, and it provides a higher-level API via its `DefaultAzureCredential` and [ManagedIdentityCredential](/dotnet/api/azure.identity.managedidentitycredential?view=azure-dotnet&preserve-view=true) abstractions.
2626

27-
If your application already uses one of the SDKs, continue using the same SDK. Use Azure SDK, if you are writing a new application and plan to call other Azure resources, as this SDK provides a better developer experience by allowing the app to run on private developer machines where managed identity doesn't exist. Consider using MSAL if you need to call other downstream web APIs like Microsoft Graph or your own web API.
27+
If your application already uses MSAL .NET or the Azure Identity library, continue using that same library. Use the Azure Identity library if you're writing a new application and plan to call other Azure resources, as this library provides a better developer experience by allowing the app to run on private developer machines where managed identity doesn't exist. Consider using MSAL if you need to call other downstream web APIs like Microsoft Graph or your own web API.
2828

2929
>[!NOTE]
30-
>[Microsoft.Identity.Web](https://github.com/AzureAD/microsoft-identity-web) is a higher-level API that offers integration with ASP.NET Core and ASP.NET Classic, while using MSAL under the hood. The library also provides a way to load credentials (certificates, signed assertions) used by MSAL.NET as client credentials. For certificates it uses the `DefaultAzureCredentials` to fetch certificates from KeyVault. It also offers workload identity federation with managed identity credentials. For details see [CredentialDescription](/dotnet/api/microsoft.identity.abstractions.credentialdescription.keyvaulturl?view=msal-model-dotnet-latest#microsoft-identity-abstractions-credentialdescription-keyvaulturl&preserve-view=true).
30+
>[Microsoft.Identity.Web](https://github.com/AzureAD/microsoft-identity-web) is a higher-level API that offers integration with ASP.NET Core and ASP.NET Classic, while using MSAL under the hood. The library also provides a way to load credentials (certificates, signed assertions) used by MSAL.NET as client credentials. For certificates, it uses the `DefaultAzureCredential` to fetch certificates from KeyVault. It also offers workload identity federation with managed identity credentials. For details, see [CredentialDescription](/dotnet/api/microsoft.identity.abstractions.credentialdescription.keyvaulturl?view=msal-model-dotnet-latest#microsoft-identity-abstractions-credentialdescription-keyvaulturl&preserve-view=true).
3131
3232
## Quick start
3333

0 commit comments

Comments
 (0)