Skip to content

Commit 0e2b487

Browse files
Live Publish (01/27/2025 05:00:00 PM)
2 parents dfd8057 + d299002 commit 0e2b487

File tree

3 files changed

+430
-7
lines changed

3 files changed

+430
-7
lines changed

articles/desktop-flows/alm/alm-connection.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,17 @@ author: nvigne
55
ms.author: nvigne
66
ms.subservice: desktop-flow
77
ms.reviewer: matp
8-
ms.date: 09/06/2023
8+
ms.date: 01/24/2025
99
ms.topic: overview
1010
---
1111

1212
# Create a connection with a service principal
1313

14+
There are two solutions to use a connection with a service principal:
15+
16+
1. Create a connection using the service principal. This article details this solution.
17+
1. Create a connection with a user principal and share it to a service principal. Learn more in [Set a run owner on a Desktop Flow connection](/power-automate/desktop-flows/how-to/set-runowner-desktopflowconnection).
18+
1419
To create a connection with a service principal, the best approach is to register the machine using a [service principal with silent registration](/power-automate/desktop-flows/machines-silent-registration#using-a-service-principal-account). Alternatively, you can give permissions to the service principal on the machine or the machine group and then create a connection using the service principal.
1520

1621
## Give permissions on the machine or machine group

articles/desktop-flows/desktop-flow-connections.md

Lines changed: 44 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Create desktop flow connections
3-
description: See how to create connections to trigger desktop flows from cloud flows.
2+
title: Manage desktop flow connections
3+
description: See how to manage connections to trigger desktop flows from cloud flows.
44
author: mattp123
55
ms.subservice: desktop-flow
66
ms.topic: conceptual
7-
ms.date: 01/08/2025
7+
ms.date: 01/27/2025
88
ms.author: pefelesk
99
ms.reviewer: matp
1010
contributors:
@@ -13,7 +13,7 @@ search.audienceType:
1313
- enduser
1414
---
1515

16-
# Create desktop flow connections
16+
# Manage desktop flow connections
1717

1818
> [!IMPORTANT]
1919
> Before using a machine to run desktop flows from the cloud, ensure that the machine is secured and the machine's admins are trusted.
@@ -31,7 +31,7 @@ Before using the **Run desktop flow** action in your cloud flow to trigger a des
3131
3232
There are two different methods to connect Power Automate with your machines (or groups).
3333

34-
## Connect with username and password
34+
## Create a connection: Connect with username and password
3535

3636
With this option, you need to provide the machine information and device credentials:
3737

@@ -56,7 +56,7 @@ With this option, you need to provide the machine information and device credent
5656

5757
:::image type="content" source="media/desktop-flows-setup/credentials-screen.png" alt-text="Screenshot that shows where to enter the credentials for the connection.":::
5858

59-
## Connect with sign-in for attended runs
59+
## Create a connection: Connect with sign-in for attended runs
6060

6161
With this option, you don't need to provide session credentials. This option might be helpful when your organization doesn't allow username and password for user sessions.
6262

@@ -98,3 +98,41 @@ The desktop flow connection is automatically created.
9898
> If you consistently encounter issues when creating a connection on a new machine, first try to remove it, and then [register it](/power-automate/desktop-flows/manage-machines#register-a-new-machine) again.
9999
100100
[!INCLUDE[footer-include](../includes/footer-banner.md)]
101+
102+
## Share a desktop flow connection (preview)
103+
104+
[!INCLUDE [preview-banner](~/../shared-content/shared/preview-includes/preview-banner.md)]
105+
106+
You can share a connection with other Service Principal users in your organization and give those Service Principal users specific permissions to access it.
107+
108+
[!INCLUDE [preview-note](~/../shared-content/shared/preview-includes/preview-note-pp.md)]
109+
110+
To share a desktop flow connection:
111+
112+
1. Sign in to [Power Automate](https://make.powerautomate.com/).
113+
1. Go to **Monitor** > **Connection**.
114+
1. Select your connection from the list, and then select the **Share** button.
115+
1. Enter the name of the service principal user in your organization with whom you want to share the connection.
116+
1. Select the permissions they can access the connection with:
117+
- Can use
118+
- Can edit
119+
1. Select **Save**.
120+
121+
### Limitations
122+
123+
- You can only share desktop flows with a specified run owner identity. Learn more in [Select a run owner](#select-a-run-owner).
124+
- Recipients of desktop flow connection sharing are limited to service principal users.
125+
- You can't share a desktop flow connection with the "Can Share" permission (only "Can use" or "Can edit").
126+
127+
## Select a run owner
128+
129+
A run owner of a desktop flow is the user whose permissions are checked during the flow execution.
130+
131+
By default, connections created using the Power Automate portal use the connection's creator as the run owner.
132+
133+
You can select a specific identity as the run owner. Learn more in [Set a run owner on a desktop flow connection](/power-automate/desktop-flows/how-to/set-runowner-desktopflowconnection).
134+
135+
## Desktop flow connection audit
136+
137+
You can see the desktop flow run owner on the run status page. Learn more in [Run status](/power-automate/desktop-flows/monitor-run-details#run-status).
138+
You can also see the summary of desktop flow run owner usage on the Desktop Flow activity page. Learn more in [Desktop flow activity](/power-automate/desktop-flows/desktop-flow-activity).

0 commit comments

Comments
 (0)