Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Microsoft. Identity.Web adalah sekumpulan paket NuGet yang menyederhanakan penambahan autentikasi dan otorisasi ke aplikasi yang terintegrasi dengan platform identitas Microsoft. Setiap paket menargetkan skenario tertentu, sehingga Anda hanya menginstal apa yang dibutuhkan aplikasi Anda. Artikel ini menjelaskan paket yang tersedia dan membantu Anda memilih paket yang tepat.
Paket inti
Paket ini menyediakan fungsionalitas mendasar untuk autentikasi dan manajemen token.
| Package | Deskripsi |
|---|---|
| Microsoft. Identity.Web | Paket utama untuk aplikasi web ASP.NET Core dan API web. Mengaktifkan masuk, validasi token, dan memanggil API hilir. |
| Microsoft. Identity.Web.UI | Menyediakan komponen UI untuk aplikasi web ASP.NET Core, termasuk pengontrol dan tampilan masuk dan keluar. |
| Microsoft. Identity.Web.TokenAcquisition | API tingkat lebih tinggi untuk akuisisi token dalam aplikasi klien rahasia (ASP.NET Core dan .NET SDK). Menangani manajemen token secara otomatis. |
| Microsoft. Identity.Web.TokenCache | Serializer cache token untuk aplikasi klien rahasia MSAL.NET. Mendukung caching dalam memori, terdistribusi, dan berbasis sesi. |
Paket manajemen kredensial
Paket ini menangani berbagai jenis kredensial autentikasi.
| Package | Deskripsi |
|---|---|
| Microsoft. Identity.Web.Certificate | Kemampuan manajemen sertifikat untuk MSAL.NET, termasuk memuat sertifikat dari Azure Key Vault dan penyimpanan lokal. |
| Microsoft. Identity.Web.Certificateless | Skenario autentikasi tanpa sertifikat seperti identitas terkelola dan federasi identitas beban kerja. |
API hilir dan paket integrasi
Paket ini membantu Anda memanggil API yang dilindungi dan berintegrasi dengan layanan Azure.
| Package | Deskripsi |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Antarmuka tingkat yang lebih tinggi untuk memanggil API yang dilindungi hilir dari aplikasi klien rahasia dengan manajemen token otomatis. |
| Microsoft. Identity.Web. Azure | Memungkinkan aplikasi web ASP.NET Core dan API web menggunakan SDK Azure dengan platform identitas Microsoft dengan menyediakan implementasi TokenCredential. |
| Microsoft. Identity.Web.OWIN | Memungkinkan aplikasi web ASP.NET (OWIN/Katana) dan API web di .NET Framework untuk menggunakan platform identitas Microsoft. |
paket Microsoft Graph
Paket ini menyediakan integrasi dengan Microsoft Graph untuk memanggil layanan Microsoft 365.
| Package | Deskripsi |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Integrasi Microsoft Graph menggunakan Graph SDK v5 dan yang lebih baru. Direkomendasikan untuk proyek baru. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Integrasi Beta Microsoft Graph menggunakan Graph SDK v5 dan yang lebih baru. Gunakan paket ini untuk mengakses fitur pratinjau. |
| Microsoft. Identity.Web.MicrosoftGraph | Microsoft Graph integrasi menggunakan Graph SDK v4. Gunakan GraphServiceClient paket untuk proyek baru. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Integrasi Microsoft Graph Beta menggunakan Graph SDK v4. |
Paket skenario tingkat lanjut
Paket ini mendukung skenario autentikasi khusus.
| Package | Deskripsi |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Dukungan diagnostik dan pengelogan untuk memecahkan masalah autentikasi. |
| Microsoft. Identity.Web.OidcFIC | Implementasi penyedia layanan Kredensial Identitas Federasi Cloud (FIC). Mengaktifkan skenario autentikasi lintas cloud. |
| Microsoft. Identity.Web.AgentIdentities | Metode bantuan untuk skenario identitas agen, termasuk dalam membangun agen otonom dan integrasi copilot. |
Pilih paket yang tepat
Gunakan contoh berikut untuk menginstal paket yang cocok dengan skenario aplikasi Anda.
Aplikasi web yang memungkinkan pengguna masuk
Untuk aplikasi web ASP.NET Core yang memasukkan pengguna dengan Microsoft Entra ID, instal paket inti dan paket UI:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
API web yang dilindungi
Untuk API web ASP.NET Core yang memvalidasi token dari penelepon terautentikasi, instal paket inti:
dotnet add package Microsoft.Identity.Web
Aplikasi Daemon dan layanan latar belakang
Untuk aplikasi daemon atau layanan latar belakang yang memperoleh token tanpa interaksi pengguna, instal paket akuisisi token:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Memanggil Microsoft Graph
Untuk proyek baru, gunakan paket Graph SDK v5:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Jika proyek Anda menggunakan Graph SDK v4, instal paket integrasi sebelumnya sebagai gantinya:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Menggunakan Azure SDK
Untuk mengautentikasi klien Azure SDK dengan platform identitas Microsoft, instal paket integrasi Azure:
dotnet add package Microsoft.Identity.Web.Azure
Memanggil API hilir khusus
Untuk memanggil API yang dilindungi Anda sendiri dengan manajemen token otomatis, instal paket API hilir:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Skenario agen dan kopilot
Untuk membangun agen otonom atau integrasi copilot, instal paket identitas untuk agen:
dotnet add package Microsoft.Identity.Web.AgentIdentities
Aplikasi OWIN (.NET Framework)
Untuk aplikasi web ASP.NET dan API web di .NET Framework (OWIN/Katana), instal paket OWIN:
dotnet add package Microsoft.Identity.Web.OWIN