Tutorial: Membuat dan mengonfigurasi proyek ASP.NET Core untuk autentikasi
Dalam tutorial ini, Anda mempelajari cara membuat proyek ASP.NET Core menggunakan IDE dan mengonfigurasinya untuk autentikasi dan otorisasi. Tutorial ini adalah bagian kedua dari seri yang menunjukkan cara mengamankan API web menggunakan platform identitas Microsoft. Di artikel sebelumnya, Anda mendaftarkan aplikasi di penyewa ID Microsoft Entra Anda. Dalam artikel ini, Anda;
- Membuat proyek ASP.NET Core Empty di IDE Anda
- Mengonfigurasi pengaturan untuk aplikasi
- Mengidentifikasi dan menginstal paket NuGet yang diperlukan
Prasyarat
- Penyelesaian prasyarat dan langkah-langkah dalam Tutorial: Mendaftarkan API web dengan platform identitas Microsoft.
- Anda dapat mengunduh IDE yang digunakan dalam tutorial ini dari halaman Unduhan .
- Visual Studio 2022
- Visual Studio Code
- Visual Studio 2022 untuk Mac
- Persyaratan minimum .NET 6.0 SDK.
Membuat proyek ASP.NET Core
Gunakan tab berikut untuk membuat proyek ASP.NET Core dalam IDE.
- Buka Visual Studio, lalu pilih Buat proyek baru.
- Cari dan pilih templat ASP.NET Core Empty , lalu pilih Berikutnya.
- Masukkan nama untuk proyek, seperti NewWebAPILocal.
- Pilih lokasi untuk proyek atau terima opsi default, lalu pilih Berikutnya.
- Terima default untuk Kerangka Kerja dan Konfigurasikan untuk HTTPS.
- Pilih Buat.
Mengonfigurasi proyek ASP.NET Core
Nilai yang direkam sebelumnya akan digunakan dalam appsettings.json untuk mengonfigurasi aplikasi untuk autentikasi. appsettings.json adalah file konfigurasi yang digunakan untuk menyimpan pengaturan aplikasi yang digunakan selama run-time.
Buka appsettings.json dan ganti konten file dengan cuplikan kode berikut:
{ "AzureAd": { "Instance": "https://login.microsoftonline.com/", "ClientId": "Enter the client ID here", "TenantId": "Enter the tenant ID here", "Scopes": "Forecast.Read" }, "Logging": { "LogLevel": { "Default": "Information", "Microsoft.AspNetCore": "Warning" } }, "AllowedHosts": "*" }
Instance
- Titik akhir penyedia cloud. Periksa dengan berbagai titik akhir yang tersedia di cloud Nasional.TenantId
- Pengidentifikasi penyewa tempat aplikasi terdaftar. Ganti teks dalam tanda kutip dengan nilai ID Direktori (penyewa) yang direkam sebelumnya dari halaman gambaran umum aplikasi terdaftar.ClientId
- Pengidentifikasi aplikasi, juga disebut sebagai klien. Ganti teks dalam tanda kutip dengan nilai ID Aplikasi (klien) yang direkam sebelumnya dari halaman gambaran umum aplikasi terdaftar.Scopes
- Cakupan yang digunakan untuk meminta akses ke aplikasi. Untuk tutorial ini, cakupannya adalahForecast.Read
.
Simpan perubahan pada file.
Menginstal paket identitas
Paket NuGet terkait identitas harus diinstal dalam proyek agar autentikasi pengguna diaktifkan.
- Di menu atas, pilih Alat>NuGet Package Manager>Kelola Paket NuGet untuk Solusi.
- Dengan tab Telusuri dipilih, cari Microsoft.Identity.Web, pilih
Microsoft.Identity.Web
paket, pilih kotak centang Proyek , lalu pilih Instal. - Pilih Ok atau Saya Terima untuk jendela lain yang mungkin muncul.