Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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
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
- ConfidentialClientTokenCache - Belirteç önbelleğine sahip konsol uygulaması
- active-directory-dotnetcore-daemon-v2 - KeyVault sertifikalı Daemon
OWIN örnekleri
- ms-identity-aspnet-webapp-openidconnect - Microsoft.Identity.Web.OWIN ile ASP.NET MVC