Öğretici: Bir uygulamayı kimlik doğrulaması için hazırlama

Önceki öğreticide, Microsoft Entra yönetim merkezine bir web uygulaması kaydettiniz. Bu öğreticide IDE kullanarak ASP.NET Core web uygulamasının nasıl oluşturulacağı gösterilmektedir. Ayrıca uygulamanızın güvenliğini sağlamak için otomatik olarak imzalanan bir sertifika oluşturup Microsoft Entra yönetim merkezine yükleyeceksiniz. Son olarak, uygulamayı kimlik doğrulaması için yapılandıracaksınız.

Bu öğreticide:

Önkoşullar

• Öğretici: Bir uygulamayı Microsoft kimlik platformu kaydetme bölümünde önkoşulların ve adımların tamamlanması.
• Bu öğreticide kullanılan bir IDE'yi buradan 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.

Otomatik olarak imzalanan sertifika oluşturma ve karşıya yükleme

Sertifikaların kullanılması, istemci ve sunucu arasındaki iletişimin güvenliğini sağlamanın önerilen bir yoludur. Bu öğreticinin amacı doğrultusunda proje dizininde otomatik olarak imzalanan bir sertifika oluşturulacaktır. Otomatik olarak imzalanan sertifikalar hakkında daha fazla bilgiyi burada bulabilirsiniz.

Microsoft Entra yönetim merkezine sertifika yükleme

Sertifikanın uygulamanın kullanımına sunulması için kiracıya yüklenmesi gerekir.

1. Daha önce oluşturulan uygulamanın Genel Bakış sayfasından başlayarak Yönet'in altında Sertifikalar ve gizli diziler'i seçin ve Sertifikalar (0) sekmesini seçin.

2. Sertifikayı karşıya yükle’yi seçin.

   

3. Klasör simgesini seçin, ardından daha önce oluşturulmuş sertifikayı bulun ve seçin.

4. Sertifika için bir açıklama girin ve Ekle'yi seçin.

5. Sonraki adımda kullanılacak Parmak İzi değerini kaydedin.

   

Uygulamayı kimlik doğrulaması ve API başvurusu için yapılandırma

Daha önce kaydedilen değerler, uygulamayı kimlik doğrulaması için yapılandırmak için kullanılır. appsettings.json yapılandırma dosyası, çalışma zamanında kullanılan uygulama ayarlarını depolamak için kullanılır. Uygulama bir web API'sine de çağrı yapacağından, buna bir başvuru da içermelidir.

1. IDE'nizde appsettings.json açın ve dosya içeriğini aşağıdaki kod parçacığıyla değiştirin. Tırnak içindeki metni daha önce kaydedilmiş değerlerle değiştirin.

   {
   "AzureAd": {
     "Instance": "https://login.microsoftonline.com/",
     "TenantId": "Enter the tenant ID obtained from the Microsoft Entra admin center",
     "ClientId": "Enter the client ID obtained from the Microsoft Entra admin center",
     "ClientCertificates": [
       {
         "SourceType": "StoreWithThumbprint",
         "CertificateStorePath": "CurrentUser/My",
         "CertificateThumbprint": "Enter the certificate thumbprint obtained the Microsoft Entra admin center"
       }   
     ],
     "CallbackPath": "/signin-oidc"
   },
     "DownstreamApi": {
       "BaseUrl": "https://graph.microsoft.com/v1.0/",
       "RelativePath": "me",
       "Scopes": [ 
         "user.read" 
       ]
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*"
   }
   

   • Instance - Kimlik doğrulama 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.
   • ClientCertificates - Uygulamada kimlik doğrulaması için otomatik olarak imzalanan bir sertifika kullanılır. metnini CertificateThumbprint , daha önce kaydedilmiş sertifikanın parmak iziyle değiştirin.
   • CallbackPath - Sunucunun yanıtı uygun uygulamaya yönlendirmesine yardımcı olan bir tanımlayıcıdır.
   • DownstreamApi - Microsoft Graph'a erişmek için uç noktayı tanımlayan bir tanımlayıcıdır. Uygulama URI'si belirtilen kapsamla birleştirilir. Kuruluşa ait bir uygulamanın yapılandırmasını tanımlamak için özniteliğin Scopes değeri biraz farklıdır.

2. Dosyadaki değişiklikleri kaydedin.

3. Özellikler klasöründe launch Ayarlar.json dosyasını açın.

4. Launch Ayarlar.json içindeki değeri bulun ve kaydedinhttps, örneğinhttps://localhost:{port}.applicationURI Bu URL, Yeniden Yönlendirme URI'si tanımlanırken kullanılır. değerini kullanmayın http .

Platform yeniden yönlendirme URI'sini ekleme

1. Microsoft Entra yönetim merkezinde, Yönet'in altında Uygulama kayıtları'ı seçin ve ardından daha önce oluşturulmuş olan uygulamayı seçin.

2. Soldaki menüde Yönet'in altında Kimlik Doğrulaması'nı seçin.

3. Platform yapılandırmaları bölümünde Platform ekle'yi ve ardından Web'i seçin.

   

4. Yeniden yönlendirme URI'leri'nin altında ve CallbackPathdeğerini /signin-oidcbiçiminde https://localhost:{port}/signin-oidcgirinapplicationURL.

5. Ön kanal oturumu kapatma URL'si altında, oturumu kapatma https://localhost:{port}/signout-oidciçin aşağıdaki URL'yi girin.

6. Yapılandır'yı seçin.

Sonraki adımlar