Aracılığıyla paylaş

Öğretici: Kimlik doğrulaması için ASP.NET Core projesi oluşturma ve yapılandırma

  • Makale

Bu öğreticide, IDE kullanarak bir ASP.NET Core projesi oluşturmayı ve bunu kimlik doğrulaması ve yetkilendirme için yapılandırmayı öğreneceksiniz. Bu öğretici, Microsoft kimlik platformu kullanarak bir web API'sinin güvenliğini sağlamayı gösteren serinin ikinci bölümüdür. Önceki makalede, Microsoft Entra Id kiracınıza bir uygulama kaydettiniz. Bu makalede, siz;

  • IDE'nizde ASP.NET Çekirdek Boş projesi oluşturma
  • Uygulama ayarlarını yapılandırma
  • Gerekli NuGet paketlerini tanımlama ve yükleme

Önkoşullar

  • Öğretici: Web API'sini Microsoft kimlik platformu kaydetme bölümünde önkoşulların ve adımların tamamlanması.
  • bu öğreticide kullanılan IDE'leri İndirmeler sayfasından indirebilirsiniz.
    • Visual Studio 2022
    • Visual Studio Code
    • Mac için Visual Studio 2022
  • .NET 6.0 SDK'sının en düşük gereksinimi.

ASP.NET Core projesi oluşturma

IDE içinde ASP.NET Core projesi oluşturmak için aşağıdaki sekmeleri kullanın.

  1. Visual Studio'yu açın ve ardından Yeni proje oluştur'u seçin.
  2. ASP.NET Çekirdek Boş şablonunu arayıp seçin ve ardından İleri'yi seçin.
  3. Proje için NewWebAPILocal gibi bir ad girin.
  4. Proje için bir konum seçin veya varsayılan seçeneği kabul edin ve ardından İleri'yi seçin.
  5. Çerçeve ve HTTPS için Yapılandır için varsayılan değeri kabul edin.
  6. Oluştur'u belirleyin.

ASP.NET Core projesini yapılandırma

Daha önce kaydedilen değerler, uygulamayı kimlik doğrulaması için yapılandırmak üzere appsettings.json kullanılacaktır. appsettings.json, çalışma zamanında kullanılan uygulama ayarlarını depolamak için kullanılan bir yapılandırma dosyasıdır.

  1. appsettings.json açın ve dosya içeriğini aşağıdaki kod parçacığıyla değiştirin:

    {
  "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 - Bulut sağlayıcısının uç noktası. Ulusal bulutlardaki farklı kullanılabilir uç noktaları denetleyin.
    • TenantId - Uygulamanın kayıtlı olduğu kiracının tanımlayıcısı. Tırnak içindeki metni, kayıtlı uygulamanın genel bakış sayfasından daha önce kaydedilen Dizin (kiracı) Kimliği değeriyle değiştirin.
    • ClientId - İstemci olarak da adlandırılan uygulamanın tanımlayıcısı. Tırnak içindeki metni, kayıtlı uygulamanın genel bakış sayfasından daha önce kaydedilen Uygulama (istemci) Kimliği değeriyle değiştirin.
    • Scopes - Uygulamaya erişim istemek için kullanılan kapsam. Bu öğretici için kapsamı şeklindedir Forecast.Read.

  2. Dosyadaki değişiklikleri kaydedin.

Kimlik paketlerini yükleme

Kullanıcıların kimlik doğrulamasının etkinleştirilmesi için projeye kimlikle ilgili NuGet paketleri yüklenmelidir.

  1. Üstteki menüde Araçlar>NuGet Paket Yöneticisi> Çözüm için NuGet Paketlerini Yönet'i seçin.
  2. Gözat sekmesi seçiliyken Microsoft.Identity.Web araması yapın, paketi seçinMicrosoft.Identity.Web, Proje onay kutusunu seçin ve ardından Yükle'yi seçin.
  3. Görünebilecek diğer pencereler için Tamam'ı veya Kabul Ediyorum'ı seçin.

Sonraki adımlar

Öğretici: API'nize korumalı uç nokta uygulama