From 9a79f102ffc371bc432b48b3a8034c8979332de2 Mon Sep 17 00:00:00 2001 From: Justin Ploegert Date: Wed, 18 Jun 2025 14:07:13 -0500 Subject: [PATCH 1/6] Learn Editor: Update linux-broker-py.md --- msal-python-conceptual/advanced/linux-broker-py.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/msal-python-conceptual/advanced/linux-broker-py.md b/msal-python-conceptual/advanced/linux-broker-py.md index 26660fe8..6f75494f 100644 --- 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 @@ -98,7 +97,6 @@ MSAL will either error out, or silently fallback to non-broker flows. >[!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"`. - >[!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 +149,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 From 89361b20804bbc8f50c96a2d0f9441e6b2b359f7 Mon Sep 17 00:00:00 2001 From: Justin Ploegert Date: Wed, 18 Jun 2025 14:08:02 -0500 Subject: [PATCH 2/6] Learn Editor: Update linux-broker-py-wsl.md --- msal-python-conceptual/advanced/linux-broker-py-wsl.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/msal-python-conceptual/advanced/linux-broker-py-wsl.md b/msal-python-conceptual/advanced/linux-broker-py-wsl.md index 9b48252f..b9ed9029 100644 --- 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 From 8a550e2fc4992c462907b185f295a1f673ee175f Mon Sep 17 00:00:00 2001 From: Justin Ploegert Date: Wed, 18 Jun 2025 14:08:08 -0500 Subject: [PATCH 3/6] Learn Editor: Update linux-broker-py-wsl.md From da64178f2d201b8ed0b67d00e5b393f1acfbee49 Mon Sep 17 00:00:00 2001 From: Justin Ploegert Date: Wed, 18 Jun 2025 16:33:54 -0500 Subject: [PATCH 4/6] Update msal-python-conceptual/advanced/linux-broker-py.md Co-authored-by: Ray Luo --- msal-python-conceptual/advanced/linux-broker-py.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/msal-python-conceptual/advanced/linux-broker-py.md b/msal-python-conceptual/advanced/linux-broker-py.md index 6f75494f..c7e9b67d 100644 --- a/msal-python-conceptual/advanced/linux-broker-py.md +++ b/msal-python-conceptual/advanced/linux-broker-py.md @@ -49,7 +49,7 @@ An authentication broker is an application that runs on a user’s machine that 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.33.0b1,<2" + pip install "msal[broker]>=1.33.0b1,<2" ``` 4. Once configured, you can call `acquire_token_interactive` to acquire a token. From b1b9a8b1102928c51eece18877f49bd84b2f9e20 Mon Sep 17 00:00:00 2001 From: Justin Ploegert Date: Wed, 18 Jun 2025 16:34:06 -0500 Subject: [PATCH 5/6] Update msal-python-conceptual/advanced/linux-broker-py.md Co-authored-by: Ray Luo --- msal-python-conceptual/advanced/linux-broker-py.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/msal-python-conceptual/advanced/linux-broker-py.md b/msal-python-conceptual/advanced/linux-broker-py.md index c7e9b67d..32a467fc 100644 --- a/msal-python-conceptual/advanced/linux-broker-py.md +++ b/msal-python-conceptual/advanced/linux-broker-py.md @@ -96,7 +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"`. + + >[!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. From a4640c1cd45ba0e5aa9f0162e289cc5032fba2cf Mon Sep 17 00:00:00 2001 From: Saisang Cai Date: Wed, 16 Jul 2025 15:43:23 +0800 Subject: [PATCH 6/6] Bulk update ms.topic, folder: advanced,getting-started,index.md --- msal-python-conceptual/advanced/aad-b2c.md | 2 +- msal-python-conceptual/advanced/client-capabilities.md | 2 +- msal-python-conceptual/advanced/client-credentials.md | 2 +- msal-python-conceptual/advanced/conditional-access.md | 4 ++-- msal-python-conceptual/advanced/instance-metadata-caching.md | 2 +- msal-python-conceptual/advanced/logging.md | 2 +- msal-python-conceptual/advanced/macos-broker.md | 2 +- msal-python-conceptual/advanced/managed-identity.md | 2 +- msal-python-conceptual/advanced/migrate-python-adal-msal.md | 2 +- msal-python-conceptual/advanced/migrate.md | 2 +- msal-python-conceptual/advanced/msal-error-handling-python.md | 2 +- msal-python-conceptual/advanced/msal-logging-python.md | 4 ++-- msal-python-conceptual/advanced/msal-python-adfs-support.md | 2 +- .../advanced/msal-python-token-cache-serialization.md | 4 ++-- .../advanced/username-password-authentication.md | 2 +- msal-python-conceptual/advanced/wam.md | 2 +- msal-python-conceptual/getting-started/acquiring-tokens.md | 2 +- msal-python-conceptual/getting-started/client-applications.md | 2 +- msal-python-conceptual/index.md | 2 +- 19 files changed, 22 insertions(+), 22 deletions(-) diff --git a/msal-python-conceptual/advanced/aad-b2c.md b/msal-python-conceptual/advanced/aad-b2c.md index c89cd949..b7026934 100644 --- 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 index ceaff7d4..9275bcf7 100644 --- 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 index d9ad3d0f..b9c25bf3 100644 --- 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 index 3d6b280a..2ded2593 100644 --- 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. \ No newline at end of file +- 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 index 06aef538..df8149a6 100644 --- 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/logging.md b/msal-python-conceptual/advanced/logging.md index 6e0ba436..567e385d 100644 --- 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 index 89cd64a2..4809aa3d 100644 --- 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 index c68430e0..00c87642 100644 --- 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 index e6007df4..cbb0ff06 100644 --- 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 index bbbdc774..3c00fe30 100644 --- 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 index 1f741c1f..f4e62787 100644 --- 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 index 0aad10ed..72e96577 100644 --- 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). \ No newline at end of file +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 index 53047ec3..8d828a9b 100644 --- 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 index 862caffb..c0535863 100644 --- 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. \ No newline at end of file +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 index bd3d2a27..06730433 100644 --- 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 index 68686799..bdc33af4 100644 --- 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 index e1103519..23315dcd 100644 --- 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 index de647520..52f235d1 100644 --- 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 index c401f9d1..7d675de4 100644 --- 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