Uygulamaları MSAL.NET'e veya Microsoft.Identity.Web'e taşıma

Warning

Azure Active Directory Kimlik Doğrulama Kitaplığı (ADAL) kullanım dışı bırakıldı. ADAL kullanan mevcut uygulamalar çalışmaya devam edecek olsa da Microsoft artık ADAL'da güvenlik düzeltmeleri yayınlamayacaktır. Uygulamanızın güvenliğini riske atmamak için Microsoft Authentication Library (MSAL) kullanın.

Neden geçiş yapmalıyız?

.NET için Azure AD Kimlik Doğrulama Kitaplığı (ADAL.NET) kullanım dışı bırakıldı ve güvenlik hataları dahil olmak üzere yeni özellik veya hata düzeltmeleri uygulanmadı. ADAL kullanan uygulama çalışmaya devam edecektir.

Doğrudan ADAL kullanan uygulamalar için geçiş kılavuzu

MSAL.NET ve ADAL.NET ayrıntılarını araştırmadan önce, MSAL.NET veya gibi Microsoft.Identity.Webdaha üst düzey bir kitaplık kullanmak isteyip istemediğinizi kontrol etmek isteyebilirsiniz. Aşağıdaki karar ağacı hakkında ayrıntılı bilgi için MSAL.NET veya Microsoft.Identity.Web okuyun.

  • daha geniş bir Microsoft kimlik kümesinin kimliğini doğrulayabilirsiniz: iş veya okul hesapları, kişisel Microsoft hesapları ve Azure AD B2C ve Microsoft Entra Dış Kimlik ile sosyal veya yerel hesaplar.
  • Kullanıcılarınız en iyi çoklu oturum açma (SSO) deneyimine sahip olur.
  • Uygulamanız artımlı onay, Koşullu Erişim ve yeni ortaya çıkan diğer güvenlik özelliklerini etkinleştirebilir.
  • Güvenlik ve dayanıklılık açısından sürekli yeniliklerden yararlanıyorsunuz,

Important

MSAL.NET veya Microsoft. Identity.Web artık Microsoft kimlik platformu ile birlikte kullanılması önerilen kimlik doğrulama kitaplıklarıdır. ADAL'da yeni özellik uygulanmaz. Ayrıntılar için duyuruya bakın: Uygulamalarınızı ADAL'dan MSAL'ye güncelleştirme.

MSAL.NET'e mi yoksa Microsoft.Identity.Web'e mi geçmelisiniz

MSAL.NET ve ADAL.NET ayrıntılarını araştırmadan önce, MSAL.NET veya gibi Microsoft.Identity.Webdaha üst düzey bir kitaplık kullanmak isteyip istemediğinizi kontrol etmek isteyebilirsiniz. Aşağıdaki karar ağacı hakkında ayrıntılı bilgi için MSAL.NET veya Microsoft.Identity.Web okuyun.

Dolaylı olarak ADAL kullanan uygulamalar için geçiş kılavuzu

Diğer SDK'lardan gelen ADAL bağımlılıklarını farkında olmadan kullanabilirsiniz. Başka bir deyişle, ADAL geçişli bir bağımlılıktır. Uygulamanız olası bir güvenlik sorununu düzeltmek veya bir güvenlik iyileştirmesinden yararlanmak için ADAL'ı yükseltemediğinden bu durum yine de uygulamanız için bir riski temsil eder.

Geçiş yapmak için önce ADAL kullanan kök bağımlılığı tanımlamanız gerekir. Çoğu durumda, kök bağımlılığın kendisi kullanımdan kaldırılmıştır. Kök bağımlılığı belirlemek için nuget arabirimini veyadotnet nuget whykomutunu Visual Studio kullanabilirsiniz

Aşağıda en yaygın kullanım dışı bırakılan paketler ve bunların MSAL alternatifleri yer almaktadır. Daha ayrıntılı geçiş bilgileri için, belirli Azure SDK for .NET kitaplığı sayfalarındaki AppAuthentication to Azure.Identity Migration Guidance ve Migration guide bağlantılarına bakın.

Eski Paket (ADAL bağımlı, kullanım dışı) Desteklenen Paket (MSAL’e bağımlı, geçerli)
Microsoft.Azure.KeyVault Azure.Security.KeyVault.Secrets, Azure.Security.KeyVault.Keys, Azure.Security.KeyVault.Certificates
Microsoft.Azure.Management.Compute Azure.ResourceManager.Compute
Microsoft.Azure.Services.AppAuthentication Azure.Identity
Microsoft.Azure.Management.StorageSync Azure.ResourceManager.StorageSync
Microsoft.Azure.Management.Fluent Azure.ResourceManager
Microsoft.Azure.Management.EventGrid Azure.ResourceManager.EventGrid
Microsoft.Azure.Management.Automation Azure.ResourceManager.Automation
Microsoft.Azure.Management.Compute.Fluent Azure.ResourceManager.Compute
Microsoft.Azure.Management.MachineLearning.Fluent Azure.ResourceManager.MachineLearningCompute
Microsoft.Azure.Management.Media, windowsazure.mediaservices Azure.ResourceManager.Media
Microsoft.Kusto.Client Microsoft.Azure.Kusto.Data
Microsoft.Kusto.Ingest Microsoft.Azure.Kusto.Ingest

Sonraki Adımlar

  • Son güncelleştirme: