Migrieren von Anwendungen zur Microsoft Authentication Library (MSAL)Migrate applications to the Microsoft Authentication Library (MSAL)

Viele Entwickler haben Anwendungen mit Azure Active Directory Authentication Library (ADAL) entwickelt und bereitgestellt.Many developers have built and deployed applications using the Azure Active Directory Authentication Library (ADAL). Jetzt empfehlen wir die Verwendung von Microsoft Authentication Library (MSAL) für die Authentifizierung und Autorisierung von Azure AD-Entitäten.We now recommend using the Microsoft Authentication Library (MSAL) for authentication and authorization of Azure AD entities.

Die Vorteile von MSAL gegenüber ADAL:By using MSAL instead of ADAL:

  • Sie können eine größere Anzahl von Identitäten authentifizieren:You can authenticate a broader set of identities:
    • Azure AD-IdentitätenAzure AD identities
    • Microsoft-KontenMicrosoft accounts
    • Social Media- und lokale Konten bei Verwendung von Azure AD B2CSocial and local accounts by using Azure AD B2C
  • Ihre Benutzer erhalten die besten Funktionen für einmalige Anmelden (Single Sign-On, SSO).Your users will get the best single-sign-on experience.
  • Ihre Anwendung kann die inkrementelle Zustimmung aktivieren.Your application can enable incremental consent.
  • Die Unterstützung des bedingten Zugriffs ist einfacher.Supporting Conditional Access is easier.
  • Sie profitieren von Innovationen.You benefit from innovation. Da sich alle Microsoft-Entwicklungsaufgaben nun auf MSAL konzentrieren, werden keine neuen Features in ADAL implementiert.Because all Microsoft development efforts are now focused on MSAL, no new features will be implemented in ADAL.

MSAL wird jetzt als Authentifizierungsbibliothek für Microsoft Identity Platform empfohlen.MSAL is now the recommended authentication library for use with the Microsoft identity platform.

Hinweise zur MigrationMigration guidance

Die folgenden Artikel unterstützen Sie bei der Migration zu MSAL:The following articles can help you migrate to MSAL:

Häufig gestellte Fragen (FAQ)Frequently asked questions (FAQ)

F: Wird ADAL als veraltet markiert?Q: Is ADAL being deprecated?
A: Ja.A: Yes. Ab dem 30. Juni 2020 werden ADAL keine neuen Features mehr hinzugefügt.Starting June 30th, 2020, we will no longer add new features to ADAL. Bis zum 30. Juni 2022 stellen wir weiterhin wichtige Sicherheitspatches für ADAL bereit.We'll continue adding critical security fixes to ADAL until June 30th, 2022. Nach diesem Datum funktionieren Ihre Apps, die ADAL verwenden, weiterhin. Wir empfehlen jedoch, ein Upgrade auf MSAL auszuführen, damit Sie von den neuesten Features profitieren und Ihre Apps weiter sicher sind.After this date, your apps using ADAL will continue to work, but we recommend upgrading to MSAL to take advantage of the latest features and to stay secure.

F: Werden meine vorhandenen ADAL-Apps nicht mehr funktionieren?Q: Will my existing ADAL apps stop working?
A: Nein.A: No. Ihre vorhandenen Apps funktionieren auch weiterhin ohne Änderungen.Your existing apps will continue working without modification. Wenn geplant ist, die Anwendungen über den 30. Juni 2022 hinaus auszuführen, sollten Sie ein Update der Apps auf MSAL in Erwägung ziehen, um die Sicherheit weiterhin zu gewährleisten. Eine Migration zu MSAL ist jedoch nicht erforderlich, um die vorhandene Funktionalität aufrechtzuerhalten.If you're planning to keep them beyond June 30th, 2022, you should consider updating your apps to MSAL to keep them secure, but migrating to MSAL isn't required to maintain existing functionality.

F: Woher weiß ich, welche meiner Apps ADAL verwendet?Q: How do I know which of my apps are using ADAL?
A: Wenn Sie über den Quellcode für die Anwendung verfügen, können Sie anhand der oben genannten Artikel zur Migration ermitteln, welche Bibliothek die App verwendet und wie die Migration zu MSAL erfolgen kann.A: If you have the source code for the application, you can reference the above migration guides to help determine which library the app uses and how to migrate it to MSAL. Wenn Sie mit einem ISV zusammenarbeiten, sollten Sie sich direkt an diesen wenden, um sich über dessen Migration Journey zu MSAL zu informieren.If you partnered with an ISV, we suggest you reach out to them directly to understand their migration journey to MSAL.

F: Warum sollte ich in den Umstieg auf MSAL investieren?Q: Why should I invest in moving to MSAL?
A: MSAL enthält neue Features, die nicht in ADAL enthalten sind. Dazu zählen die inkrementelle Zustimmung, Einmaliges Anmelden (SSO) und die Tokencacheverwaltung.A: MSAL contains new features not in ADAL including incremental consent, single sign-on, and token cache management. Im Gegensatz zu ADAL erhält MSAL auch nach dem 30. Juni 2022 weiterhin Sicherheitspatches.Also, unlike ADAL, MSAL will continue to receive security patches beyond June 30th, 2022. Weitere InformationenLearn more.

F: Aktualisiert Microsoft seine eigenen Apps für die MSAL?Q: Will Microsoft update its own apps to MSAL?
Ja.Yes. Microsoft wird seine Anwendungen bis zum Supportende zur MSAL migrieren. Hiermit soll sichergestellt werden, dass diese Apps von den fortlaufenden Sicherheits- und Featureverbesserungen für die MSAL profitieren.Microsoft is in the process of migrating its applications to MSAL by the end-of-support deadline, ensuring they'll benefit from MSAL's ongoing security and feature improvements.

F: Wird ein Tool veröffentlicht, mit dem ich meine Apps von ADAL auf MSAL umstellen kann?Q: Will you release a tool that helps me move my apps from ADAL to MSAL?
A: Nein.A: No. Bei den Unterschieden zwischen den Bibliotheken wären dedizierte Ressourcen für die Entwicklung und Wartung des Tools erforderlich, die so in die Verbesserung von MSAL fließen können.Differences between the libraries would require dedicating resources to development and maintenance of the tool that would otherwise be spent improving MSAL. Wir stellen jedoch die obigen Artikel zur Migration bereit, um Ihnen bei der Durchführung der erforderlichen Änderungen in Ihrer Anwendung zu helfen.However, we do provide the preceding set of migration guides to help you make the required changes in your application.

F: Wie funktioniert MSAL mit AD FS?Q: How does MSAL work with AD FS?
A: MSAL.NET unterstützt bestimmte Szenarien für die Authentifizierung bei AD FS 2019.A: MSAL.NET supports certain scenarios to authenticate against AD FS 2019. Wenn Ihre App Token direkt aus einer früheren Version von AD FS abrufen muss, sollten Sie ADAL beibehalten.If your app needs to acquire tokens directly from earlier version of AD FS, you should remain on ADAL. Weitere InformationenLearn more.

F: Wie erhalte ich Hilfe bei der Migration meiner Anwendung?Q: How do I get help migrating my application?
A: Weitere Informationen finden Sie im Abschnitt Hinweise zur Migration in diesem Artikel.A: See the Migration guidance section of this article. Wenn Sie nach dem Lesen der Anleitung für Ihre App-Plattform noch Fragen haben, können Sie auf Stack Overflow einen Beitrag mit dem Tag [adal-deprecation] veröffentlichen oder im GitHub-Repository der Bibliothek ein Problem öffnen.If, after reading the guide for your app's platform, you have additional questions, you can post on Stack Overflow with the tag [adal-deprecation] or open an issue in library's GitHub repository. Links zum Repository der einzelnen Bibliotheken finden Sie im Übersichtsartikel zu MSAL im Abschnitt Sprachen und Frameworks.See the Languages and frameworks section of the MSAL overview article for links to each library's repo.

Nächste SchritteNext steps