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 kimlik platformu ile tümleşen uygulamalara kimlik doğrulaması ve yetkilendirme eklemeyi basitleştiren bir NuGet paketleri kümesidir. Her paket belirli bir senaryoya yöneliktir, bu nedenle yalnızca uygulamanızın ihtiyaçlarını yüklersiniz. Bu makalede kullanılabilir paketler açıklanır ve doğru paketleri seçmenize yardımcı olur.
Çekirdek paketler
Bu paketler kimlik doğrulaması ve belirteç yönetimi için temel işlevleri sağlar.
| Package | Açıklama |
|---|---|
| Microsoft. Identity.Web | ASP.NET Core web uygulamaları ve web API'leri için ana paket. Oturum açmayı, belirteç doğrulamayı ve aşağı akış API'lerini çağırmayı etkinleştirir. |
| Microsoft. Identity.Web.UI | Oturum açma ve oturum kapatma denetleyicileri ve görünümleri dahil olmak üzere ASP.NET Core web uygulamaları için kullanıcı arabirimi bileşenleri sağlar. |
| Microsoft. Identity.Web.TokenAcquisition | Gizli istemci uygulamalarında belirteç alımı için üst düzey API (ASP.NET Core ve .NET SDK). Belirteç yönetimini otomatik olarak yönetir. |
| Microsoft. Identity.Web.TokenCache | MSAL.NET gizli istemci uygulamaları için belirteç önbelleği serileştiricileri. Bellek içi, dağıtılmış ve oturum tabanlı önbelleğe almayı destekler. |
Kimlik bilgisi yönetim paketleri
Bu paketler farklı kimlik doğrulama kimlik bilgileri türlerini işler.
| Package | Açıklama |
|---|---|
| Microsoft. Identity.Web.Certificate | Azure Key Vault ve yerel depolardan sertifika yükleme dahil olmak üzere MSAL.NET için sertifika yönetimi özellikleri. |
| Microsoft. Identity.Web.Certificateless | Sertifikasız kimlik doğrulama senaryoları, yönetilen kimlikler ve iş yükü kimliği federasyonu gibi. |
Aşağı akış API'si ve tümleştirme paketleri
Bu paketler korumalı API'leri çağırmanıza ve Azure hizmetlerle tümleştirmenize yardımcı olur.
| Package | Açıklama |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Otomatik belirteç yönetimi ile gizli istemci uygulamalarından aşağı akış korumalı API'leri çağırmak için üst düzey arabirim. |
| Microsoft. Identity.Web. Azure | ASP.NET Core web uygulamaları ve web API'lerinin, Microsoft kimlik platformuu ile Azure SDK'lerini kullanabilmesini sağlamak için TokenCredential uygulamaları sunar. |
| Microsoft. Identity.Web.OWIN | ASP.NET web uygulamalarının (OWIN/Katana) ve .NET Framework'te web API'lerinin Microsoft kimlik platformu kullanmasını sağlar. |
Microsoft Graph paketleri
Bu paketler, Microsoft 365 hizmetlerini çağırmak için Microsoft Graph ile tümleştirme sağlar.
| Package | Açıklama |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Graph SDK v5 ve sonrasını kullanarak Microsoft Graph tümleştirmesi. Yeni projeler için önerilir. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Microsoft Graph Beta tümleştirmesi, Graph SDK v5 ve üstü kullanılarak yapılır. Önizleme özelliklerine erişmek için bu paketi kullanın. |
| Microsoft. Identity.Web.MicrosoftGraph | Microsoft Graph ile tümleştirme, Graph SDK v4 kullanarak. Yeni projeler için paketleri kullanın GraphServiceClient . |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Microsoft Graph Beta sürümü ile tümleştirme, Graph SDK v4 kullanarak. |
Gelişmiş senaryo paketleri
Bu paketler özel kimlik doğrulama senaryolarını destekler.
| Package | Açıklama |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Kimlik doğrulaması sorunlarını gidermek için tanılama ve günlük tutma desteği. |
| Microsoft. Identity.Web.OidcFIC | Bulut Federasyonu Kimlik Bilgileri (FIC) sağlayıcı uygulaması. Bulutlar arası kimlik doğrulama senaryolarını etkinleştirir. |
| Microsoft. Identity.Web.AgentIdentities | Ajans kimliği senaryoları için, otonom ajanlar ve yardımcı pilot bütünleştirmeleri geliştirme de dahil olmak üzere yardımcı yöntemler. |
Doğru paketi seçin
Uygulama senaryonuzla eşleşen paketleri yüklemek için aşağıdaki örnekleri kullanın.
Kullanıcılarda oturum açabilen web uygulamaları
kullanıcılarla Microsoft Entra ID oturum açabilen ASP.NET Core web uygulamaları için çekirdek paketi ve kullanıcı arabirimi paketini yükleyin:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
Korumalı web API'leri
Kimliği doğrulanmış arayanlardan belirteçleri doğrulayan ASP.NET Core web API'leri için çekirdek paketini yükleyin:
dotnet add package Microsoft.Identity.Web
Daemon uygulamaları ve arka plan hizmetleri
Kullanıcı etkileşimi olmadan belirteç alan daemon uygulamaları veya arka plan hizmetleri için belirteç alma paketini yükleyin:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Microsoft Graph'ı Çağırma
Yeni projeler için Graph SDK v5 paketini kullanın:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Projeniz Graph SDK v4 kullanıyorsa bunun yerine önceki tümleştirme paketini yükleyin:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Azure SDK’ları kullanma
Microsoft kimlik platformu ile Azure SDK istemcilerinin kimliğini doğrulamak için Azure tümleştirme paketini yükleyin:
dotnet add package Microsoft.Identity.Web.Azure
Özel aşağı akış API'lerini çağırma
Otomatik belirteç yönetimi ile kendi korumalı API'lerinizi çağırmak için aşağı akış API paketini yükleyin:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Aracı ve yardımcı pilot senaryoları
Otonom aracılar veya copilot tümleştirmeleri oluşturmak için aracı kimlikleri paketini yükleyin:
dotnet add package Microsoft.Identity.Web.AgentIdentities
OWIN uygulamaları (.NET Framework)
.NET Framework'te (OWIN/Katana) ASP.NET web uygulamaları ve web API'leri için OWIN paketini yükleyin:
dotnet add package Microsoft.Identity.Web.OWIN