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.

Visual Studio

1. Buka Visual Studio, lalu pilih Buat proyek baru.
2. Cari dan pilih templat ASP.NET Core Empty , lalu pilih Berikutnya.
3. Masukkan nama untuk proyek, seperti NewWebAPILocal.
4. Pilih lokasi untuk proyek atau terima opsi default, lalu pilih Berikutnya.
5. Terima default untuk Kerangka Kerja dan Konfigurasikan untuk HTTPS.
6. Pilih Buat.

Visual Studio Code

1. Buka Visual Studio Code, pilih Buka File > Folder.... Navigasi ke dan pilih lokasi untuk membuat proyek Anda.

2. Buka terminal baru dengan memilih Terminal di bilah atas, lalu Terminal Baru.

3. Buat folder baru menggunakan ikon Folder Baru... di panel Explorer . Berikan nama yang mirip dengan yang terdaftar sebelumnya, misalnya, NewWebAPILocal.

4. Buka terminal baru dengan memilih Terminal >Terminal Baru.

5. Untuk membuat templat ASP.NET Core Empty , jalankan perintah berikut di terminal untuk mengubah ke direktori dan membuat proyek:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio untuk Mac

1. Buka Visual Studio, lalu pilih Baru.
2. Di bawah Web dan Konsol di bilah navigasi kiri, pilih Aplikasi.
3. Di bawah ASP.NET Core, pilih API dan pastikan C# dipilih di menu drop-down, lalu pilih Lanjutkan.
4. Terima default untuk Kerangka Kerja Target dan Tingkat Lanjut, lalu pilih Lanjutkan.
5. Masukkan nama untuk nama Proyek, ini akan tercermin dalam Nama Solusi. Berikan nama yang mirip dengan yang terdaftar di pusat admin Microsoft Entra, seperti NewAPI1.
6. Terima lokasi default untuk proyek atau pilih lokasi lain, lalu pilih Buat.

Catatan

Visual Studio untuk Mac dijadwalkan untuk dihentikan pada 31 Agustus 2024 sesuai dengan Kebijakan Siklus Hidup Modern Microsoft. Visual Studio untuk Mac 17.6 akan terus didukung hingga 31 Agustus 2024, dengan pembaruan layanan untuk masalah keamanan dan platform yang diperbarui dari Apple. Lihat Apa yang terjadi pada Visual Studio untuk Mac untuk informasi selengkapnya.

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.

1. 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 adalah Forecast.Read.

2. Simpan perubahan pada file.

Menginstal paket identitas

Paket NuGet terkait identitas harus diinstal dalam proyek agar autentikasi pengguna diaktifkan.

Visual Studio

1. Di menu atas, pilih Alat>NuGet Package Manager>Kelola Paket NuGet untuk Solusi.
2. Dengan tab Telusuri dipilih, cari Microsoft.Identity.Web, pilih Microsoft.Identity.Web paket, pilih kotak centang Proyek , lalu pilih Instal.
3. Pilih Ok atau Saya Terima untuk jendela lain yang mungkin muncul.

Visual Studio Code

1. Di terminal yang dibuka di bagian sebelumnya, masukkan perintah berikut:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio untuk Mac

1. Di menu atas, pilih Alat>Kelola Paket NuGet.
2. Cari Microsoft.Identity.Web, pilih Microsoft.Identity.Web paket, pilih Proyek, lalu pilih Tambahkan Paket.
3. Di pop-up, pastikan proyek yang benar dipilih, lalu pilih Ok.
4. Pilih Terima jika jendela Penerimaan Lisensi lainnya muncul.

Langkah berikutnya

Tutorial: Menerapkan titik akhir yang dilindungi ke API Anda