Örnek bir .NET MAUI Android uygulamasında kullanıcıları oturum açma

Şunlar için geçerlidir: İş gücü kiracılarıDış kiracılar (daha fazla bilgi edinin)

Bu nasıl yapılır kılavuzu, dış kiracı kullanarak bir Android uygulamasına kimlik doğrulaması eklemeyi göstermek için örnek bir .NET Çok platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) kullanır. Örnek uygulama, kullanıcıların oturum açmasını ve oturumu kapatmasını sağlar. Örnek .NET MAUI Android uygulaması, kimlik doğrulamasını işlemek için .NET için Microsoft Authentication Library (MSAL) kullanır.

Bu makalede aşağıdaki görevleri yerine getirin:

• Dış kiracıya bir .NET MAUI Android uygulaması kaydedin.
• Dış kiracıda oturum açma ve oturumu kapatma kullanıcı akışı oluşturun.
• .NET MAUI Android uygulamanızı kullanıcı akışıyla ilişkilendirin.
• Kendi dış kiracı ayrıntılarınızı kullanmak için örnek bir .NET MAUI Android uygulamasını güncelleştirin.
• Örnek .NET MAUI Android uygulamasını çalıştırın ve test edin.

Önkoşullar

• .NET 7.0 SDK
• MAUI iş yükünün yüklü olduğu Visual Studio 2022 :
  • Windows Yönergeleri
  • macOS için yönergeler
• Dış kiracı. Henüz bir aboneliğiniz yoksa ücretsiz deneme sürümüne kaydolun.

.NET MAUI Android uygulamasını kaydetme

Uygulamanızın Microsoft Entra ile kullanıcılarla oturum açmasını sağlamak için Microsoft Entra Dış Kimlik oluşturduğunuz uygulama hakkında bilgi edinilmesi gerekir. 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:

1. Microsoft Entra yönetim merkezinde en azından Uygulama Geliştiricisi olarak oturum açın.

2. Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden dış kiracınıza geçmek için üst menüdeki Ayarlar simgesinikullanın.

3. Kimlik>Uygulamaları'na> göz atın Uygulama kayıtları.

4. + Yeni kayıt'ı seçin.

5. Görüntülenen Uygulamayı kaydet sayfasında;

   1. Uygulamanın kullanıcılarına gösterilen anlamlı bir uygulama Adı girin, örneğin ciam-client-app.
   2. Desteklenen hesap türleri'nin altında Yalnızca bu kuruluş dizinindeki Hesaplar'ı seçin.

6. Kaydet'i seçin.

7. 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.

Uygulama kaydınıza uygulama türünüzü belirtmek için şu adımları izleyin:

1. Yönet'in altında Kimlik Doğrulama'yı seçin.
2. Platform yapılandırmaları sayfasında Platform ekle'yi ve ardından Mobil ve Masaüstü uygulamaları seçeneğini belirleyin.
3. Yeniden Yönlendirme URI'leri için değerini daha önce kopyaladığınız Uygulama (istemci) kimliğiyle değiştirin msalEnter_the_Application_Id_Here://authEnter_the_Application_Id_Here ve Yapılandır'ı seçin.
4. Değişiklikleri kaydetmek için Kaydet'i seçin.

Yönetici onayı verme

1. Uygulama kayıtları sayfasında, oluşturduğunuz uygulamayı (ciam-client-app gibi) seçerek Genel Bakış sayfasını açın.

2. Yönet'in altında API izinleri'ne tıklayın. Yapılandırılan izinler listesinden, uygulamanıza User.Read izni atanmıştır. Ancak, kiracı bir dış kiracı olduğundan, tüketici kullanıcıların kendileri bu izni onaylayamaz. Yönetici olarak kiracıdaki tüm kullanıcılar adına bu izni onaylamanız gerekir:

   1. Kiracı adınız> için <Yönetici onayı ver'i ve ardından Evet'i seçin.
   2. Yenile'yi seçin, ardından her iki kapsam için de Durum altında Kiracı adınız> için <Verildi ifadesinin gösterildiğini 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.

1. Microsoft Entra yönetim merkezinde en azından Dış Kimlik Kullanıcı Akışı Yönetici istrator olarak oturum açın.

2. Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden dış kiracınıza geçmek için üst menüdeki Ayarlar simgesinikullanın.

3. Kimlik>Dış Kimlikleri>Kullanıcı akışları'na göz atın.

4. + Yeni kullanıcı akışı'ni seçin.

5. Oluştur sayfasında:

   1. Kullanıcı akışı için SignInSignUpSample gibi bir Ad girin.

   2. Kimlik sağlayıcıları listesinde E-posta Hesapları'nı seçin. Bu kimlik sağlayıcısı, kullanıcıların e-posta adreslerini kullanarak oturum açmalarına veya kaydolmalarına olanak tanır.

      Not

      Ek kimlik sağlayıcıları burada yalnızca federasyon ayarladıktan sonra listelenir. Örneğin, Google veya Facebook ile federasyon ayarlarsanız bu ek kimlik sağlayıcılarını buradan seçebilirsiniz.

   3. E-posta hesapları'nın altında iki seçenek arasından birini belirleyebilirsiniz. Bu öğretici için Parolayla e-posta gönder'i seçin.

      • Parolalı e-posta: Yeni kullanıcıların oturum açma adı olarak bir e-posta adresi ve ilk faktör kimlik bilgileri olarak parola kullanarak kaydolmasına ve oturum açmasına izin verir.
      • Tek seferlik geçiş kodunu e-postayla gönderme: Yeni kullanıcıların oturum açma adı olarak bir e-posta adresi ve ilk faktör kimlik bilgileri olarak bir kerelik e-posta geçiş kodu kullanarak kaydolmasına ve oturum açmasına olanak tanır. Bu seçeneğin kullanıcı akışı düzeyinde kullanılabilir olması için tek seferlik e-posta geçiş kodu kiracı düzeyinde (Tüm Kimlik Sağlayıcıları>E-posta Bir kerelik geçiş kodu) etkinleştirilmelidir.

   4. Kullanıcı öznitelikleri'nin altında, kayıt sırasında 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.)

6. Oluştur'u belirleyin. 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.

.NET MAUI Android 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 oturum açmasını veya e-posta adresiyle kaydolmasını gerektiren bir kullanıcı akışı yapılandırabilirsiniz.

1. Kenar çubuğu menüsünde Kimlik'i seçin.

2. Dış Kimlikler'i ve ardından Kullanıcı akışları'yı seçin.

3. Kullanıcı akışları sayfasında, daha önce oluşturduğunuz Kullanıcı akışı adını (örneğin, SignInSignUpSample) seçin.

4. Kullan'ın altında Uygulamalar'ı seçin.

5. Uygulama ekle'yi seçin.

6. Ciam-client-app gibi listeden uygulamayı seçin veya uygulamayı bulmak için arama kutusunu kullanın ve ardından seçin.

7. Seç'i seçin.

Örnek .NET MAUI Android uygulamasını kopyalama veya indirme

.NET MAUI Android uygulama örnek kodunu almak için .zip dosyasını indirin veya aşağıdaki komutu çalıştırarak GitHub'dan örnek .NET MAUI Android uygulamasını kopyalayın:

git clone https://github.com/Azure-Samples/ms-identity-ciam-dotnet-tutorial.git

Örnek .NET MAUI Android uygulamasını yapılandırma

1. Visual Studio'da ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/appsettings.json dosyasını açın.
2. Yer tutucuyu bulun:
   1. Enter_the_Tenant_Subdomain_Here ve bunu Dizin (kiracı) alt etki alanıyla değiştirin. Örneğin, kiracı birincil etki alanınız ise contoso.onmicrosoft.comkullanın contoso. Kiracı adınız yoksa kiracınızın ayrıntılarını nasıl okuyacağınızı öğrenin.
   2. Enter_the_Application_Id_Hereve daha önce kaydettiğiniz uygulamanın Uygulama (istemci) kimliğiyle değiştirin.
3. Visual Studio'da ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/Platforms/Android/AndroidManifest.xml dosyasını açın.
4. Yer tutucuyu bulun:
   1. Enter_the_Application_Id_Hereve daha önce kaydettiğiniz uygulamanın Uygulama (istemci) kimliğiyle değiştirin.

Örnek .NET MAUI Android uygulamasını çalıştırma ve test edin

.NET MAUI uygulamaları birden çok işletim sistemi ve cihazda çalışacak şekilde tasarlanmıştır. Uygulamanızı test etmek ve hatalarını ayıklamak istediğiniz hedefi seçmeniz gerekir.

Visual Studio araç çubuğundaki Hata Ayıklama Hedefi'ni, hata ayıklamak ve test etmek istediğiniz cihaz olarak ayarlayın. Aşağıdaki adımlar, Hata Ayıklama Hedefi'ni Android'e ayarlamayı gösterir:

1. Hedefte Hata Ayıkla açılan menüsünü seçin.
2. Android Öykünücüleri'ne tıklayın.
3. Öykünücü cihazı'ni seçin.

F5 tuşuna basarak uygulamayı çalıştırın veya Visual Studio'nun üst kısmındaki yürüt düğmesini seçin.

1. Artık örnek .NET MAUI Android uygulamasını test edebilirsiniz. Uygulamayı çalıştırdıktan sonra, Android uygulama penceresi öykünücüde görünür:

   

2. Görüntülenen Android penceresinde Oturum Aç düğmesini seçin. Bir tarayıcı penceresi açılır ve oturum açmanız istenir.

   

   Oturum açma işlemi sırasında, çeşitli izinler vermeniz istenir (uygulamanın verilerinize erişmesine izin vermek için). Başarılı oturum açma ve onay sonrasında uygulama ekranı ana sayfayı görüntüler.

   

Sonraki Adımlar

• Varsayılan markayı özelleştirin.
• Google ile oturum açmayı yapılandırın.