MicrosoftDocs · microsoft-github-policy-service · Jun 18, 2025 · Jun 18, 2025 · Jun 18, 2025 · Jun 18, 2025
diff --git a/msal-python-conceptual/advanced/aad-b2c.md b/msal-python-conceptual/advanced/aad-b2c.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/client-capabilities.md b/msal-python-conceptual/advanced/client-capabilities.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/client-credentials.md b/msal-python-conceptual/advanced/client-credentials.md
@@ -5,7 +5,7 @@ author: Dickson-Mwendia
 manager: CelesteDG
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/conditional-access.md b/msal-python-conceptual/advanced/conditional-access.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo
@@ -72,4 +72,4 @@ if not result:
     result = app.acquire_token_by_authorization_code(..., claims_challenge=claims_challenge)
 ```
 
-- This new access token can now be used in the request to resource.
+- This new access token can now be used in the request to resource.
diff --git a/msal-python-conceptual/advanced/instance-metadata-caching.md b/msal-python-conceptual/advanced/instance-metadata-caching.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/linux-broker-py-wsl.md b/msal-python-conceptual/advanced/linux-broker-py-wsl.md
@@ -110,8 +110,7 @@ Reference the [Enable SSO in native Linux apps using MSAL Python](./linux-broker
 To use the broker, you will need to install the broker-related packages in addition to the core MSAL from PyPI:
 
 ```python
-pip install msal[broker]>=1.31,<2
-pip install pymsalruntime
+pip install "msal[broker]>=1.33.0b1,<2"
 ```
 
 ### Run the Sample App

diff --git a/msal-python-conceptual/advanced/linux-broker-py.md b/msal-python-conceptual/advanced/linux-broker-py.md
@@ -8,7 +8,7 @@ ms.topic: how-to
 ms.date: 06/03/2025
 ---
 
-# Enable SSSO in native Linux using MSAL Python
+# Enable SSO in native Linux using MSAL Python
 
 Microsoft Authentication Library (MSAL) is a Software Development Kit (SDK) that enables apps to call the Microsoft Single Sign-on to Linux broker, a Linux component that is shipped independent of the Linux Distribution, however it gets installed using a package manager using `sudo apt install microsoft-identity-broker` or `sudo dnf install microsoft-identity-broker`.
 
@@ -46,13 +46,12 @@ An authentication broker is an application that runs on a user’s machine that
     https://login.microsoftonline.com/common/oauth2/nativeclient
     ```
 
-3. To use the broker, you will need to install the broker-related packages in addition to the core MSAL from PyPI:
+1. To use the broker, you will need to install the broker-related packages in addition to the core MSAL from PyPI:
 
     ```python
-    pip install msal[broker]>=1.31,<2
-    pip install pymsalruntime
+    pip install "msal[broker]>=1.33.0b1,<2"
     ```
-
+    
 4. Once configured, you can call `acquire_token_interactive` to acquire a token.
 
     ```python
@@ -97,8 +96,11 @@ MSAL will either error out, or silently fallback to non-broker flows.
 4. MSAL errors out when broker is opted in, installed, initialized, but subsequent token request(s) failed.
 
 >[!IMPORTANT]
->If broker-related packages are not installed and you will try to use the authentication broker, you will get an error: `ImportError: You need to install dependency by: pip install "msal[broker]>=1.31,<2"`.
+>If broker-related packages are not installed and you will try to use the authentication broker, you will get an error: `ImportError: You need to install dependency by: pip install "msal[broker]>=1.xx,<2"`.
 
+<!--
+This one is an error message whose content happens to be changing based on platform. The doc shall just use a placeholder that is good enough.
+-->
 >[!NOTE]
 >The `parent_window_handle` parameter is required even though on Linux it is not used. For GUI applications, the login prompt location will be determined ad-hoc and currently cannot be bound to a specific window. In a future update, this parameter will be used to determine the _actual_ parent window.
 
@@ -151,8 +153,7 @@ sudo dnf install python3 python3-pip -y
 To use the broker, you will need to install the broker-related packages in addition to the core MSAL from PyPI:
 
 ```python
-pip install msal[broker]>=1.31,<2
-pip install pymsalruntime
+pip install "msal[broker]>=1.33.0b1,<2"
 ```
 
 ### Create Project

diff --git a/msal-python-conceptual/advanced/logging.md b/msal-python-conceptual/advanced/logging.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/macos-broker.md b/msal-python-conceptual/advanced/macos-broker.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 09/06/2024
 ms.author: shermanouko
 ms.reviewer: dmwendia, rayluo

diff --git a/msal-python-conceptual/advanced/managed-identity.md b/msal-python-conceptual/advanced/managed-identity.md
@@ -5,7 +5,7 @@ author: SHERMANOUKO
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 06/25/2024
 ms.author: shermanouko
 ms.reviewer: rayluo, dmwendia

diff --git a/msal-python-conceptual/advanced/migrate-python-adal-msal.md b/msal-python-conceptual/advanced/migrate-python-adal-msal.md
@@ -5,7 +5,7 @@ author: Dickson-Mwendia
 manager: CelesteDG
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: upgrade-and-migration-article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/migrate.md b/msal-python-conceptual/advanced/migrate.md
@@ -5,7 +5,7 @@ author: Dickson-Mwendia
 manager: CelesteDG
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: upgrade-and-migration-article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/msal-error-handling-python.md b/msal-python-conceptual/advanced/msal-error-handling-python.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/msal-logging-python.md b/msal-python-conceptual/advanced/msal-logging-python.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo
@@ -99,4 +99,4 @@ MSAL for Python does not log personal data or organizational data. There is no p
 
 You can use standard Python logging to log whatever you want, but you are responsible for safely handling sensitive data and following regulatory requirements.
 
-For more information about logging in Python, please refer to Python's  [Logging: how-to](https://docs.python.org/3/howto/logging.html#logging-basic-tutorial).
+For more information about logging in Python, please refer to Python's  [Logging: how-to](https://docs.python.org/3/howto/logging.html#logging-basic-tutorial).
diff --git a/msal-python-conceptual/advanced/msal-python-adfs-support.md b/msal-python-conceptual/advanced/msal-python-adfs-support.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/msal-python-token-cache-serialization.md b/msal-python-conceptual/advanced/msal-python-token-cache-serialization.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo
@@ -31,4 +31,4 @@ For web apps or web APIs, you might use the session, or a Redis cache, or a data
 
 ## Next steps
 
-See [ms-identity-python-webapp](https://github.com/Azure-Samples/ms-identity-python-webapp/blob/0.3.0/app.py#L66-L74) for an example of how to use the token cache for a Windows or Linux Web app or web API. The example is for a web app that calls the Microsoft Graph API.
+See [ms-identity-python-webapp](https://github.com/Azure-Samples/ms-identity-python-webapp/blob/0.3.0/app.py#L66-L74) for an example of how to use the token cache for a Windows or Linux Web app or web API. The example is for a web app that calls the Microsoft Graph API.
diff --git a/msal-python-conceptual/advanced/username-password-authentication.md b/msal-python-conceptual/advanced/username-password-authentication.md
@@ -5,7 +5,7 @@ author: Dickson-Mwendia
 manager: CelesteDG
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 02/07/2024
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/advanced/wam.md b/msal-python-conceptual/advanced/wam.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 04/24/2025
 ms.author: dmwendia
 ms.reviewer: shermanouko, rayluo

diff --git a/msal-python-conceptual/getting-started/acquiring-tokens.md b/msal-python-conceptual/getting-started/acquiring-tokens.md
@@ -5,7 +5,7 @@ author: SHERMANOUKO
 manager: CelesteDG
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 04/24/2025
 ms.author: shermanouko
 ms.reviewer: dmwendia, rayluo

diff --git a/msal-python-conceptual/getting-started/client-applications.md b/msal-python-conceptual/getting-started/client-applications.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 04/24/2025
 ms.author: shermanouko 
 ms.reviewer: dmwendia, rayluo

diff --git a/msal-python-conceptual/index.md b/msal-python-conceptual/index.md
@@ -6,7 +6,7 @@ manager: CelesteDG
 
 ms.service: msal
 ms.subservice: msal-python
-ms.topic: conceptual
+ms.topic: article
 ms.date: 04/24/2025
 ms.author: shermanouko
 ms.reviewer: dmwendia, rayluo