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/active-directory/develop/msal-migration.md
+18-14Lines changed: 18 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,27 +8,27 @@ ms.service: active-directory
8
8
ms.subservice: develop
9
9
ms.topic: conceptual
10
10
ms.workload: identity
11
-
ms.date: 12/29/2022
11
+
ms.date: 07/17/2023
12
12
ms.author: dmwendia
13
-
ms.reviewer: saeeda, jmprieur
13
+
ms.reviewer: saeeda, jmprieur, localden
14
14
ms.custom: aaddev, has-adal-ref
15
15
# Customer intent: As an application developer, I want to learn about MSAL so I can migrate my ADAL applications to MSAL.
16
16
---
17
17
18
18
# Migrate applications to the Microsoft Authentication Library (MSAL)
19
19
20
-
If any of your applications use the Azure Active Directory Authentication Library (ADAL) for authentication and authorization functionality, it's time to migrate them to the [Microsoft Authentication Library (MSAL)](msal-overview.md#languages-and-frameworks).
20
+
If any of your applications use the Azure Active Directory Authentication Library (ADAL) for authentication and authorization capabilities, it's time to migrate them to the [Microsoft Authentication Library (MSAL)](/entra/msal).
21
21
22
-
- All Microsoft support and development for ADAL, including security fixes, ends in June 2023.
23
-
- There are no ADAL feature releases or new platform version releases planned prior to June 2023.
22
+
- All Microsoft support and development for ADAL, including security fixes, ended on June 30, 2023.
23
+
- There were no ADAL feature releases or new platform version releases planned prior to the deprecation date.
24
24
- No new features have been added to ADAL since June 30, 2020.
25
25
26
26
> [!WARNING]
27
27
> Azure Active Directory Authentication Library (ADAL) has been deprecated. While existing apps that use ADAL will continue to work, Microsoft will no longer release security fixes on ADAL. Use the [Microsoft Authentication Library (MSAL)](/entra/msal/) to avoid putting your app's security at risk.
28
28
29
29
## Why switch to MSAL?
30
30
31
-
If you've developed apps against Azure Active Directory (v1.0) endpoint in the past, you're likely using ADAL. Since Microsoft identity platform (v2.0) endpoint has changed significantly enough, the new library (MSAL) was built for the new endpoint entirely.
31
+
If you've developed apps against Azure Active Directory (v1.0) endpoint in the past, you're likely using ADAL. Since Microsoft identity platform (v2.0) endpoint has changed significantly, the new library (MSAL) was entirely built for the new endpoint.
32
32
33
33
The following diagram shows the v2.0 vs v1.0 endpoint experience at a high level, including the app registration experience, SDKs, endpoints, and supported identities.
34
34
@@ -51,12 +51,15 @@ MSAL provides multiple benefits over ADAL, including the following features:
51
51
| Microsoft account (MSA) |![Microsoft account (MSA) - MSAL provides the feature][y]|![Microsoft account (MSA) - ADAL doesn't provide the feature][n]|
52
52
| Azure AD B2C accounts |![Azure AD B2C accounts - MSAL provides the feature][y]|![Azure AD B2C accounts - ADAL doesn't provide the feature][n]|
53
53
| Best single sign-on experience |![Best single sign-on experience - MSAL provides the feature][y]|![Best single sign-on experience - ADAL doesn't provide the feature][n]|
54
-
|**Resilience**|||
55
-
|Proactive token renewal|![Proactive token renewal - MSAL provides the feature][y]|![Proactive token renewal - ADAL doesn't provide the feature][n]|
54
+
|**Authentication experiences**|||
55
+
|Continuous access evaluation through proactive token refresh|![Proactive token renewal - MSAL provides the feature][y]|![Proactive token renewal - ADAL doesn't provide the feature][n]|
56
56
| Throttling |![Throttling - MSAL provides the feature][y]|![Throttling - ADAL doesn't provide the feature][n]|
57
+
|Auth broker support |![Device-based conditional access policy - MSAL has the feature built-in][y]|![Device-based conditional access policy - ADAL doesn't provide the feature][n]|
58
+
| Token protection|![Token protection - MSAL provides the feature][y]|![Token protection - ADAL doesn't provide the feature][n]|
59
+
60
+
61
+
## Additional capabilities of MSAL over ADAL
57
62
58
-
## Additional Capabilities of MSAL over ADAL
59
-
- Auth broker support – Device-based Conditional Access policy
60
63
- Proof of possession tokens
61
64
- Azure AD certificate-based authentication (CBA) on mobile
62
65
- System browsers on mobile devices
@@ -73,14 +76,15 @@ If you need to continue using AD FS, you should upgrade to AD FS 2019 or later b
73
76
Before you start the migration, you need to identify which of your apps are using ADAL for authentication. Follow the steps in this article to get a list by using the Azure portal:
74
77
-[How to: Get a complete list of apps using ADAL in your tenant](howto-get-list-of-all-active-directory-auth-library-apps.md)
75
78
76
-
After identifying your apps that use ADAL, migrate them to MSAL depending on your application type as illustrated below.
79
+
After identifying applications that use ADAL, migrate them to MSAL depending on your app type:
MSAL Supports a wide range of application types and scenarios. Please refer to [Microsoft Authentication Library support for several application types](reference-v2-libraries.md#single-page-application-spa).
83
+
MSAL Supports a wide range of application types and scenarios. Refer to [Microsoft Authentication Library support for several application types](reference-v2-libraries.md#single-page-application-spa).
84
+
85
+
ADAL to MSAL migration guide for different platforms are available in the following links:
81
86
82
-
ADAL to MSAL Migration Guide for different platforms are available in the following link.
83
-
-[Migrate to MSAL iOS and MacOS](migrate-objc-adal-msal.md)
87
+
-[Migrate to MSAL iOS and macOS](migrate-objc-adal-msal.md)
84
88
-[Migrate to MSAL Java](migrate-adal-msal-java.md)
85
89
-[Migrate to MSAL.js](msal-compare-msal-js-and-adal-js.md)
0 commit comments