Add doc about linux broker on dotnet scenario #646

xinyuxu1026 · 2025-05-06T17:45:25Z

No description provided.

learn-build-service-prod · 2025-05-06T18:54:18Z

Learn Build status updates of commit 83ccb15:

✅ Validation status: passed

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

DharshanBJ · 2025-05-06T20:17:28Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+
+## Dependency
+
+To use the broker, you will need to install a list of dependencies on Linux platform


Should we also include a step that explains how to install msalruntime nuget package for linux as it is a necessary step for broker support

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

…ker-net.md

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

…ker-net.md

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

learn-build-service-prod · 2025-05-06T22:46:31Z

Learn Build status updates of commit d83a3a4:

✅ Validation status: passed

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

learn-build-service-prod · 2025-05-06T22:48:51Z

Learn Build status updates of commit 4a28d7e:

✅ Validation status: passed

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

learn-build-service-prod · 2025-05-06T22:51:33Z

Learn Build status updates of commit 23e7903:

✅ Validation status: passed

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

ploegert · 2025-05-07T16:37:06Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+
+## Prerequisites
+
+To use the broker, you'll need to install a list of dependencies on the Linux platform:


We should also note/link to the user on the fact that dotnet is required to be installed for the sample. Perhaps we can consolidate a "prep step" that calls out below:

sudo apt install seahorse libx11-dev

Hi Justin, I added the .net installation part and the version requirement, could you help take a look again? Thanks

learn-build-service-prod · 2025-05-07T23:53:22Z

Learn Build status updates of commit 934edbc:

💡 Validation status: suggestions

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	💡Suggestion	View	Details
msal-dotnet-articles/media/msal-net-linux/password-keyring-seahorse.png	✅Succeeded	View

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

Line 28, Column 311: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/dotnet/core/install/linux-ubuntu-decision#register-the-microsoft-package-repository' will be broken in isolated environments. Replace with a relative link.
Line 28, Column 488: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/dotnet/core/install/linux-ubuntu-decision#dependencies' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

learn-build-service-prod · 2025-05-08T18:37:17Z

Learn Build status updates of commit ddffeae:

✅ Validation status: passed

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/password-keyring-seahorse.png	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

learn-build-service-prod · 2025-05-08T18:39:18Z

Learn Build status updates of commit 749cb8d:

✅ Validation status: passed

File	Status	Preview URL	Details
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/password-keyring-seahorse.png	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

learn-build-service-prod · 2025-05-08T18:48:12Z

Learn Build status updates of commit 65ce187:

✅ Validation status: passed

File	Status	Preview URL
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/choose-password.png	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/close-keyring-window.png	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/create-keyring-named-login.png	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/password-keyring-seahorse.png	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

learn-build-service-prod · 2025-05-09T18:17:22Z

Learn Build status updates of commit b5c37a3:

✅ Validation status: passed

File	Status	Preview URL
msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/choose-password.png	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/close-keyring-window.png	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/create-keyring-named-login.png	✅Succeeded	View
msal-dotnet-articles/media/msal-net-linux/password-keyring-seahorse.png	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel

scottaddie · 2025-05-12T20:15:26Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+> [!NOTE]
+> Microsoft single sign-on (SSO) for Linux authentication broker support is introduced with `Microsoft.Identity.Client` version v4.69.1.


I think this note should be removed. Instead, add the following .NET CLI commands to the Prereqs section below with minimum required versions:

dotnet add package Microsoft.Identity.Client
dotnet add package Microsoft.Identity.Client.Broker

scottaddie · 2025-05-12T20:28:42Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+
+## Prerequisites
+
+MSAL.NET project requires .NET version greater or equal than the version specified in [global.json](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/global.json) file, we recommend register the Microsoft package repository and install .NET, please follow the instructions here: [Install .NET on Ubuntu](/dotnet/core/install/linux-ubuntu-decision#register-the-microsoft-package-repository). And please make sure you have all the [.NET required dependencies](/dotnet/core/install/linux-ubuntu-decision#dependencies) installed.


It isn't clear to me why I should care about what the MSAL.NET project requires.

I like the part in which it recommends registering the Microsoft Package Repo and install .NET from it, cause Ubuntu has its own feed and it took me a while to install net8.0.4.

scottaddie · 2025-05-12T20:29:15Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+}
+```
+
+We recommend play with the sample app using your client id. To run the sample app, use the following command:


Suggested change

We recommend play with the sample app using your client id. To run the sample app, use the following command:

We recommend playing with the sample app using your client ID. To run the sample app, use the following command:

scottaddie · 2025-05-12T20:29:58Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+On Debian-based distributions, you can install the package by running `sudo apt install seahorse` and then following these instructions:
+
+1. Run `seahorse` in the terminal.
+2. In the top left corner, click **+** and create **Password** keyring. 


Suggested change

2. In the top left corner, click **+** and create **Password** keyring.

2. In the top left corner, select **+** and create **Password** keyring.

JonathanCrd · 2025-05-12T23:21:54Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

 Using an authentication broker on Linux enables you to simplify how your users authenticate with Microsoft Entra ID from your application, as well as take advantage of future functionality that protects Microsoft Entra ID refresh tokens from exfiltration and misuse.

-Authentication brokers are **not** pre-installed on Linux but is bundled as a dependency of applications developed by Microsoft, such as [Company Portal](/mem/intune-service/user-help/enroll-device-linux). These applications are usually installed when a Linux computer is enrolled in a company's device fleet via an endpoint management solution like [Microsoft Intune](/mem/intune/fundamentals/what-is-intune). To learn more about Linux device set up with the Microsoft Identity Platform, refer to [Microsoft Enterprise SSO plug-in for Apple devices](/entra/identity-platform/apple-sso-plugin).
+An authentication broker is **not** pre-installed on standalone Linux but is bundled as a dependency of applications developed by Microsoft, such as [Company Portal](/mem/intune-service/user-help/enroll-device-linux). These applications are usually installed when a Linux computer is enrolled in a company's device fleet via an endpoint management solution like [Microsoft Intune](/mem/intune/fundamentals/what-is-intune). For [Windows Subsystem for Linux](/windows/wsl/about) (WSL) scenario, WAM (Windows Account Manager) is used as the broker. WAM does come pre-installed on the Windows system. To learn more about Linux device set up with the Microsoft Identity Platform, see [Microsoft Enterprise SSO plug-in for Apple devices](/entra/identity-platform/apple-sso-plugin).


To learn more about Linux device set up with the Microsoft Identity Platform, see Microsoft Enterprise SSO plug-in for Apple devices.

Could you clarify how this doc for Apple devices is helpful for Linux machines?

JonathanCrd · 2025-05-12T23:27:43Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

+
+## Prerequisites
+
+MSAL.NET project requires .NET version greater or equal than the version specified in [global.json](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/global.json) file, we recommend register the Microsoft package repository and install .NET, please follow the instructions here: [Install .NET on Ubuntu](/dotnet/core/install/linux-ubuntu-decision#register-the-microsoft-package-repository). And please make sure you have all the [.NET required dependencies](/dotnet/core/install/linux-ubuntu-decision#dependencies) installed.


I like the part in which it recommends registering the Microsoft Package Repo and install .NET from it, cause Ubuntu has its own feed and it took me a while to install net8.0.4.

JonathanCrd · 2025-05-12T23:31:44Z

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md

 ```

 ### Set up Keyring in WSL
-We use libsecret on Linux and it needs to communicate with keyring daemon. Users can use `seahorse`(gnome GUI) package to manage the keyring with a user interface. You need to first install the package by `apt install seahorse` and then follow the instructions below.
+MSAL uses `libsecret` on Linux. It is required to communicate with the `keyring` daemon. Users can use [Seahorse](https://wiki.gnome.org/Apps/Seahorse/) (a GNOME application for managing encryption keys and passwords) to manage the `keyring` contents through a Graphical User Interface (GUI).


It could be helpful to add more details on how Keyring plays a role with the library and WAM. Keyring might be confused with WAM in some way.

add doc about linux broker on dotnet scenario

c631925

xinyuxu1026 requested review from localden and jmprieur as code owners May 6, 2025 17:45

This comment was marked as outdated.

Sign in to view

add more info

ffa809e

This comment was marked as outdated.

Sign in to view

update author

83ccb15

DharshanBJ reviewed May 6, 2025

View reviewed changes

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md Outdated Show resolved Hide resolved

DharshanBJ reviewed May 6, 2025

View reviewed changes

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md Outdated Show resolved Hide resolved

DharshanBJ reviewed May 6, 2025

View reviewed changes

scottaddie suggested changes May 6, 2025

View reviewed changes

localden and others added 5 commits May 6, 2025 13:29

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

2be64ed

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

3c184e4

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

e30b448

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

182fe07

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

e425098

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

scottaddie reviewed May 6, 2025

View reviewed changes

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md Outdated Show resolved Hide resolved

This comment was marked as outdated.

Sign in to view

localden requested changes May 6, 2025

View reviewed changes

localden and others added 10 commits May 6, 2025 13:41

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

d0b2baf

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

2099411

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

2fca0c8

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

17e2eb3

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

ae7f038

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

269356c

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

82e796f

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

5907d42

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

2e29b6e

…ker-net.md

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

c973e74

…ker-net.md

scottaddie reviewed May 6, 2025

View reviewed changes

xinyuxu1026 and others added 9 commits May 6, 2025 15:43

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

d83a3a4

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

384f135

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

837040d

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

4a28d7e

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

fe81a0e

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

bac9b31

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

d1bee1e

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

904d17c

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

ee47017

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

address comments

23e7903

ploegert reviewed May 7, 2025

View reviewed changes

add screenshot and .net install

934edbc

scottaddie reviewed May 8, 2025

View reviewed changes

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md Outdated Show resolved Hide resolved

scottaddie suggested changes May 8, 2025

View reviewed changes

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md Outdated Show resolved Hide resolved

xinyuxu1026 and others added 2 commits May 8, 2025 11:35

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

ddffeae

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

Update msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-bro…

749cb8d

…ker-net.md Co-authored-by: Scott Addie <[email protected]>

add more screenshot

65ce187

ploegert reviewed May 9, 2025

View reviewed changes

msal-dotnet-articles/acquiring-tokens/desktop-mobile/linux-broker-net.md Show resolved Hide resolved

more update

b5c37a3

scottaddie reviewed May 12, 2025

View reviewed changes

JonathanCrd reviewed May 12, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add doc about linux broker on dotnet scenario #646

Add doc about linux broker on dotnet scenario #646

xinyuxu1026 commented May 6, 2025

This comment was marked as outdated.

This comment was marked as outdated.

learn-build-service-prod bot commented May 6, 2025

DharshanBJ May 6, 2025

This comment was marked as outdated.

learn-build-service-prod bot commented May 6, 2025

learn-build-service-prod bot commented May 6, 2025

learn-build-service-prod bot commented May 6, 2025

ploegert May 7, 2025

xinyuxu1026 May 7, 2025

learn-build-service-prod bot commented May 7, 2025

learn-build-service-prod bot commented May 8, 2025

learn-build-service-prod bot commented May 8, 2025

learn-build-service-prod bot commented May 8, 2025

learn-build-service-prod bot commented May 9, 2025

scottaddie May 12, 2025

scottaddie May 12, 2025

JonathanCrd May 12, 2025

scottaddie May 12, 2025

scottaddie May 12, 2025

JonathanCrd May 12, 2025

JonathanCrd May 12, 2025

JonathanCrd May 12, 2025


		## Dependency

		To use the broker, you will need to install a list of dependencies on Linux platform


		## Prerequisites

		To use the broker, you'll need to install a list of dependencies on the Linux platform:

		> [!NOTE]
		> Microsoft single sign-on (SSO) for Linux authentication broker support is introduced with `Microsoft.Identity.Client` version v4.69.1.


		## Prerequisites

		MSAL.NET project requires .NET version greater or equal than the version specified in [global.json](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/global.json) file, we recommend register the Microsoft package repository and install .NET, please follow the instructions here: [Install .NET on Ubuntu](/dotnet/core/install/linux-ubuntu-decision#register-the-microsoft-package-repository). And please make sure you have all the [.NET required dependencies](/dotnet/core/install/linux-ubuntu-decision#dependencies) installed.

	We recommend play with the sample app using your client id. To run the sample app, use the following command:
	We recommend playing with the sample app using your client ID. To run the sample app, use the following command:

	2. In the top left corner, click + and create Password keyring.
	2. In the top left corner, select + and create Password keyring.

Add doc about linux broker on dotnet scenario #646

Are you sure you want to change the base?

Add doc about linux broker on dotnet scenario #646

Conversation

xinyuxu1026 commented May 6, 2025

This comment was marked as outdated.

This comment was marked as outdated.

learn-build-service-prod bot commented May 6, 2025

✅ Validation status: passed

Choose a reason for hiding this comment

This comment was marked as outdated.

learn-build-service-prod bot commented May 6, 2025

✅ Validation status: passed

learn-build-service-prod bot commented May 6, 2025

✅ Validation status: passed

learn-build-service-prod bot commented May 6, 2025

✅ Validation status: passed

Choose a reason for hiding this comment

Choose a reason for hiding this comment

learn-build-service-prod bot commented May 7, 2025

💡 Validation status: suggestions

learn-build-service-prod bot commented May 8, 2025

✅ Validation status: passed

learn-build-service-prod bot commented May 8, 2025

✅ Validation status: passed

learn-build-service-prod bot commented May 8, 2025

✅ Validation status: passed

learn-build-service-prod bot commented May 9, 2025

✅ Validation status: passed

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment