Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Microsoft. Identity.Web je sada balíčků NuGet, které zjednodušují přidávání ověřování a autorizace do aplikací, které se integrují s Microsoft identity platform. Každý balíček cílí na konkrétní scénář, takže nainstalujete jenom to, co vaše aplikace potřebuje. Tento článek popisuje dostupné balíčky a pomůže vám vybrat ten správný.
Základní balíčky
Tyto balíčky poskytují základní funkce pro ověřování a správu tokenů.
| Balíček | Description |
|---|---|
| Microsoft. Identity.Web | Hlavní balíček pro webové aplikace a rozhraní API ASP.NET Core. Povolí přihlášení, ověření tokenu a volání podřízených rozhraní API. |
| Microsoft. Identity.Web.UI | Poskytuje komponenty uživatelského rozhraní pro ASP.NET Core webové aplikace, včetně kontrolerů přihlašování a odhlašování a zobrazení. |
| Microsoft. Identity.Web.TokenAcquisition | Rozhraní API vyšší úrovně pro získávání tokenů v aplikacích s důvěryhodnými klienty (ASP.NET Core a .NET SDK). Zpracovává správu tokenů automaticky. |
| Microsoft. Identity.Web.TokenCache | Serializátory mezipaměti tokenů pro MSAL.NET důvěrné klientské aplikace. Podporuje ukládání do mezipaměti v paměti, distribuované mezipaměti a ukládání do mezipaměti založené na relacích. |
Balíčky pro správu přihlašovacích údajů
Tyto balíčky zpracovávají různé typy ověřovacích údajů.
| Balíček | Description |
|---|---|
| Microsoft. Identity.Web.Certificate | Možnosti správy certifikátů pro MSAL.NET, včetně načítání certifikátů z Azure Key Vault a místních úložišť. |
| Microsoft. Identity.Web.Certificateless | Scénáře ověřování bez certifikátů, jako jsou spravované identity a federace identit úloh. |
Podřízené rozhraní API a integrační balíčky
Tyto balíčky vám pomůžou volat chráněná rozhraní API a integrovat se službami Azure.
| Balíček | Description |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Rozhraní vyšší úrovně pro volání podřízených chráněných rozhraní API z důvěrných klientských aplikací s automatickou správou tokenů |
| Microsoft. Identity.Web. Azure | Umožňuje ASP.NET Core webovým aplikacím a webovým rozhraním API využívat Sady Azure SDK na platformě Microsoft identity prostřednictvím poskytovaných implementací TokenCredential. |
| Microsoft. Identity.Web.OWIN | Umožňuje ASP.NET webovým aplikacím (OWIN/Katana) a webovým rozhraním API v .NET Framework používat Microsoft identity platform. |
balíčky Microsoft Graph
Tyto balíčky poskytují integraci s Microsoft Graph pro volání služeb Microsoft 365.
| Balíček | Description |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Integrace Microsoft Graph pomocí Graph SDK verze 5 a novější. Doporučuje se pro nové projekty. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Integrace beta verze Microsoft Graph s využitím sady SDK Graph v5 a novější. Tento balíček použijte pro přístup k funkcím ve verzi Preview. |
| Microsoft. Identity.Web.MicrosoftGraph | integrace Microsoft Graph pomocí sady Graph SDK v4. Používejte GraphServiceClient balíčky pro nové projekty. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | integrace Microsoft Graph Beta pomocí sady Graph SDK v4. |
Pokročilé balíčky scénářů
Tyto balíčky podporují specializované scénáře ověřování.
| Balíček | Description |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Podpora diagnostiky a protokolování pro řešení potíží s ověřováním |
| Microsoft. Identity.Web.OidcFIC | Implementace poskytovatele přihlašovacích údajů federace identity v cloudu (FIC). Umožňuje scénáře ověřování napříč cloudy. |
| Microsoft. Identity.Web.AgentIdentities | Pomocné metody pro scénáře identifikace agentů, zahrnující tvorbu autonomních agentů a integrace kopilotů. |
Vyberte si správný balíček
Pomocí následujících příkladů nainstalujte balíčky, které odpovídají vašemu scénáři aplikace.
Webové aplikace, do kterých se uživatelé přihlašují
U ASP.NET Core webových aplikací, které přihlašují uživatele pomocí Microsoft Entra ID, nainstalujte základní balíček a balíček uživatelského rozhraní:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
Chráněná webová rozhraní API
Pro webová rozhraní API pro ASP.NET Core, která ověřují tokeny od ověřených uživatelů, nainstalujte základní balíček:
dotnet add package Microsoft.Identity.Web
Aplikace démona a služby na pozadí
Pro aplikace démona nebo služby na pozadí, které získávají tokeny bez zásahu uživatele, nainstalujte balíček pro získání tokenu:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Volání Microsoft Graph
Pro nové projekty použijte balíček Graph SDK v5:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Pokud váš projekt používá sadu Graph SDK v4, nainstalujte místo toho starší integrační balíček:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Použití Sady Azure SDK
Pokud chcete ověřit Azure SDK klienty pomocí Microsoft identity platform, nainstalujte integrační balíček Azure:
dotnet add package Microsoft.Identity.Web.Azure
Volání vlastních podřízených rozhraní API
Pokud chcete volat vlastní chráněná rozhraní API s automatickou správou tokenů, nainstalujte balíček podřízeného rozhraní API:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Scénáře agenta a copilotu
Pro sestavování autonomních agentů nebo integrací copilotu nainstalujte balíček identit agenta:
dotnet add package Microsoft.Identity.Web.AgentIdentities
Aplikace OWIN (.NET Framework)
Pro webové aplikace a webová rozhraní API ASP.NET na .NET Frameworku (OWIN/Katana) nainstalujte balíček OWIN:
dotnet add package Microsoft.Identity.Web.OWIN