Microsoft. Identity.Web은 Microsoft ID 플랫폼 통합하는 애플리케이션에 인증 및 권한 부여 추가를 간소화하는 NuGet 패키지 집합입니다. 각 패키지는 특정 시나리오를 대상으로 하므로 애플리케이션에 필요한 것만 설치합니다. 이 문서에서는 사용 가능한 패키지를 설명하고 올바른 패키지를 선택하는 데 도움이 됩니다.
핵심 패키지
이러한 패키지는 인증 및 토큰 관리를 위한 기본 기능을 제공합니다.
| Package | 설명 |
|---|---|
| Microsoft. Identity.Web | ASP.NET Core 웹앱 및 웹 API에 대한 기본 패키지입니다. 로그인, 토큰 유효성 검사 및 다운스트림 API 호출을 사용하도록 설정합니다. |
| Microsoft. Identity.Web.UI | 로그인 및 로그아웃 컨트롤러 및 보기를 포함하여 ASP.NET Core 웹앱에 대한 UI 구성 요소를 제공합니다. |
| Microsoft. Identity.Web.TokenAcquisition | 기밀 클라이언트 애플리케이션(ASP.NET Core 및 .NET SDK)에서 토큰 획득을 위한 상위 수준 API입니다. 토큰 관리를 자동으로 처리합니다. |
| Microsoft. Identity.Web.TokenCache | MSAL.NET 기밀 클라이언트 애플리케이션에 대한 토큰 캐시 직렬 변환기입니다. 메모리 내, 분산 및 세션 기반 캐싱을 지원합니다. |
자격 증명 관리 패키지
이러한 패키지는 다양한 인증 자격 증명 유형을 처리합니다.
| Package | 설명 |
|---|---|
| Microsoft. Identity.Web.Certificate | Azure Key Vault 및 로컬 저장소에서 인증서 로드를 포함하여 MSAL.NET 대한 인증서 관리 기능입니다. |
| Microsoft. Identity.Web.Certificateless | 관리 ID 및 워크로드 ID 페더레이션과 같은 인증서 없는 인증 시나리오입니다. |
다운스트림 API 및 통합 패키지
이러한 패키지는 보호된 API를 호출하고 Azure 서비스와 통합하는 데 도움이 됩니다.
| Package | 설명 |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | 자동 토큰 관리를 사용하여 기밀 클라이언트 애플리케이션에서 다운스트림으로 보호되는 API를 호출하기 위한 상위 수준 인터페이스입니다. |
| Microsoft. Identity.Web. Azure | ASP.NET Core 웹앱 및 웹 API가 Microsoft ID 플랫폼과 함께 Azure SDK를 사용할 수 있도록 TokenCredential 구현을 제공합니다. |
| Microsoft. Identity.Web.OWIN | .NET Framework의 ASP.NET 웹앱(OWIN/Katana) 및 웹 API가 Microsoft ID 플랫폼 사용할 수 있도록 합니다. |
패키지 Microsoft Graph
이러한 패키지는 Microsoft 365 서비스를 호출하기 위한 Microsoft Graph 통합을 제공합니다.
| Package | 설명 |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Microsoft Graph Graph SDK v5 이상을 사용하여 통합합니다. 새 프로젝트에 권장합니다. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Microsoft Graph을 Graph SDK v5 이상과 함께 사용하는 베타 통합. 이 패키지를 사용하여 미리 보기 기능에 액세스합니다. |
| Microsoft. Identity.Web.MicrosoftGraph | Microsoft Graph SDK v4를 사용한 통합. 새 프로젝트에 GraphServiceClient 패키지를 사용하세요. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Graph SDK v4를 사용하여 Microsoft Graph 베타와 통합하기. |
고급 시나리오 패키지
이러한 패키지는 특수 인증 시나리오를 지원합니다.
| Package | 설명 |
|---|---|
| Microsoft. Identity.Web.Diagnostics | 인증 문제 해결을 위한 진단 및 로깅 지원. |
| Microsoft. Identity.Web.OidcFIC | FIC(클라우드 페더레이션 ID 자격 증명) 공급자 구현. 클라우드 간 인증 시나리오를 사용하도록 설정합니다. |
| Microsoft. Identity.Web.AgentIdentities | 자율 에이전트 및 부조종사 통합 빌드를 비롯한 에이전트 ID 시나리오에 대한 도우미 메서드입니다. |
올바른 패키지 선택
다음 예제를 사용하여 애플리케이션 시나리오와 일치하는 패키지를 설치합니다.
사용자를 로그인하는 웹 애플리케이션
Microsoft Entra ID 사용하여 사용자를 로그인하는 ASP.NET Core 웹앱의 경우 핵심 패키지 및 UI 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
보호된 웹 API
인증된 호출자의 토큰 유효성을 검사하는 ASP.NET Core 웹 API의 경우 핵심 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web
디먼 애플리케이션 및 백그라운드 서비스
사용자 상호 작용 없이 토큰을 획득하는 디먼 앱 또는 백그라운드 서비스의 경우 토큰 획득 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Microsoft Graph 호출
새 프로젝트의 경우 Graph SDK v5 패키지를 사용합니다.
dotnet add package Microsoft.Identity.Web.GraphServiceClient
프로젝트에서 Graph SDK v4를 사용하는 경우 이전 통합 패키지를 대신 설치합니다.
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Azure SDK 사용
Microsoft ID 플랫폼 Azure SDK 클라이언트를 인증하려면 Azure 통합 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web.Azure
사용자 지정 다운스트림 API 호출
자동 토큰 관리를 사용하여 사용자 고유의 보호된 API를 호출하려면 다운스트림 API 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web.DownstreamApi
에이전트 및 부조종사 시나리오
자율 에이전트 또는 부조종사 통합을 빌드하려면 에이전트 ID 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web.AgentIdentities
OWIN 애플리케이션 (.NET Framework)
.NET Framework(OWIN/Katana)의 ASP.NET 웹앱 및 웹 API의 경우 OWIN 패키지를 설치합니다.
dotnet add package Microsoft.Identity.Web.OWIN