Yerel kimlik doğrulamasını kullanarak örnek Android (Kotlin) uygulamasında kullanıcılarla oturum açma

Şunun için geçerlidir: Dış kiracılar (daha fazla bilgi edinin)

Bu hızlı başlangıçta, Microsoft Entra'nın yerel kimlik doğrulamasını kullanarak kaydolma, oturum açma, oturumu kapatma ve parola sıfırlama senaryolarını gösteren bir Android örnek uygulamasını çalıştırmayı öğreneceksiniz.

Önkoşullar

• Aktif bir aboneliğe sahip bir Azure hesabı. Henüz bir hesabınız yoksa, ü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

• Dış kiracı. Eğer bir tane yoksa, Microsoft Entra yönetim merkezinde yeni bir dış kiracı oluşturun.

• Henüz yapmadıysanız, Microsoft Entra yönetim merkezine bir uygulama kaydedin. Şu şekilde olduğundan emin olun:

  • Daha sonra kullanmak üzere Uygulama (istemci) kimliğini ve Dizin (kiracı) kimliğini kaydedin.
  • Uygulamaya yönetici onayı verin .

• Henüz yapmadıysanız Microsoft Entra yönetim merkezinde kullanıcı akışı oluşturma

• Uygulama kaydınızı kullanıcı akışıyla ilişkilendirme

• Android Studio.

Genel istemci ve yerel kimlik doğrulama akışlarını etkinleştirme

Bu uygulamanın genel bir istemci olduğunu ve yerel kimlik doğrulamasını kullanabileceğini belirtmek için genel istemci ve yerel kimlik doğrulama akışlarını etkinleştirin:

1. Uygulama kayıtları sayfasından, genel istemci ve yerel kimlik doğrulama akışlarını etkinleştirmek istediğiniz uygulama kaydını seçin.
2. Yönet'in altında Kimlik Doğrulama'yı seçin.
3. Gelişmiş ayarlaraltında genel istemci akışlarına izin verin:
   1. Için Aşağıdaki mobil ve masaüstü akışlarını etkinleştirin Evet seçin.
   2. yerel kimlik doğrulamasını etkinleştir için Evet seçin.
4. Seç Kaydet düğmesini.

Örnek Android mobil uygulamasını kopyalama

1. Terminal'i açın ve kodu saklamak istediğiniz dizine gidin.

2. Aşağıdaki komutu çalıştırarak GitHub'dan uygulamayı kopyalayın:

   git clone https://github.com/Azure-Samples/ms-identity-ciam-native-auth-android-sample 
   

Örnek Android mobil uygulamasını yapılandırma

1. Android Studio'da kopyaladığınız projeyi açın.

2. app/src/main/res/raw/native_auth_sample_app_config.json dosyasını açın.

3. Yer tutucuyu bulun:

   • Enter_the_Application_Id_Here ve daha önce kaydettiğiniz uygulamanın Uygulama (istemci) kimliği ile değiştirin.
   • Enter_the_Tenant_Subdomain_Here ile dizin (kiracı) alt alan adını değiştirin. Örneğin, kiracının birincil alan adı contoso.onmicrosoft.com ise contoso kullanın. Kiracı alt etki alanınızı bilmiyorsanız, kiracı ayrıntılarınıza ulaşmayı öğrenin.

Uygulamayı yapılandırdıktan sonra çalışmaya hazır.

Örnek Android mobil uygulamasını çalıştırma ve test edin

Uygulamanızı derlemek ve çalıştırmak için şu adımları izleyin:

1. Araç çubuğunda, çalıştırma yapılandırmaları menüsünden uygulamanızı seçin.

2. Hedef cihaz menüsünde, uygulamanızı çalıştırmak istediğiniz cihazı seçin.

   Yapılandırılmış cihaz yoksa, Android Öykünücüsü'ni kullanmak için bir Android Sanal Cihaz oluşturmanız veya fiziksel bir Android cihazı bağlamanız gerekir.

3. Çalıştır düğmesini seçin. Uygulama E-posta ve OTP ekranını açar.

   

4. Geçerli bir e-posta adresi girin ve ardından Kaydol düğmesini seçin. Uygulama, kod gönderme ekranını açar ve e-posta adresinde bir OTP kodu alırsınız.

   

5. E-posta gelen kutusuna aldığınız OTP kodunu girin ve İleri'yi seçin. Kaydolma işlemi başarılı olursa, uygulama otomatik olarak oturum açar. Eğer e-posta gelen kutunuzda OTP kodunu almazsanız, bir süre sonra Geçiş Kodunu Yeniden Gönder'i seçerek kodu tekrar gönderebilirsiniz.

6. Oturumu kapatmak için Oturumu kapat düğmesini seçin.

Bu örneğin desteklediği diğer senaryolar

Bu örnek uygulama aşağıdaki kimlik doğrulama akışlarını da destekler:

• E-posta + parola , parolalı bir e-posta ile oturum açma veya kaydolma akışlarını kapsar.
• Kullanıcı öznitelikleriyle e-posta + parola kaydolma , e-posta ve parola ile kaydolmayı ve kullanıcı özniteliklerini göndermeyi kapsar.
• Parola sıfırlama , self servis parola sıfırlamayı (SSPR) kapsar.
• Access Korumalı API , kullanıcı başarıyla kaydolduktan veya oturum açıp erişim belirteci aldıktan sonra korumalı BIR API çağırmayı kapsar.
• Web tarayıcısına geri dönüş , kullanıcı her nedenden dolayı yerel kimlik doğrulaması aracılığıyla kimlik doğrulamasını tamamlayamıyorsa tarayıcı tabanlı kimlik doğrulamasını geri dönüş mekanizması olarak kullanmayı kapsar.

Parola akışıyla e-postayı test edin

Bu bölümde, e-posta ve şifre akışını, kullanıcı öznitelikleri ile e-posta ve şifreyle kayıt olma ve SSPR varyasyonlarıyla test edin.

1. Yeni bir kullanıcı akışı oluşturmak için kullanıcı akışı oluşturma adımlarını kullanın, ancak bu kez kimlik doğrulama yönteminiz olarak Parola ile e-posta gönder'i seçin. Ülke/Bölge ve Şehir değerlerini kullanıcı öznitelikleri olarak yapılandırmanız gerekir. Alternatif olarak, mevcut kullanıcı akışını parolayla E-posta kullanacak şekilde değiştirebilirsiniz (Dış Kimlikler>Kullanıcı akışları>SignInSignUpSample>Kimlik sağlayıcıları> Parola >ile e-postaseçin).

2. Yeni kullanıcı akışınıza uygulama eklemek için uygulamayı yeni kullanıcı akışıyla ilişkilendirme adımlarını kullanın.

3. Örnek uygulamayı çalıştırın ve daha fazla seçenek açmak için üç nokta menüsünü (...) seçin.

4. E-posta + parola veya Kullanıcı öznitelikleriyle e-posta + parola kaydolma veya Parola sıfırlama gibi test etmek istediğiniz senaryoyu seçin, ardından istemleri izleyin. Parola sıfırlamayı test etmek için önce bir kullanıcıya kaydolmanız ve kiracınızdaki tüm kullanıcılar için tek seferlik e-posta geçiş kodunu etkinleştirmeniz gerekir.

Korumalı API akışını test çağrısı

Örnek bir Android mobil uygulamasından korumalı bir web API'sini çağırmak için yerel kimlik doğrulamasını kullanarak örnek bir Android mobil uygulamasında korumalı web API'sini çağırma altındaki adımları kullanın.

Diğer ad veya kullanıcı adıyla oturum açmayı etkinleştirme

E-posta adresi ve parolayla oturum açan kullanıcıların kullanıcı adı ve parolayla da oturum açmasına izin vekleyebilirsiniz. Alternatif oturum açma tanımlayıcısı olarak da adlandırılan kullanıcı adı, müşteri kimliği, hesap numarası veya kullanıcı adı olarak kullanmayı seçtiğiniz başka bir tanımlayıcı olabilir.

Kullanıcı hesabına kullanıcı adlarını Microsoft Entra yönetim merkezi aracılığıyla el ile atayabilir veya Microsoft Graph API'sini kullanarak uygulamanızda otomatikleştirebilirsiniz.

Kullanıcılarınızın uygulamanızda bir kullanıcı adı kullanarak oturum açmasına izin vermek için Diğer ad veya kullanıcı adıyla oturum açma makalesindeki adımları kullanın:

1. Giriş sırasında kullanıcı adınızı etkinleştirin.
2. Yönetim merkezinde kullanıcı adı olan kullanıcılar oluşturun veya bir kullanıcı adı ekleyerek mevcut kullanıcıları olarak güncelleştirin. Alternatif olarak, Microsoft Graph API'sini kullanarak uygulamanızda kullanıcı oluşturma ve güncellemeyi otomatikleştirebilirsiniz.

Sonraki Adımlar

Eğitim: Android uygulamanızı yerel kimlik doğrulamaiçin hazırlayın.