ASP.NET Framework ve .NET Standard ile Microsoft.Identity.Web'i entegre edin.

Microsoft. Identity.Web, Microsoft Entra ID kimlik doğrulamasını .NET Framework ve .NET Standard uygulamalarına genişletir. Bu makale, senaryonuz için doğru paket ve tümleştirme desenini seçmenize yardımcı olur.

Senaryonuzu seçin

Uygulama türünüzle eşleşen tümleştirme desenini seçin. Microsoft Entra, web uygulamaları ve arka plan hizmetleri için farklı paketler sunar.

Microsoft.Identity.Web paketleri ile MSAL.NET

Konsol uygulamaları, daemon hizmetleri ve web dışı .NET Framework uygulamaları için

Microsoft.Identity.Web.TokenCache ve Microsoft.Identity.Web.Certificate paketlerini MSAL.NET ile kullanın:

  • Belirteç önbelleği serileştirme (SQL Server, Redis, Cosmos DB, PostgreSQL)
  • KeyVault, sertifika deposu veya dosya sisteminden sertifika yükleme
  • Konsol uygulamaları ve daemon hizmetleri
  • .NET Standard 2.0 kitaplıkları

Microsoft.Identity.Web ve MSAL.NET Kılavuzu


ASP.NET MVC/Web API için OWIN tümleştirmesi

ASP.NET MVC ve Web API'si uygulamaları için

Microsoft.Identity.Web.OWIN paketini tam özellikli web kimlik doğrulaması için kullanın.

  • Otomatik jeton alımı için TokenAcquirerFactory
  • Microsoft Graph ve aşağı akış API'lerine kolay erişim için denetleyici uzantıları
  • Dağıtılmış belirteç önbelleği desteği
  • Artımlı onay işleme

OWIN Tümleştirme Kılavuzu


Tümleştirme seçeneklerini karşılaştırma

Aşağıdaki tabloda iki tümleştirme yaklaşımı arasındaki temel farklar özetlemektedir.

Özellik MSAL.NET + TokenCache/Sertifika OWIN Entegrasyonu
Paket Microsoft. Identity.Web.TokenCache
Microsoft.Identity.Web.Certificate
** Microsoft.Identity.Web.OWIN
Hedef Konsol uygulamaları, daemon'lar, çalışan hizmetleri ASP.NET MVC, ASP.NET Web API
Kimlik Doğrulaması El ile MSAL.NET yapılandırması Otomatik OWIN ara yazılımı
Belirteç Alma El ile IConfidentialClientApplication Denetleyici uzantılarıyla otomatik
Belirteç Önbelleği Tüm sağlayıcılar (SQL, Redis, Cosmos, PostgreSQL) Tüm sağlayıcılar (SQL, Redis, Cosmos, PostgreSQL)
Sertifika Yükleme KeyVault, depola, dosya, Base64 MSAL.NET yapılandırması aracılığıyla
Microsoft Graph El ile GraphServiceClient kurulum this.GetGraphServiceClient()
Aşağı akış API'leri Jetonlarla manuel HTTP çağrıları this.GetDownstreamApi()
Artımlı Onay El ile sınama işleme Otomatik MsalUiRequiredException ile

Kullanılabilir paketleri gözden geçirme

Microsoft.Identity.Web 1.17+ ile başlayarak, ASP.NET Core olmayan ortamlarda Microsoft Identity kitaplıklarını kullanabilirsiniz. Aşağıdaki paketler .NET Framework ve .NET Standart iş yüklerini hedefler.

Kullanılabilir paketler

Package Amaç Hedef Uygulamalar
Microsoft. Identity.Web.TokenCache MSAL.NET için belirteç önbelleği serileştiricileri Konsol, daemon, çalışan hizmetleri
Microsoft. Identity.Web.Certificate Sertifika yükleme yardımcı programları Konsol, daemon, çalışan hizmetleri
Microsoft. Identity.Web.OWIN OWIN ara yazılım tümleştirmesi ASP.NET MVC, ASP.NET Web API

Paket avantajlarını anlama

Bu paketler, ASP.NET Core gerekmeden yaygın kimlik doğrulama görevlerini basitleştirir.

Özellik Fayda
Belirteç Önbelleği Serileştirme Bellek içi, SQL Server, Redis, Cosmos DB, PostgreSQL için yeniden kullanılabilir önbellek bağdaştırıcıları
Sertifika Yardımcıları KeyVault, dosya sistemi veya sertifika depolarından basitleştirilmiş sertifika yükleme
OWIN Entegrasyonu ASP.NET MVC/Web API'sinde sorunsuz kimlik doğrulaması
.NET Standart 2.0 .NET Framework 4.7.2+, .NET Core ve .NET 5+ ile uyumludur
En Düşük Bağımlılıklar ASP.NET Core bağımlılıkları olmayan hedeflenen paketler

Örnek uygulamaları keşfetme

Bu örnekleri kendi uygulamanız için başlangıç noktaları olarak kullanın.

MSAL.NET örnekleri

OWIN örnekleri