You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/logic-apps/set-up-authentication-agent-workflows.md
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Protect Agent Workflows with Easy Auth
3
-
description: Learn to set up conversational agent workflows with App Service Authentication (Easy Auth) in Azure Logic Apps.
2
+
title: Protect Agentic Workflows with Easy Auth
3
+
description: Set up conversational agentic workflows with App Service Authentication (Easy Auth) in Azure Logic Apps.
4
4
author: ecfan
5
5
services: logic-apps
6
6
ms.suite: integration
@@ -9,10 +9,10 @@ ms.topic: how-to
9
9
ms.collection: ce-skilling-ai-copilot
10
10
ms.date: 10/08/2025
11
11
ms.update-cycle: 180-days
12
-
#Customer intent: As an integration and AI developer working with Azure Logic Apps, I want to secure access to my conversational agent workflow and external chat client by authenticating and authorizing users through Easy Auth.
12
+
#Customer intent: As an integration and AI developer working with Azure Logic Apps, I want to secure access to my conversational agentic workflow and external chat client by authenticating and authorizing users through Easy Auth.
13
13
---
14
14
15
-
# Secure conversational agent workflows with Easy Auth (App Service Authentication) in Azure Logic Apps (Preview)
15
+
# Secure conversational agentic workflows with Easy Auth (App Service Authentication) in Azure Logic Apps (Preview)
> This capability is in preview and is subject to the
22
22
> [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
23
23
24
-
Agent workflows expand integration options because they can exchange messages with more diverse callers, such as people, agents, Model Context Protocol (MCP) servers and clients, tool brokers, and external services. While nonagent workflows interact with a small, known, and fixed set of callers, agent callers can come from dynamic, unknown, and untrusted networks. As a result, you must authenticate and enforce permissions for each caller.
24
+
Agentic workflows expand integration options because they can exchange messages with more diverse callers, such as people, agents, Model Context Protocol (MCP) servers and clients, tool brokers, and external services. While nonagentic workflows interact with a small, known, and fixed set of callers, clients that call agentic workflows can come from dynamic, unknown, and untrusted networks. As a result, you must authenticate and enforce permissions for each caller.
25
25
26
-
To help protect conversational agent workflows in production, set up Easy Auth to authenticate and authorize callers or people who want to interact with your conversational agent. Easy Auth, also known as App Service Authentication, provides following capabilities for you to use:
26
+
To help protect conversational agentic workflows in production, set up Easy Auth to authenticate and authorize callers or people who want to interact with your conversational agent. Easy Auth, also known as App Service Authentication, provides following capabilities for you to use:
27
27
28
28
- Provide a validated identity for each caller request.
29
29
- Assign connections to each user.
@@ -34,11 +34,11 @@ To help protect conversational agent workflows in production, set up Easy Auth t
34
34
35
35
These measures let you authenticate and authorize each caller at a fine-grained level and revoke access quickly when needed. Without these controls, you risk uncontrolled access, leaked secrets such as shared access signature (SAS) URLs and access keys, weak audit trails, and other security hazards.
36
36
37
-
Easy Auth works with Microsoft Entra ID as a separate security layer to provide built-in authentication and authorization capabilities that meet your needs. With security enforcement operating outside your workflow, you can focus more on developing the business logic instead. This separation of concerns makes agent workflows simpler and easier to build, debug, operate, monitor, maintain, govern, and audit.
37
+
Easy Auth works with Microsoft Entra ID as a separate security layer to provide built-in authentication and authorization capabilities that meet your needs. With security enforcement operating outside your workflow, you can focus more on developing the business logic instead. This separation of concerns makes agentic workflows simpler and easier to build, debug, operate, monitor, maintain, govern, and audit.
38
38
39
-
Nonagent workflow security usually involves static SAS, rotating secrets, and network boundary controls like access restrictions, IP allowlists, service tags, virtual network integration, and private endpoints. With agent workflows, you design authorization around end users, managed identities, service principals, and their scopes and roles. This approach enables safer global reach but still allows downstream workflow actions to respect fine-grained permissions.
39
+
Nonagentic workflow security usually involves static SAS, rotating secrets, and network boundary controls like access restrictions, IP allowlists, service tags, virtual network integration, and private endpoints. With agentic workflows, you design authorization around end users, managed identities, service principals, and their scopes and roles. This approach enables safer global reach but still allows downstream workflow actions to respect fine-grained permissions.
40
40
41
-
This guide shows how to create an app registration and then set up Easy Auth for your Standard logic app resource, which can contain agent and nonagent workflows.
41
+
This guide shows how to create an app registration and then set up Easy Auth for your Standard logic app resource, which can contain agentic and nonagentic workflows.
42
42
43
43
> [!IMPORTANT]
44
44
>
@@ -48,7 +48,7 @@ This guide shows how to create an app registration and then set up Easy Auth for
48
48
49
49
For more information, see the following articles:
50
50
51
-
-[Built-in authentication and authorization with Easy Auth for agent workflows](agent-workflows-concepts.md#easy-auth)
51
+
-[Built-in authentication and authorization with Easy Auth for agentic workflows](agent-workflows-concepts.md#easy-auth)
52
52
-[Register an application in Microsoft Entra ID](/entra/identity-platform/quickstart-register-app)
53
53
54
54
## Prerequisites
@@ -57,9 +57,9 @@ For more information, see the following articles:
57
57
58
58
- Microsoft Entra [**Application Developer** built-in role](/entra/identity/role-based-access-control/permissions-reference#application-developer) on your Azure account to create an app registration.
59
59
60
-
- A deployed Standard logic app resource with a conversational agent workflow.
60
+
- A deployed Standard logic app resource with a conversational agentic workflow.
61
61
62
-
For more information, see [Create conversational agent workflows for chat interactions in Azure Logic Apps](create-conversational-agent-workflows.md).
62
+
For more information, see [Create conversational agentic workflows for chat interactions in Azure Logic Apps](create-conversational-agent-workflows.md).
63
63
64
64
- Azure [**Contributor** role](/azure/role-based-access-control/built-in-roles#contributor) or higher on the logic app resource with permission to create app registrations for the target tenant using Microsoft Entra.
65
65
@@ -277,7 +277,7 @@ If you have to reuse an existing app registration that is shared with another AP
277
277
278
278
## Test and validate Easy Auth setup
279
279
280
-
After you set up Easy Auth, the internal chat interface on your workflow's **Chat** page in the Azure portal becomes unavailable. Instead, you must interact with your conversational agent by using the external chat client that is available outside the Azure portal. To confirm that Easy Auth works as expected, perform your testing in the external chat client by following these steps:
280
+
After you set up Easy Auth, the internal chat interface on your workflow's **Chat** page in the Azure portal becomes unavailable. Instead, you must interact with your conversational agent loop by using the external chat client that is available outside the Azure portal. To confirm that Easy Auth works as expected, perform your testing in the external chat client by following these steps:
281
281
282
282
1. On the designer toolbar or the workflow sidebar, select **Chat**.
283
283
@@ -327,4 +327,4 @@ For more information, see the following articles:
327
327
328
328
## Related content
329
329
330
-
-[Authentication and authorization in AI agent workflows](agent-workflows-concepts.md#authentication-and-authorization)
330
+
-[Authentication and authorization in AI agentic workflows](agent-workflows-concepts.md#authentication-and-authorization)
Copy file name to clipboardExpand all lines: articles/logic-apps/set-up-on-behalf-of-user-flow.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -121,7 +121,7 @@ The following table describes best practices to consider for OBO flow scenarios:
121
121
| Concept | Description |
122
122
|---------|-------------|
123
123
| Mixed identity patterns | Set up OBO authorization for read-only operations. Use app-only authorization for write operations with explicit confirmation. |
124
-
| Clear feedback | Instruct the agent to briefly summarize permission errors and suggest remediation like `You might not have access to this mailbox.`|
124
+
| Clear feedback | Instruct the agent loop to briefly summarize permission errors and suggest remediation like `You might not have access to this mailbox.`|
125
125
| Auditing and logging | Track and analyze the tools that run and the identities they use by reviewing the workflow run history and metrics. |
126
126
127
127
## Part 1 - Set up OBO flow on tool actions
@@ -180,7 +180,7 @@ The following steps show how to set up OBO authorization after you select an OBO
180
180
181
181
1. In the **Description** box, enter a concise but useful tool description that describes the purpose and guidance about the data that the tool works on.
182
182
183
-
The tool description helps the agent choose the correct tool when fulfilling requested tasks.
183
+
The tool description helps the agent loop choose the correct tool when fulfilling requested tasks.
184
184
185
185
This example uses `Gets the 10 most recent emails from the Inbox for the signed-in user.`
186
186
@@ -192,7 +192,7 @@ The following steps show how to set up OBO authorization after you select an OBO
192
192
193
193
## Part 2 - Test OBO flow with one user
194
194
195
-
The first time when the agent calls a tool that runs an action set up with per-user connections, the chat user gets an authentication prompt to sign in with their credentials. After the user signs in, reauthentication is required for later calls to the same tool with the same per-user connection.
195
+
The first time when the agent loop calls a tool that runs an action set up with per-user connections, the chat user gets an authentication prompt to sign in with their credentials. After the user signs in, reauthentication is required for later calls to the same tool with the same per-user connection.
196
196
197
197
The following steps describe how to confirm that your OBO flow setup works as expected:
198
198
@@ -204,7 +204,7 @@ The following steps describe how to confirm that your OBO flow setup works as ex
204
204
205
205
This example asks the following question: `What unread emails do I have?`
206
206
207
-
If the agent is calling the tool for the first time, the chat interface prompts you to sign in for authentication, for example:
207
+
If the agent loop is calling the tool for the first time, the chat interface prompts you to sign in for authentication, for example:
208
208
209
209
:::image type="content" source="media/set-up-on-behalf-of-user-flow/chat-sign-in-prompt.png" alt-text="Screenshot shows internal chat interface with test question and authentication prompt." lightbox="media/set-up-on-behalf-of-user-flow/chat-sign-in-prompt.png":::
210
210
@@ -214,15 +214,15 @@ The following steps describe how to confirm that your OBO flow setup works as ex
The agent now returns a summary with unread emails in the chat interface.
217
+
The agent loop now returns a summary with unread emails in the chat interface.
218
218
219
219
## Part 3 - Test OBO flow with two different users
220
220
221
221
After you test your OBO flow with a single user, try testing with two users that have different permissions. Before you start, make sure to meet the [prerequisites for the two-user test scenario](#prerequisites).
222
222
223
223
1. Follow the [general steps](set-up-authentication-agent-workflows.md#external-chat-client) to open the external chat client outside the Azure portal,
224
224
225
-
1. In the chat interface, start a session as a user with permissions, and ask the agent to perform a task that requires authorization.
225
+
1. In the chat interface, start a session as a user with permissions, and ask the agent loop to perform a task that requires authorization.
226
226
227
227
This example asks the same question from the single-user scenario: `What unread emails do I have?`
0 commit comments