Merge pull request #640 from MicrosoftDocs/main

microsoft-github-policy-service[bot] · web-flow · commit 0afea229941e · 2025-03-18T16:11:49.000Z
Merge main into live
diff --git a/dotnet/docfx.json b/dotnet/docfx.json
@@ -43,7 +43,7 @@
     ],
     "globalMetadata": {
       "uhfHeaderId": "MSDocsHeader-Entra",
-      "feedback_system": "GitHub",
+      "feedback_system": "Standard",
       "feedback_github_repo": "MicrosoftDocs/microsoft-authentication-library-dotnet",
       "feedback_product_url": "https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues",
       "apiPlatform": "dotnet",
diff --git a/msal-dotnet-articles/acquiring-tokens/desktop-mobile/acquiring-tokens-interactively.md b/msal-dotnet-articles/acquiring-tokens/desktop-mobile/acquiring-tokens-interactively.md
@@ -9,7 +9,7 @@ ms.service: msal
 ms.subservice: msal-dotnet
 ms.topic: conceptual
 ms.workload: identity
-ms.date: 12/13/2023
+ms.date: 03/17/2025
 ms.author: dmwendia
 ms.reviewer: ddelimarsky
 ms.custom: devx-track-csharp, aaddev, devx-track-dotnet
diff --git a/msal-dotnet-articles/acquiring-tokens/desktop-mobile/device-code-flow.md b/msal-dotnet-articles/acquiring-tokens/desktop-mobile/device-code-flow.md
@@ -1,6 +1,7 @@
 ---
 title: Using Device Code Flow in MSAL.NET
 description: "Interactive authentication with Microsoft Entra ID requires a web browser. However, in the case of devices and operating systems that do not provide a Web browser, Device Code Flow lets the user use another device (for instance another computer or a mobile phone) to sign-in interactively."
+ms.date: 03/17/2025
 ---
 
 # Using Device Code Flow in MSAL.NET
diff --git a/msal-dotnet-articles/acquiring-tokens/desktop-mobile/integrated-windows-authentication.md b/msal-dotnet-articles/acquiring-tokens/desktop-mobile/integrated-windows-authentication.md
@@ -1,6 +1,7 @@
 ---
 title: Using MSAL.NET with Integrated Windows Authentication (IWA)
 description: "If your desktop or mobile application runs on Windows and on a machine connected to a Windows domain (Active Directory or Microsoft Entra joined) it is possible to use the Integrated Windows Authentication (IWA) to acquire a token silently. No UI is required when using the application."
+ms.date: 03/17/2025
 ---
 
 # Using MSAL.NET with Integrated Windows Authentication (IWA)
diff --git a/msal-dotnet-articles/acquiring-tokens/desktop-mobile/mobile-applications.md b/msal-dotnet-articles/acquiring-tokens/desktop-mobile/mobile-applications.md
@@ -1,6 +1,7 @@
 ---
 title: Using MSAL.NET With .NET MAUI
 description: "How to use MSAL.NET on mobile platforms."
+ms.date: 03/17/2025
 ---
 
 # Using MSAL.NET With MAUI
diff --git a/msal-dotnet-articles/acquiring-tokens/desktop-mobile/username-password-authentication.md b/msal-dotnet-articles/acquiring-tokens/desktop-mobile/username-password-authentication.md
@@ -1,6 +1,7 @@
 ---
 title: Username and password (ROPC) authentication with MSAL.NET
 description: "In your desktop application, you can use the username and password flow to acquire a token silently. No UI is required when using the application."
+ms.date: 03/17/2025
 ---
 
 # Username and password (ROPC) authentication with MSAL.NET
diff --git a/msal-dotnet-articles/acquiring-tokens/web-apps-apis/authorization-codes.md b/msal-dotnet-articles/acquiring-tokens/web-apps-apis/authorization-codes.md
@@ -1,6 +1,7 @@
 ---
 title: Using MSAL.NET to get tokens by authorization code (for web sites)
 description: "When users login to Web applications (web sites) using OpenID Connect, the web application receives an authorization code which it can redeem to acquire a token to call Web APIs."
+ms.date: 03/17/2025
 ---
 
 # Using MSAL.NET to get tokens by authorization code (for web sites)
diff --git a/msal-dotnet-articles/acquiring-tokens/web-apps-apis/client-credential-flows.md b/msal-dotnet-articles/acquiring-tokens/web-apps-apis/client-credential-flows.md
@@ -1,6 +1,7 @@
 ---
 title: Client credential flows
 description: "Client credential authentication flows allow services, APIs, and daemon applications to acquire a token without direct user interaction."
+ms.date: 03/17/2025
 ---
 
 # Client credential flows
diff --git a/msal-dotnet-articles/acquiring-tokens/web-apps-apis/on-behalf-of-flow.md b/msal-dotnet-articles/acquiring-tokens/web-apps-apis/on-behalf-of-flow.md
@@ -1,6 +1,7 @@
 ---
 title: On-behalf-of flows with MSAL.NET
 description: "How to use MSAL.NET to authenticate on behalf of a user."
+ms.date: 03/17/2025
 ---
 
 # On-behalf-of flows with MSAL.NET
diff --git a/msal-dotnet-articles/acquiring-tokens/web-apps-apis/workload-identity-federation.md b/msal-dotnet-articles/acquiring-tokens/web-apps-apis/workload-identity-federation.md
@@ -1,6 +1,7 @@
 ---
 title: Acquiring a token with federated workload identity
 description: "How to acquire tokens with federated workload identity in MSAL.NET"
+ms.date: 03/17/2025
 ---
 
 # Workload identity federation
diff --git a/msal-dotnet-articles/advanced/android-ios-emulator.md b/msal-dotnet-articles/advanced/android-ios-emulator.md
@@ -1,6 +1,7 @@
 ---
 title: Using MSAL.NET with Android and iOS emulators
 description: "How to use MSAL.NET with Android and iOS device emulators."
+ms.date: 03/17/2025
 ---
 
 # Using MSAL.NET with Android and iOS emulators
diff --git a/msal-dotnet-articles/advanced/backup-authentication-system.md b/msal-dotnet-articles/advanced/backup-authentication-system.md
@@ -1,6 +1,7 @@
 ---
 title: Backup authentication system
 description: "The Microsoft Entra backup authentication system enables the caching of credentials processed by the Evolved Security Token Service (ESTS) in order to provide resiliency during outages in Microsoft Entra authentication services."
+ms.date: 03/17/2025
 ---
 
 # Backup authentication system
diff --git a/msal-dotnet-articles/advanced/clearing-token-cache.md b/msal-dotnet-articles/advanced/clearing-token-cache.md
@@ -1,6 +1,7 @@
 ---
 title: Cleaning the token cache
 description: "How to clear the token cache used by MSAL.NET"
+ms.date: 03/17/2025
 ---
 
 # Clearing the token cache
diff --git a/msal-dotnet-articles/advanced/client-and-server-throttling.md b/msal-dotnet-articles/advanced/client-and-server-throttling.md
@@ -1,6 +1,7 @@
 ---
 title: Understanding client and server throttling in MSAL.NET
 description: "Microsoft Entra ID throttles applications when you call the authentication API too frequently. Learn how to handle this with MSAL.NET."
+ms.date: 03/17/2025
 ---
 
 # Understanding client and server throttling in MSAL.NET
diff --git a/msal-dotnet-articles/advanced/client-credential-multi-tenant.md b/msal-dotnet-articles/advanced/client-credential-multi-tenant.md
@@ -1,6 +1,7 @@
 ---
 title: Using MSAL.NET for client credential flow in multi-tenant services
 description: Learn Microsoft's Advanced Client Credential Multi-Tenant with MSAL.NET, token caching, and Microsoft.Identity.Web for ASP.NET Core.
+ms.date: 03/17/2025
 ---
 
 # Using MSAL.NET for client credential flow in multi-tenant services
diff --git a/msal-dotnet-articles/advanced/custom-authority-aliases.md b/msal-dotnet-articles/advanced/custom-authority-aliases.md
@@ -1,6 +1,7 @@
 ---
 title: Custom authority aliases
 description: "How to use custom authority aliases with your MSAL.NET applications."
+ms.date: 03/17/2025
 ---
 
 # Custom authority aliases
diff --git a/msal-dotnet-articles/advanced/exceptions/broker.md b/msal-dotnet-articles/advanced/exceptions/broker.md
@@ -1,6 +1,7 @@
 ---
 title: Troubleshooting brokered applications
 description: Master brokered authentication on Android with our troubleshooting guide. Learn about redirect URIs, broker versions, precedence, and log acquisition.
+ms.date: 03/17/2025
 ---
 
 # Troubleshooting brokered applications
diff --git a/msal-dotnet-articles/advanced/exceptions/device-authentication-errors.md b/msal-dotnet-articles/advanced/exceptions/device-authentication-errors.md
@@ -1,6 +1,7 @@
 ---
 title: Device authentication errors
 description: "Errors that can show up when using device authentication with MSAL.NET."
+ms.date: 03/17/2025
 ---
 
 # Device authentication errors
diff --git a/msal-dotnet-articles/advanced/exceptions/index.md b/msal-dotnet-articles/advanced/exceptions/index.md
@@ -1,6 +1,7 @@
 ---
 title: Exceptions in MSAL.NET
 description: Master handling exceptions in MSAL.NET with this comprehensive guide. Learn about different types of exceptions, common issues, and how to implement retry policies.
+ms.date: 03/17/2025
 ---
 
 # Exceptions in MSAL.NET
diff --git a/msal-dotnet-articles/advanced/exceptions/retry-policy.md b/msal-dotnet-articles/advanced/exceptions/retry-policy.md
@@ -1,6 +1,7 @@
 ---
 title: Retry policies
 description: Learn how to implement a custom retry policy for token acquisition operations in .NET with MSAL. Increase your service availability with our detailed guide.
+ms.date: 03/17/2025
 ---
 
 # Retry Policies are baked in the libary
diff --git a/msal-dotnet-articles/advanced/exceptions/tls-issues.md b/msal-dotnet-articles/advanced/exceptions/tls-issues.md
@@ -1,6 +1,7 @@
 ---
 title: TLS issues
 description: "How to diagnose and address TLS issues when using MSAL.NET"
+ms.date: 03/17/2025
 ---
 
 # TLS issues
diff --git a/msal-dotnet-articles/advanced/exceptions/understanding-msaluirequiredexception.md b/msal-dotnet-articles/advanced/exceptions/understanding-msaluirequiredexception.md
@@ -1,5 +1,7 @@
 ---
 title: Understanding MsalUiRequiredException
+ms.date: 03/17/2025
+description: Learn how to handle `MsalUiRequiredException` in MSAL.NET when `AcquireTokenSilent` fails and requires user interaction.
 ---
 
 # Understanding `MsalUiRequiredException`
diff --git a/msal-dotnet-articles/advanced/exceptions/understanding-statemismatcherror.md b/msal-dotnet-articles/advanced/exceptions/understanding-statemismatcherror.md
@@ -1,5 +1,7 @@
 ---
 title: Understanding StateMismatchError
+ms.date: 03/17/2025
+description: Understand the `StateMismatchError` exception in MSAL.NET
 ---
 
 # Understanding `StateMismatchError`
diff --git a/msal-dotnet-articles/advanced/exceptions/unity.md b/msal-dotnet-articles/advanced/exceptions/unity.md
@@ -1,6 +1,7 @@
 ---
 title: Troubleshooting MSAL.NET in Unity applications
 description: Learn how to troubleshoot MSAL.NET in Unity applications. Understand the cause of runtime exceptions and discover effective solutions.
+ms.date: 03/17/2025
 ---
 
 # Troubleshooting MSAL.NET in Unity applications
diff --git a/msal-dotnet-articles/advanced/experimental-features.md b/msal-dotnet-articles/advanced/experimental-features.md
@@ -1,5 +1,7 @@
 ---
 title: Experimental features in MSAL.NET
+description: Learn about experimental features in MSAL.NET and how to use them in your projects.
+ms.date: 03/17/2025
 ---
 
 # Experimental features in MSAL.NET
diff --git a/msal-dotnet-articles/advanced/extensibility-points.md b/msal-dotnet-articles/advanced/extensibility-points.md
@@ -1,6 +1,7 @@
 ---
 title: MSAL.NET extensibility points
 description: Explore advanced extensibility points in MSAL.NET for scalable apps. Adapt HttpClient factories, modify token requests, inject query parameters, and more.
+ms.date: 03/17/2025
 ---
 
 # MSAL.NET extensibility points
@@ -9,7 +10,7 @@ MSAL adopts the strategy of "make simple scenarios simple, make complex scenario
 
 ## Use your own HttpClient
 
-Allows apps to adapt highly scalable HttpClient factories such as ASP.NET Core's [IHttpClientFactory](/aspnet/core/fundamentals/http-requests?view=aspnetcore-6.0).
+Allows apps to adapt highly scalable HttpClient factories such as ASP.NET Core's [IHttpClientFactory](/aspnet/core/fundamentals/http-requests).
 Helps desktop and mobile apps which have to deal with complex proxy configurations.
 Allows apps to fully control the HTTP messages.
 
@@ -50,10 +51,10 @@ Allows apps to add query (GET) parameters to applications, customizing the exper
 
 Useful to target Microsoft Entra service slices where new features or bug fixes are deployed first and to customize the UX experience with features not exposed by MSAL. Note that MSAL doesn't perform the `/authorize` request in ASP.NET / ASP.NET Core scenarios, so those calls are not affected!
 
-Details [here](/dotnet/api/microsoft.identity.client.abstractacquiretokenparameterbuilder-1.withextraqueryparameters?view=azure-dotnet#microsoft-identity-client-abstractacquiretokenparameterbuilder-1-withextraqueryparameters(system-string))
+Details [here](/dotnet/api/microsoft.identity.client.abstractacquiretokenparameterbuilder-1.withextraqueryparameters?)
 
 ## Desktop / Mobile Apps - ICustomWebUi
 
 Allows desktop and mobile apps to use their own browser instead of the embedded / system browsers provided by MSAL.
 
-Details [here](/dotnet/api/microsoft.identity.client.extensibility.icustomwebui?view=azure-dotnet)
+Details [here](/dotnet/api/microsoft.identity.client.extensibility.icustomwebui?)
diff --git a/msal-dotnet-articles/advanced/extract-authentication-parameters.md b/msal-dotnet-articles/advanced/extract-authentication-parameters.md
@@ -1,6 +1,7 @@
 ---
 title: Extract authentication parameters from WWW-Authenticate headers
 description: "This article is both a conceptual article of why you'd want to get information from WWW-authenticate headers, and how to do it."
+ms.date: 03/17/2025
 ---
 
 # Extract authentication parameters from WWW-Authenticate headers
diff --git a/msal-dotnet-articles/advanced/high-availability.md b/msal-dotnet-articles/advanced/high-availability.md
@@ -1,6 +1,7 @@
 ---
 title: High availability considerations in MSAL.NET
-description: Explore high availability considerations in MSAL.NET, including token cache, monitoring MSAL operations, logging, retry policy, and certificate rotation. Learn more now.
+description: Explore high availability considerations in MSAL.NET, including token cache, monitoring MSAL operations, logging, retry policy, and certificate rotation.
+ms.date: 03/17/2025
 ---
 
 # High availability considerations in MSAL.NET
diff --git a/msal-dotnet-articles/advanced/httpclient.md b/msal-dotnet-articles/advanced/httpclient.md
@@ -1,6 +1,7 @@
 ---
 title: Providing your own HttpClient, supporting HTTP proxies, and customization of user agent headers
 description: "There are cases where developers want fine-grained control of the HttpClient instance, such as configuring a proxy or using ASP.NET Core's efficient ways of pooling the HttpClient."
+ms.date: 03/17/2025
 ---
 
 # Providing your own HttpClient, supporting HTTP proxies, and customization of user agent headers
diff --git a/msal-dotnet-articles/advanced/managed-identity.md b/msal-dotnet-articles/advanced/managed-identity.md
@@ -1,6 +1,7 @@
 ---
 title: Managed identity with MSAL.NET
 description: "How to use Azure managed identities in MSAL.NET applications."
+ms.date: 03/17/2025
 ---
 
 # Managed identity with MSAL.NET
diff --git a/msal-dotnet-articles/advanced/monitoring.md b/msal-dotnet-articles/advanced/monitoring.md
@@ -1,6 +1,7 @@
 ---
 title: Monitoring applications using MSAL.NET
 description: "How to use the metrics provided by MSAL.NET to monitor your application."
+ms.date: 03/17/2025
 ---
 
 # Monitoring applications using MSAL.NET
diff --git a/msal-dotnet-articles/advanced/multicloud-support-instance-awareness.md b/msal-dotnet-articles/advanced/multicloud-support-instance-awareness.md
@@ -1,6 +1,7 @@
 ---
 title: Multicloud support and instance awareness
 description: "The instance awareness feature helps complete the scenario where any an account from any cloud can be signed-in using the default value for environment."
+ms.date: 03/17/2025
 ---
 
 # Multicloud support and instance awareness
diff --git a/msal-dotnet-articles/advanced/performance-testing.md b/msal-dotnet-articles/advanced/performance-testing.md
@@ -1,6 +1,7 @@
 ---
 title: Performance testing of MSAL.NET
 description: Explore performance testing of MSAL.NET with BenchmarkDotNet. Learn to run tests, view results, automate tests, and improve MSAL.NET performance.
+ms.date: 03/17/2025
 ---
 
 # Performance testing of MSAL.NET
diff --git a/msal-dotnet-articles/advanced/powershell-support.md b/msal-dotnet-articles/advanced/powershell-support.md
@@ -1,6 +1,7 @@
 ---
 title: Using MSAL.NET with PowerShell
 description: "How to use MSAL.NET to acquire tokens from a PowerShell script."
+ms.date: 03/17/2025
 ---
 
 # Using MSAL.NET with PowerShell
diff --git a/msal-dotnet-articles/advanced/spa-authorization-code.md b/msal-dotnet-articles/advanced/spa-authorization-code.md
@@ -1,6 +1,7 @@
 ---
 title: Single-page applications (SPA) and authorization codes
 description: "This flow enables confidential client applications to request an additional SPA auth code from the eSTS /token endpoint, and this authorization code can be redeemed silently by the front end running in the browser."
+ms.date: 03/17/2025
 ---
 
 # Single-page applications (SPA) and authorization codes
diff --git a/msal-dotnet-articles/advanced/ssh-certificates.md b/msal-dotnet-articles/advanced/ssh-certificates.md
@@ -1,6 +1,7 @@
 ---
 title: Using SSH certificates with MSAL.NET
 description: "Microsoft Entra ID is capable of issuing SSH certificates instead of bearer tokens."
+ms.date: 03/17/2025
 ---
 
 # Using SSH certificates with MSAL.NET
diff --git a/msal-dotnet-articles/advanced/testing-apps-using-msal.md b/msal-dotnet-articles/advanced/testing-apps-using-msal.md
@@ -1,6 +1,7 @@
 ---
 title: Testing applications using MSAL.NET
 description: "How to test applications that use MSAL.NET for token acquisition."
+ms.date: 03/17/2025
 ---
 
 # Testing applications using MSAL.NET
diff --git a/msal-dotnet-articles/advanced/webview2.md b/msal-dotnet-articles/advanced/webview2.md
@@ -1,6 +1,7 @@
 ---
 title: Using WebView2 with MSAL.NET
 description: "How to use the modern embedded browser based on Microsoft Edge with MSAL.NET applications."
+ms.date: 03/17/2025
 ---
 
 # Using WebView2 with MSAL.NET
diff --git a/msal-dotnet-articles/docfx.json b/msal-dotnet-articles/docfx.json
@@ -44,7 +44,7 @@
       "breadcrumb_path": "/entra/msal/dotnet/breadcrumb/toc.json",
       "extendBreadcrumb": true,
       "uhfHeaderId": "MSDocsHeader-Entra",
-      "feedback_system": "GitHub",
+      "feedback_system": "Standard",
       "feedback_github_repo": "MicrosoftDocs/microsoft-authentication-library-dotnet",
       "feedback_product_url": "https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues",
       "recommendations": true,
diff --git a/msal-dotnet-articles/how-to/build-apps-on-linux-ubuntu.md b/msal-dotnet-articles/how-to/build-apps-on-linux-ubuntu.md
@@ -1,5 +1,7 @@
 ---
 title: Building MSAL.NET applications on Linux
+description: Learn how to build MSAL.NET applications on Linux.
+ms.date: 03/17/2025
 ---
 
 # Building MSAL.NET applications on Linux
diff --git a/msal-dotnet-articles/how-to/cache-options.md b/msal-dotnet-articles/how-to/cache-options.md
@@ -1,5 +1,7 @@
 ---
 title: Cache options in MSAL.NET
+description: Learn to set up shared token cache in MSAL.NET using `EnableSharedCacheOptions`.
+ms.date: 03/17/2025
 ---
 
 # Cache options in MSAL.NET
diff --git a/msal-dotnet-articles/how-to/create-config-for-mam-conditional-access.md b/msal-dotnet-articles/how-to/create-config-for-mam-conditional-access.md
@@ -1,6 +1,7 @@
 ---
 title: Creating configuration for Intune Mobile App Management conditional access
 description: "This scenario includes a backend application, and an iOS and Android client applications. This article describes the steps to correctly configure these applications for Intune MAM."
+ms.date: 03/17/2025
 ---
 
 # Creating configuration for Intune Mobile App Management conditional access
diff --git a/msal-dotnet-articles/how-to/custom-token-cache-in-public-client-applications.md b/msal-dotnet-articles/how-to/custom-token-cache-in-public-client-applications.md
@@ -1,6 +1,7 @@
 ---
 title: Custom token cache for a public client applications
 description: "This article is about custom token cache implementations for public client applications."
+ms.date: 03/17/2025
 ---
 
 # Custom token cache for a public client applications
diff --git a/msal-dotnet-articles/how-to/default-reply-uri.md b/msal-dotnet-articles/how-to/default-reply-uri.md
@@ -1,6 +1,7 @@
 ---
 title: Default reply URI
 description: "How to customize the reply URI in applications using MSAL.NET."
+ms.date: 03/17/2025
 ---
 
 # Default reply URI
diff --git a/msal-dotnet-articles/how-to/get-tenant-profiles.md b/msal-dotnet-articles/how-to/get-tenant-profiles.md
@@ -1,5 +1,7 @@
 ---
 title: Getting tenant profiles with MSAL.NET
+ms.date: 03/17/2025
+description: Learn how to get tenant profiles using MSAL.NET. Authenticate and acquire tokens for different tenants.
 ---
 
 # Getting tenant profiles with MSAL.NET
diff --git a/msal-dotnet-articles/how-to/install-nuget-custom-source.md b/msal-dotnet-articles/how-to/install-nuget-custom-source.md
@@ -1,6 +1,7 @@
 ---
 title: Installing MSAL.NET from custom NuGet package source
 description: "How to install NuGet from a source other than the NuGet package feed."
+ms.date: 03/17/2025
 ---
 
 # Installing MSAL.NET from custom NuGet package source
diff --git a/msal-dotnet-articles/how-to/overriding-authority.md b/msal-dotnet-articles/how-to/overriding-authority.md
diff --git a/msal-dotnet-articles/how-to/protect-ios-android-mam-intune.md b/msal-dotnet-articles/how-to/protect-ios-android-mam-intune.md
diff --git a/msal-dotnet-articles/how-to/synchronous-programming.md b/msal-dotnet-articles/how-to/synchronous-programming.md
diff --git a/msal-dotnet-articles/index.md b/msal-dotnet-articles/index.md
diff --git a/msal-dotnet-articles/resources/handling-pii.md b/msal-dotnet-articles/resources/handling-pii.md
diff --git a/msal-dotnet-articles/resources/known-issues.md b/msal-dotnet-articles/resources/known-issues.md
diff --git a/msal-dotnet-articles/resources/region-discovery-troubleshooting.md b/msal-dotnet-articles/resources/region-discovery-troubleshooting.md
diff --git a/msal-dotnet-articles/resources/semantic-versioning-api-change-management.md b/msal-dotnet-articles/resources/semantic-versioning-api-change-management.md
diff --git a/msal-dotnet-articles/resources/troubleshooting.md b/msal-dotnet-articles/resources/troubleshooting.md
