Skip to content

Commit d6221bd

Browse files
committed
review comments
1 parent 84f731d commit d6221bd

File tree

2 files changed

+28
-16
lines changed

2 files changed

+28
-16
lines changed

articles/api-management/api-management-howto-aad-b2c.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ In this tutorial, you'll learn the configuration required in your API Management
2020

2121
> [!IMPORTANT]
2222
> * This article has been updated with steps to configure an Azure AD B2C app using the Microsoft Authentication Library ([MSAL](../active-directory/develop/msal-overview.md)) v2.0.
23-
> * If you previously configured an Azure AD B2C app for user sign-in using the Azure AD Authentication Library, we recommend that you [migrate to MSAL v2.0](#migrate-to-msal-v2.0).
23+
> * If you previously configured an Azure AD B2C app for user sign-in using the Azure AD Authentication Library (ADAL), we recommend that you [migrate to MSAL](#migrate-to-msal).
2424
2525
For information about enabling access to the developer portal by using classic Azure Active Directory, see [How to authorize developer accounts using Azure Active Directory](api-management-howto-aad.md).
2626

@@ -52,7 +52,7 @@ In this section, you'll create a user flow in your Azure Active Directory B2C te
5252
1. In a separate [Azure portal](https://portal.azure.com) tab, navigate to your API Management instance.
5353
1. Under **Developer portal**, select **Identities** > **+ Add**.
5454
1. In the **Add identity provider** page, select **Azure Active Directory B2C**. Once selected, you'll be able to enter other necessary information.
55-
* In the **Client library** dropdown, select **MSAL v2**.
55+
* In the **Client library** dropdown, select **MSAL**.
5656
* To add other settings, see steps later in the article.
5757
1. In the **Add identity provider** window, copy the **Redirect URL**.
5858

@@ -92,15 +92,21 @@ In this section, you'll create a user flow in your Azure Active Directory B2C te
9292

9393
After the changes are saved, developers will be able to create new accounts and sign in to the developer portal by using Azure Active Directory B2C.
9494

95-
## Migrate to MSAL v2.0
95+
## Migrate to MSAL
9696

97-
If you previously configured an Azure AD B2C app for user sign-in using the Azure AD Authentication Library, you can use the portal to migrate the app to MSAL v2.0.
97+
If you previously configured an Azure AD B2C app for user sign-in using the ADAL, you can use the portal to migrate the app to MSAL and update the identity provider in API Management.
98+
99+
### Update Azure AD B2C app for MSAL compatibility
100+
101+
For steps, see [Switch redirect URIs to the single-page application type](../active-directory/develop/migrate-spa-implicit-to-auth-code.md#switch-redirect-uris-to-spa-platform).
102+
103+
### Update identity provider configuration
98104

99105
1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**.
100106
1. Select **Azure Active Directory B2C** from the list.
101-
4. In the **Client library** dropdown, select **MSAL v2**.
102-
5. Select **Update**.
103-
6. [Republish your developer portal](api-management-howto-developer-portal-customize.md#publish-from-the-azure-portal).
107+
1. In the **Client library** dropdown, select **MSAL**.
108+
1. Select **Update**.
109+
1. [Republish your developer portal](api-management-howto-developer-portal-customize.md#publish-from-the-azure-portal).
104110

105111

106112
## Developer portal - add Azure Active Directory B2C account authentication

articles/api-management/api-management-howto-aad.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@ In this article, you'll learn how to:
1818
> * Manage groups of Azure AD users by adding external groups that contain the users.
1919
2020
> [!IMPORTANT]
21-
> * This article has been updated with steps to configure an Azure AD app using the Microsoft Authentication Library ([MSAL](../active-directory/develop/msal-overview.md)) v2.0.
22-
> * If you previously configured an Azure AD app for user sign-in using the Azure AD Authentication Library, we recommend that you [migrate to MSAL v2.0](#migrate-to-msal-v2.0).
21+
> * This article has been updated with steps to configure an Azure AD app using the Microsoft Authentication Library ([MSAL](../active-directory/develop/msal-overview.md)).
22+
> * If you previously configured an Azure AD app for user sign-in using the Azure AD Authentication Library (ADAL), we recommend that you [migrate to MSAL](#migrate-to-msal).
2323
2424
## Prerequisites
2525

@@ -60,7 +60,7 @@ After the Azure AD provider is enabled:
6060
1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**.
6161
1. Select **+Add** from the top to open the **Add identity provider** pane to the right.
6262
1. Under **Type**, select **Azure Active Directory** from the drop-down menu. Once selected, you'll be able to enter other necessary information.
63-
* In the **Client library** dropdown, select **MSAL v2**.
63+
* In the **Client library** dropdown, select **MSAL**.
6464
* To add **Client ID** and **Client secret**, see steps later in the article.
6565
1. Save the **Redirect URL** for later.
6666

@@ -125,15 +125,21 @@ After the Azure AD provider is enabled:
125125
* Optionally configure other sign-in settings by selecting **Identities** > **Settings**. For example, you might want to redirect anonymous users to the sign-in page.
126126
* Republish the developer portal after any configuration change.
127127

128-
## Migrate to MSAL v2.0
128+
## Migrate to MSAL
129129

130-
If you previously configured an Azure AD app for user sign-in using the Azure AD Authentication Library, you can use the portal to migrate the app to MSAL v2.0.
130+
If you previously configured an Azure AD app for user sign-in using the ADAL, you can use the portal to migrate the app to MSAL and update the identity provider in API Management.
131+
132+
### Update Azure AD app for MSAL compatibility
133+
134+
For steps, see [Switch redirect URIs to the single-page application type](../active-directory/develop/migrate-spa-implicit-to-auth-code.md#switch-redirect-uris-to-spa-platform).
135+
136+
### Update identity provider configuration
131137

132138
1. In the left menu of your API Management instance, under **Developer portal**, select **Identities**.
133139
1. Select **Azure Active Directory** from the list.
134-
4. In the **Client library** dropdown, select **MSAL v2**.
135-
5. Select **Update**.
136-
6. [Republish your developer portal](api-management-howto-developer-portal-customize.md#publish-from-the-azure-portal).
140+
1. In the **Client library** dropdown, select **MSAL**.
141+
1. Select **Update**.
142+
1. [Republish your developer portal](api-management-howto-developer-portal-customize.md#publish-from-the-azure-portal).
137143

138144

139145
## Add an external Azure AD group
@@ -225,7 +231,7 @@ Your user is now signed in to the developer portal for your API Management servi
225231
## Next Steps
226232

227233
- Learn more about [Azure Active Directory and OAuth2.0](../active-directory/develop/authentication-vs-authorization.md).
228-
- Learn more about [MSAL](../active-directory/develop/msal-overview.md) and [migrating to MSAL v2](../active-directory/develop/msal-migration.md).
234+
- Learn more about [MSAL](../active-directory/develop/msal-overview.md) and [migrating to MSAL](../active-directory/develop/msal-migration.md).
229235
- [Create an API Management service instance](./get-started-create-service-instance.md).
230236
- [Manage your first API](./import-and-publish.md).
231237

0 commit comments

Comments
 (0)