Öğretici: ASP.NET web uygulamasında kullanıcıların kimliğini doğrulamak için müşteri kiracınızı hazırlama
Bu öğretici serisi, sıfırdan bir ASP.NET web uygulaması oluşturmayı ve Microsoft Entra yönetim merkezini kullanarak kimlik doğrulaması için hazırlamayı gösterir. Müşterilerinizin Microsoft Entra kimliği kiracısıyla uygulamanızın kimliğini doğrulamak için .NET için Microsoft Kimlik Doğrulama Kitaplığı'nı ve Microsoft Identity Web kitaplıklarını kullanacaksınız. Son olarak uygulamayı çalıştıracak ve oturum açma ve oturum kapatma deneyimlerini test edin.
Bu öğreticide;
- web uygulamasını Microsoft Entra yönetim merkezine kaydetme ve tanımlayıcılarını kaydetme
- Web uygulaması için istemci gizli dizisi oluşturma
- Platformu ve URL'leri tanımlama
- Web uygulamasına Microsoft Graph API erişim izinleri verme
- Microsoft Entra yönetim merkezinde oturum açma ve kullanıcı akışını kapatma
- Web uygulamanızı kullanıcı akışıyla ilişkilendirme
Önkoşullar
Azure aboneliği. Hesabınız yoksa başlamadan önce ücretsiz bir hesap oluşturun .
Bu Azure hesabının uygulamaları yönetme izinleri olmalıdır. Aşağıdaki Microsoft Entra rollerinden herhangi biri gerekli izinleri içerir:
- Uygulama yöneticisi
- Uygulama geliştirici
- Bulut uygulaması yöneticisi
Müşteriler kiracısı için Microsoft Entra kimliği. Henüz oluşturmadıysanız şimdi bir tane oluşturun. Varsa mevcut bir müşteri kiracısını kullanabilirsiniz.
Web uygulamasını kaydetme ve tanımlayıcıları kaydetme
Uygulamanızın kullanıcıları Microsoft Entra ile oturum açmasını sağlamak için, müşteriler için Microsoft Entra kimliği oluşturduğunuz uygulamadan haberdar edilmelidir. Uygulama kaydı, uygulama ile Microsoft Entra arasında bir güven ilişkisi kurar. Bir uygulamayı kaydettiğinizde, Dış Kimlik, kimlik doğrulama istekleri oluştururken uygulamanızı tanımlamak için kullanılan bir değer olan Uygulama (istemci) Kimliği olarak bilinen benzersiz bir tanımlayıcı oluşturur.
Aşağıdaki adımlar, uygulamanızı Microsoft Entra yönetim merkezine nasıl kaydedeceğini gösterir:
Microsoft Entra yönetim merkezinde en azından Uygulama Geliştiricisi olarak oturum açın.
Birden çok kiracıya erişiminiz varsa, müşteri kiracınıza geçmek için üst menüdeki Dizinler + abonelikler filtresini
kullanın.Kimlik>Uygulamaları>Uygulama kayıtları'na göz atın.
+ Yeni kayıt'ı seçin.
Görüntülenen Uygulamayı kaydet sayfasında;
- Uygulamanın kullanıcılarına gösterilen anlamlı bir uygulama Adı girin, örneğin ciam-client-app.
- Desteklenen hesaptürleri'nin altında Yalnızca bu kuruluş dizinindeki hesaplar'ı seçin.
Kaydet’i seçin.
Başarılı bir kayıtta uygulamanın Genel Bakış bölmesi görüntülenir. Uygulama kaynak kodunuzda kullanılacak Uygulama (istemci) kimliğini kaydedin.
Platform yeniden yönlendirme URL'si ekleme
Uygulama kaydınıza uygulama türünüzü belirtmek için şu adımları izleyin:
- Yönet'in altında Kimlik Doğrulama'yı seçin.
- Platform yapılandırmaları sayfasında Platform ekle'yi ve ardından Web seçeneğini belirleyin.
- Yeniden Yönlendirme URI'leri için girin
https://localhost:7274/signin-oidc. - Ön kanal oturumu kapatma URL'si altında oturumu kapatma için girin
https://localhost:7274/signout-callback-oidc. - Değişikliklerinizi kaydetmek için Yapılandır'ı seçin.
Uygulama istemci gizli anahtarı ekleme
Kayıtlı uygulama için bir istemci gizli dizisi oluşturun. Uygulama, belirteç istediğinde kimliğini kanıtlamak için istemci gizli dizisini kullanır.
- Uygulama kayıtları sayfasında, oluşturduğunuz uygulamayı (ciam-client-app gibi) seçerek Genel Bakış sayfasını açın.
- Yönet'in altında Sertifika gizli dizileri'ni &seçin.
- Yeni istemci gizli dizisi'ni seçin.
- Açıklama kutusuna istemci gizli dizisi için bir açıklama girin (örneğin, ciam uygulama istemci gizli dizisi).
- Süre Sonu'nun altında gizli dizinin geçerli olduğu bir süre seçin (kuruluşunuzun güvenlik kuralları başına) ve ardından Ekle'yi seçin.
- Gizli dizinin Değerini kaydedin. Bu değeri sonraki bir adımda yapılandırma için kullanacaksınız.
Not
Gizli dizi değeri yeniden görüntülenmez ve Sertifikalar ve gizli diziler sayfasından uzaklaştıktan sonra herhangi bir yolla alınamaz, bu nedenle kaydettiğinizden emin olun.
Gelişmiş güvenlik için istemci gizli dizileri yerine sertifikaları kullanmayı göz önünde bulundurun.
API izinleri verme
Uygulama kayıtları sayfasında, oluşturduğunuz uygulamayı (ciam-client-app gibi) seçerek Genel Bakış sayfasını açın.
Yönet'in altında API izinleri'ne tıklayın.
Yapılandırılan izinler'in altında İzin ekle'yi seçin.
Microsoft API'leri sekmesini seçin.
Yaygın olarak kullanılan Microsoft API'leri bölümünde Microsoft Graph'ı seçin.
Temsilci izinleri seçeneğini belirleyin.
İzinleri seçin bölümünde hem openid hem de offline_access izinlerini arayın ve seçin.
İzin ekle düğmesini seçin.
Bu noktada izinleri doğru atamışsınız. Ancak kiracı bir müşterinin kiracısı olduğundan, tüketici kullanıcıları bu izinlere onay veremez. Yönetici olarak kiracıdaki tüm kullanıcılar adına bu izinleri onaylamanız gerekir:
- Kiracı adınız> için <yönetici onayı ver'i ve ardından Evet'i seçin.
- Yenile'yi seçin, ardından kiracı adınız> için <Verildi seçeneğinin her iki kapsam için de Durum altında göründüğünü doğrulayın.
Kullanıcı akışı oluşturma
Müşterinin bir uygulamada oturum açmak veya uygulamaya kaydolmak için kullanabileceği bir kullanıcı akışı oluşturmak için bu adımları izleyin.
Microsoft Entra yönetim merkezinde en azından Dış Kimlik Kullanıcı Akışı Yöneticisi olarak oturum açın.
Birden çok kiracıya erişiminiz varsa, müşteri kiracınıza geçmek için üst menüdeki Dizinler + abonelikler filtresini
kullanın.Kimlik>Dış Kimlikleri>Kullanıcı akışları'na göz atın.
+ Yeni kullanıcı akışı'ı seçin.
Oluştur sayfasında:
Kullanıcı akışı için SignInSignUpSample gibi bir Ad girin.
Kimlik sağlayıcıları listesinde Hesaplar'ı Email seçin. Bu kimlik sağlayıcısı, kullanıcıların e-posta adreslerini kullanarak oturum açmasına veya kaydolmasına olanak tanır.
Email hesaplar'ın altında iki seçenek arasından birini belirleyebilirsiniz. Bu öğretici için parolayla Email'ı seçin.
Parolayla Email: Yeni kullanıcıların oturum açma adı olarak bir e-posta adresi ve ilk faktör kimlik bilgileri olarak bir parola kullanarak kaydolmasına ve oturum açmasına izin verir.
Email tek seferlik geçiş kodu: Yeni kullanıcıların kaydolmasına ve oturum açma adı olarak bir e-posta adresi ve ilk faktör kimlik bilgileri olarak bir kerelik geçiş kodu olarak e-posta göndermesine olanak tanır.
Not
Email tek seferlik geçiş kodunun, bu seçeneğin kullanıcı akışı düzeyinde kullanılabilmesi için kiracı düzeyinde (Tüm Kimlik Sağlayıcıları>Email Tek seferlik geçiş kodu) etkinleştirilmesi gerekir.
Kullanıcı öznitelikleri'nin altında, kayıttan sonra kullanıcıdan toplamak istediğiniz öznitelikleri seçin. Daha fazla göster'i seçerek Ülke/Bölge, Görünen Ad ve Posta Kodu için öznitelikleri ve talepleri seçebilirsiniz. Tamam’ı seçin. (Kullanıcılardan yalnızca ilk kez kaydolduğunda öznitelikleri istenir.)
Oluştur’u seçin. Yeni kullanıcı akışı , Kullanıcı akışları listesinde görünür. Gerekirse sayfayı yenileyin.
Self servis parola sıfırlamayı etkinleştirmek için Self servis parola sıfırlamayı etkinleştirme makalesindeki adımları kullanın.
Web uygulamasını kullanıcı akışıyla ilişkilendirme
Birçok uygulama kullanıcı akışınız ile ilişkilendirilebilir ancak tek bir uygulama yalnızca bir kullanıcı akışıyla ilişkilendirilebilir. Kullanıcı akışı, belirli uygulamalar için kullanıcı deneyiminin yapılandırılmasına olanak tanır. Örneğin, kullanıcıların bir telefon numarası veya e-posta adresiyle oturum açmasını veya kaydolmasını gerektiren bir kullanıcı akışı yapılandırabilirsiniz.
Kenar çubuğu menüsünde Kimlik'i seçin.
Dış Kimlikler'i ve ardından Kullanıcı akışları'ı seçin.
Kullanıcı akışları sayfasında, daha önce oluşturduğunuz Kullanıcı akışı adını seçin; örneğin, SignInSignUpSample.
Kullan'ın altında Uygulamalar'ı seçin.
Uygulama ekle'yi seçin.
Ciam-client-app gibi listeden uygulamayı seçin veya uygulamayı bulmak için arama kutusunu kullanın ve ardından seçin.
Seç’i seçin.