Toepassingen migreren naar de Microsoft Authentication Library (MSAL)

  • Artikel

Als een van uw toepassingen de Azure Active Directory Authentication Library (ADAL) gebruikt voor verificatie- en autorisatiemogelijkheden, is het tijd om ze te migreren naar de Microsoft Authentication Library (MSAL).

  • Alle Microsoft-ondersteuning en -ontwikkeling voor ADAL, inclusief beveiligingsoplossingen, is beëindigd op 30 juni 2023.
  • Er waren geen ADAL-functiereleases of nieuwe platformversiereleases gepland vóór de afschaffingsdatum.
  • Er zijn sinds 30 juni 2020 geen nieuwe functies toegevoegd aan ADAL.

Waarschuwing

Azure Active Directory Authentication Library (ADAL) is afgeschaft. Hoewel bestaande apps die gebruikmaken van ADAL blijven werken, zal Microsoft geen beveiligingscorrecties meer vrijgeven op ADAL. Gebruik de Microsoft Authentication Library (MSAL) om te voorkomen dat de beveiliging van uw app risico loopt.

Waarom overstappen op MSAL?

Als u apps hebt ontwikkeld met behulp van het Azure AD-eindpunt (v1.0), gebruikt u waarschijnlijk ADAL. Omdat het Microsoft Identity Platform-eindpunt (v2.0) aanzienlijk is gewijzigd, is de nieuwe bibliotheek (MSAL) volledig gebouwd voor het nieuwe eindpunt.

MSAL is ontworpen om een veilige oplossing mogelijk te maken zonder dat ontwikkelaars zich bezig hoeven te houden met de implementatiedetails. Hiermee vereenvoudigt en beheert u het verkrijgen, beheren, opslaan in cache en vernieuwen van tokens. Er wordt gebruikgemaakt van best practices voor tolerantie. U wordt aangeraden MSAL te gebruiken om de tolerantie van verificatie en autorisatie te vergroten in clienttoepassingen die u ontwikkelt.

MSAL biedt meerdere voordelen ten opzichte van ADAL, waaronder de volgende functies:

Functies MSAL ADAL
Beveiliging
Beveiligingsoplossingen na juni 2023 Security fixes beyond June 2023 - MSAL provides the feature Security fixes beyond June 2023 - ADAL doesn't provide the feature
Vernieuw en trek tokens proactief in op basis van beleid of kritieke gebeurtenissen voor Microsoft Graph en andere API's die ondersteuning bieden voor Continuous Access Evaluation (CAE). Proactively refresh and revoke tokens based on policy or critical events for Microsoft Graph and other APIs that support Continuous Access Evaluation (CAE) - MSAL provides the feature Proactively refresh and revoke tokens based on policy or critical events for Microsoft Graph and other APIs that support Continuous Access Evaluation (CAE) - ADAL doesn't provide the feature
Standaarden die compatibel zijn met OAuth v2.0 en OpenID Verbinding maken (OIDC) Standards compliant with OAuth v2.0 and OpenID Connect (OIDC) - MSAL provides the feature Standards compliant with OAuth v2.0 and OpenID Connect (OIDC) - ADAL doesn't provide the feature
Gebruikersaccounts en -ervaringen
Microsoft Entra-accounts Microsoft Entra accounts - MSAL provides the feature Microsoft Entra accounts - ADAL provides the feature
Microsoft-account (MSA) Microsoft account (MSA) - MSAL provides the feature Microsoft account (MSA) - ADAL doesn't provide the feature
Azure AD B2C-accounts Azure AD B2C accounts - MSAL provides the feature Azure AD B2C accounts - ADAL doesn't provide the feature
Beste ervaring voor eenmalige aanmelding Best single sign-on experience - MSAL provides the feature Best single sign-on experience - ADAL doesn't provide the feature
Verificatie-ervaringen
Continue toegangsevaluatie via proactief vernieuwen van tokens Proactive token renewal - MSAL provides the feature Proactive token renewal - ADAL doesn't provide the feature
Beperking Throttling - MSAL provides the feature Throttling - ADAL doesn't provide the feature
Ondersteuning voor verificatiebroker Device-based Conditional Access policy - MSAL has the feature built-in Device-based Conditional Access policy - ADAL doesn't provide the feature
Beveiliging van tokens Token protection - MSAL provides the feature Token protection - ADAL doesn't provide the feature

Aanvullende mogelijkheden van MSAL via ADAL

  • Bewijs van bezitstokens
  • Microsoft Entra-verificatie op basis van certificaten (CBA) op mobiele apparaten
  • Systeembrowsers op mobiele apparaten
  • Waar ADAL alleen verificatiecontextklasse had, toont MSAL het idee van een verzameling client-apps (openbare client en vertrouwelijke client).

AD FS-ondersteuning in MSAL

U kunt MSAL.NET, MSAL Java, MSAL.js en MSAL Python gebruiken om tokens op te halen van Ad FS 2019 (Active Directory Federation Services) 2019 of hoger. Eerdere versies van AD FS, waaronder AD FS 2016, worden niet ondersteund door MSAL.

Als u AD FS wilt blijven gebruiken, moet u upgraden naar AD FS 2019 of hoger voordat u uw toepassingen bijwerkt van ADAL naar MSAL.

Migreren naar MSAL

Voordat u de migratie start, moet u bepalen welke van uw apps ADAL gebruiken voor verificatie. Volg de stappen in dit artikel om een lijst op te halen met behulp van Azure Portal:

Nadat u toepassingen hebt geïdentificeerd die gebruikmaken van ADAL, migreert u deze naar MSAL, afhankelijk van uw app-type:

App met één pagina (SPA)

Webapp

Web-API

Desktop-app

Mobiele app

Service-/daemon-app

MSAL ondersteunt een breed scala aan toepassingstypen en scenario's. Raadpleeg de ondersteuning voor Microsoft Authentication Library voor verschillende toepassingstypen.

De migratiehandleiding voor ADAL naar MSAL voor verschillende platforms vindt u in de volgende koppelingen:

Hulp bij uw migratie

Als u vragen hebt over het migreren van uw app van ADAL naar MSAL, zijn hier enkele opties:

  • Stel uw vraag op Microsoft Q&A en tag deze met [azure-ad-adal-deprecation].
  • Open een probleem in de GitHub-opslagplaats van de bibliotheek. Zie de sectie Talen en frameworks van het MSAL-overzichtsartikel voor koppelingen naar de opslagplaats van elke bibliotheek.

Als u in de ontwikkeling van uw toepassing hebt samengewerkt met een onafhankelijke softwareleverancier (ISV), raden we u aan om rechtstreeks contact met hen op te stellen om hun migratietraject naar MSAL te begrijpen.

Volgende stappen

Voor meer informatie over MSAL, inclusief gebruiksgegevens en welke bibliotheken beschikbaar zijn voor de verschillende programmeertalen en toepassingstypen, raadpleegt u: