Alkalmazások migrálása a Microsoft Authentication Librarybe (MSAL)

Ha valamelyik alkalmazás az Azure Active Directory Authentication Libraryt (ADAL) használja a hitelesítési és engedélyezési képességekhez, ideje migrálni őket a Microsoft Authentication Library (MSAL) szolgáltatásba.

  • Az ADAL összes Microsoft-támogatása és fejlesztése, beleértve a biztonsági javításokat is, 2023. június 30-án véget ért.
  • Az elavulási dátum előtt nem terveztek ADAL-funkciókiadásokat vagy új platformverzió-kiadásokat.
  • 2020. június 30. óta nem adtak hozzá új funkciókat az ADAL-hoz.

Figyelmeztetés

Az Azure Active Directory Authentication Library (ADAL) elavult. Bár az ADAL-t használó meglévő alkalmazások továbbra is működni fognak, a Microsoft a továbbiakban nem fog biztonsági javításokat kiadni az ADAL-on. A Microsoft Authentication Library (MSAL) használatával elkerülheti az alkalmazás biztonságát.

Miért érdemes MSAL-re váltani?

Ha az Azure AD (v1.0) végpontot használó alkalmazásokat fejlesztett, akkor valószínűleg az ADAL-t használja. Mivel Microsoft Identitásplatform (2.0-s verzió) végpont jelentősen megváltozott, az új kódtár (MSAL) teljes egészében az új végponthoz lett létrehozva.

Az MSAL úgy lett kialakítva, hogy biztonságos megoldást biztosíthasson anélkül, hogy a fejlesztőknek aggódniuk kellene a megvalósítás részletei miatt. Egyszerűsíti és kezeli a jogkivonatok beszerzését, kezelését, gyorsítótárazását és frissítését, és a rugalmasság érdekében ajánlott eljárásokat használ. Javasoljuk, hogy az MSAL használatával növelje a hitelesítés és az engedélyezés rugalmasságát a fejlesztendő ügyfélalkalmazásokban.

Az MSAL több előnnyel jár az ADAL-nal szemben, beleértve a következő funkciókat:

Funkciók MSAL ADAL
Biztonság
Biztonsági javítások 2023 júniusa után Biztonsági javítások 2023 júniusa után – Az MSAL biztosítja a funkciót Biztonsági javítások 2023 júniusa után – Az ADAL nem biztosítja a funkciót
Jogkivonatok proaktív frissítése és visszavonása a Microsoft Graph és a folyamatos hozzáférés-kiértékelést (CAE) támogató egyéb API-k házirendje vagy kritikus eseményei alapján. Jogkivonatok proaktív frissítése és visszavonása a Microsoft Graph és a folyamatos hozzáférés-kiértékelést (CAE) támogató egyéb API-k szabályzata vagy kritikus eseményei alapján – az MSAL biztosítja a funkciót Jogkivonatok proaktív frissítése és visszavonása a Microsoft Graph szabályzatai vagy kritikus eseményei, valamint a folyamatos hozzáférés-kiértékelést (CAE) támogató egyéb API-k alapján – Az ADAL nem támogatja ezt a funkciót
Az OAuth v2.0 és az OpenID Connect (OIDC) szabványainak megfelelő szabványok Az OAuth v2.0 és az OpenID Connect (OIDC) szabványnak megfelelő szabványok – az MSAL biztosítja a funkciót Az OAuth v2.0 és az OpenID Connect (OIDC) szabványnak megfelelő szabványok – Az ADAL nem biztosítja a szolgáltatást
Felhasználói fiókok és szolgáltatások
Microsoft Entra-fiókok Microsoft Entra-fiókok – Az MSAL biztosítja a funkciót Microsoft Entra-fiókok – Az ADAL biztosítja a funkciót
Microsoft-fiók (MSA) Microsoft-fiók (MSA) – Az MSAL biztosítja a funkciót Microsoft-fiók (MSA) – Az ADAL nem biztosítja a funkciót
Azure AD B2C-fiókok Azure AD B2C-fiókok – Az MSAL biztosítja a funkciót Azure AD B2C-fiókok – Az ADAL nem biztosítja a funkciót
Legjobb egyszeri bejelentkezés A legjobb egyszeri bejelentkezés – az MSAL biztosítja a funkciót Legjobb egyszeri bejelentkezés – Az ADAL nem biztosítja a funkciót
Hitelesítési élmények
Folyamatos hozzáférés-kiértékelés proaktív jogkivonat-frissítéssel Proaktív jogkivonat-megújítás – Az MSAL biztosítja a funkciót Proaktív jogkivonat-megújítás – Az ADAL nem biztosítja a funkciót
Szabályozás Szabályozás – Az MSAL biztosítja a funkciót Terheléskorlátozás – Az ADAL nem biztosítja ezt a funkciót
Hitelesítés-közvetítő támogatása Eszközalapú feltételes hozzáférési szabályzat – Az MSAL beépített funkcióval rendelkezik Eszközalapú feltételes hozzáférési szabályzat – Az ADAL nem biztosítja a szolgáltatást
Jogkivonatok védelme Jogkivonat-védelem – Az MSAL biztosítja a funkciót Jogkivonat-védelem – Az ADAL nem biztosítja a funkciót

Az MSAL további képességei az ADAL-n keresztül

  • A birtoklási jogkivonatok igazolása
  • Microsoft Entra tanúsítványalapú hitelesítés (CBA) mobileszközökön
  • Rendszerböngészők mobileszközökön
  • Ha az ADAL csak hitelesítési környezeti osztálysal rendelkezik, az MSAL közzéteszi az ügyfélalkalmazások gyűjteményének fogalmát (nyilvános ügyfél és bizalmas ügyfél).

Active Directory összevonási szolgáltatások (AD FS) támogatása az MSAL-ben

A MSAL.NET, az MSAL Java, a MSAL.js és az MSAL Python használatával jogkivonatokat kérhet le Active Directory összevonási szolgáltatások (AD FS) (AD FS) 2019-ben vagy újabb verzióiban. Az AD FS korábbi verzióit, beleértve az AD FS 2016-ot, az MSAL nem támogatja.

Ha folytatnia kell az AD FS használatát, frissítenie kell az AD FS 2019-re vagy újabb verziójára, mielőtt az alkalmazásokat ADAL-ról MSAL-re frissítené.

Migrálás MSAL-be

A migrálás megkezdése előtt meg kell határoznia, hogy melyik alkalmazás használja az ADAL-t hitelesítéshez. A jelen cikkben ismertetett lépéseket követve listát kérhet le az Azure Portalon:

Az ADAL-t használó alkalmazások azonosítása után az alkalmazás típusától függően migrálja őket az MSAL-be:

Egyoldalas alkalmazás (SPA)

Webalkalmazás

Webes API

Asztali alkalmazás

Mobilalkalmazás

Szolgáltatás/ démonalkalmazás

Az MSAL számos alkalmazástípust és forgatókönyvet támogat. Tekintse meg a Microsoft Authentication Library számos alkalmazástípus támogatását.

Az ADAL–MSAL migrálási útmutató különböző platformokhoz az alábbi hivatkozásokon érhető el:

Segítség a migráláshoz

Ha kérdése van az alkalmazás ADAL-ról MSAL-re való migrálásával kapcsolatban, az alábbi lehetőségek közül választhat:

  • Tegye fel kérdését a Microsoft Q&A-ra, és címkézze meg a következővel[azure-ad-adal-deprecation]: .
  • Nyisson meg egy hibát a könyvtár GitHub-adattárában. Az egyes könyvtárak adattárára mutató hivatkozásokért lásd az MSAL áttekintési cikkének Nyelvek és keretrendszerek szakaszát.

Ha független szoftverszállítóval (ISV) együttműködött az alkalmazás fejlesztése során, javasoljuk, hogy közvetlenül vegye fel velük a kapcsolatot, hogy megismerje az MSAL-be való migrálási folyamatukat.

Következő lépések

További információ az MSAL-ról, beleértve a használati információkat, valamint a különböző programozási nyelvekhez és alkalmazástípusokhoz elérhető kódtárakat:

  • Last updated on