Skip to content

Commit 46ef799

Browse files
Merge pull request #215586 from cilwerner/patch-1
[msid][content-health] scenario-web-app-call-api-overview.md (ADO-2002424)
2 parents 149a9c9 + 126f5bb commit 46ef799

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

articles/active-directory/develop/scenario-web-api-call-api-overview.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ ms.service: active-directory
99
ms.subservice: develop
1010
ms.topic: conceptual
1111
ms.workload: identity
12-
ms.date: 03/03/2021
12+
ms.date: 10/24/2022
1313
ms.author: jmprieur
14-
ms.custom: aaddev, identityplatformtop40
14+
ms.custom: aaddev, identityplatformtop40, engagement-fy23
1515
#Customer intent: As an application developer, I want to know how to write a web API that calls web APIs by using the Microsoft identity platform.
1616
---
1717

@@ -27,11 +27,12 @@ This scenario, in which a protected web API calls other web APIs, builds on [Sce
2727

2828
- A web, desktop, mobile, or single-page application client (not represented in the accompanying diagram) calls a protected web API and provides a JSON Web Token (JWT) bearer token in its "Authorization" HTTP header.
2929
- The protected web API validates the token and uses the Microsoft Authentication Library (MSAL) `AcquireTokenOnBehalfOf` method to request another token from Azure Active Directory (Azure AD) so that the protected web API can call a second web API, or downstream web API, on behalf of the user. `AcquireTokenOnBehalfOf` refreshes the token when needed.
30-
![Diagram of a web API calling a web API](media/scenarios/web-api.svg)
30+
31+
![Diagram of a web app calling a web API.](media/scenarios/web-api.svg)
3132

3233
## Specifics
3334

34-
The app registration part that's related to API permissions is classical. The app configuration involves using the OAuth 2.0 On-Behalf-Of flow to use the JWT bearer token for obtaining a second token for a downstream API. The second token in this case is added to the token cache, where it's available in the web API's controllers. This second token can be used to acquire an access token silently to call downstream APIs whenever required.
35+
The app registration part that's related to API permissions is classical. The app configuration involves using the [OAuth 2.0 On-Behalf-Of flow](v2-oauth2-on-behalf-of-flow.md) to use the JWT bearer token for obtaining a second token for a downstream API. The second token is added to the token cache, where it's available in the web API's controllers. This second token can be used to acquire an access token silently to call downstream APIs whenever required.
3536

3637
## Next steps
3738

0 commit comments

Comments
 (0)