öğretici: Azure Active Directory B2C 'de kullanıcı akışları ve özel ilkeler oluşturma

Bir Kullanıcı akışı, kullanıcıların oturum açma, kaydolma, profil düzenleme veya bir parolayı sıfırlama gibi şeyler yaparken uygulamanızla nasıl etkileşime gireceğini belirlemenizi sağlar. Bu makalede şunları öğreneceksiniz:

özel ilkeler , Azure Active Directory B2C (Azure AD B2C) kiracınızın davranışını tanımlayan yapılandırma dosyalarıdır. Bu makalede şunları öğreneceksiniz:

• Henüz bir tane yoksa, Azure aboneliğinize bağlı bir Azure AD B2C kiracı oluşturun .
• Bir Web uygulaması kaydedinve kimlik belirteci örtük izni etkinleştirin.

• Henüz bir tane yoksa, Azure aboneliğinize bağlı bir Azure AD B2C kiracı oluşturun .
• Bir Web uygulaması kaydedinve kimlik belirteci örtük izni etkinleştirin.

Kaydolma ve oturum açma Kullanıcı akışı oluşturma

Kaydolma ve oturum açma Kullanıcı akışı, hem kayıt hem de oturum açma deneyimlerini tek bir yapılandırmayla işler. Uygulamanızın kullanıcıları, bağlama göre doğru yolun altına alınır.

1. Azure Portal oturum açın.

2. Azure AD B2C kiracınızı içeren dizini kullandığınızdan emin olun. Portal araç çubuğunda dizinler + abonelikler simgesini seçin.

3. Portal Ayarları | Dizinler + abonelikler sayfasında, Dizin adı listesinde Azure AD B2C dizininizi bulun ve ardından Değiştir' i seçin.

4. Azure portal, araması yapın ve Azure AD B2C seçin.

5. İlkeler altında Kullanıcı akışları' nı seçin ve ardından Yeni Kullanıcı akışı' nı seçin.

   

6. Kullanıcı akışı oluştur sayfasında, oturum aç ve kullanıcı akışını oturum aç ' ı seçin.

   

7. Sürüm seçin altında Önerilen' i seçin ve ardından Oluştur' u seçin. (Kullanıcı akışı sürümleri hakkındadaha fazla bilgi edinin .)

   

8. Kullanıcı akışı için bir ad girin. Örneğin, signupsignin1.

9. Kimlik sağlayıcıları Için e-posta kaydı' nı seçin.

10. Kullanıcı öznitelikleri ve talepler için, kayıt sırasında kullanıcıdan toplamak ve göndermek istediğiniz talepleri ve öznitelikleri seçin. Örneğin, daha fazla göster' i seçin ve ardından ülke/bölge, görünen ad ve posta kodu için öznitelikler ve talepler ' i seçin. Tamam'a tıklayın.

    

11. Kullanıcı akışını eklemek için Oluştur ' a tıklayın. B2C_1 bir ön eki otomatik olarak ada eklenir.

Kullanıcı akışını test etme

1. Genel Bakış sayfasını açmak için oluşturduğunuz kullanıcı akışını seçin ve ardından Kullanıcı akışını Çalıştır' ı seçin.

2. Uygulama için, daha önce kaydettiğiniz WebApp1 adlı Web uygulamasını seçin. Yanıt URL 'si gösterilmesi gerekir https://jwt.ms .

3. Kullanıcı akışını Çalıştır' a tıklayın ve ardından Şimdi kaydolun' ı seçin.

   

4. Geçerli bir e-posta adresi girin, doğrulama kodu gönder' e tıklayın, aldığınız doğrulama kodunu girin ve kodu doğrula' yı seçin.

5. Yeni bir parola girin ve parolayı onaylayın.

6. Ülkenizi ve bölgenizi seçin, görüntülenmesini istediğiniz adı girin, bir posta kodu girin ve ardından Oluştur' a tıklayın. Belirteç öğesine döner https://jwt.ms ve size gösterilmesi gerekir.

7. Artık kullanıcı akışını yeniden çalıştırabilirsiniz ve oluşturduğunuz hesapla oturum açabilmelisiniz. Döndürülen belirteç, ülke/bölge, ad ve posta kodu ' nu seçtiğiniz talepleri içerir.

Kendi kendine parola sıfırlamayı etkinleştirme

Kaydolma veya oturum açma Kullanıcı akışı için self servis parola sıfırlamayı etkinleştirmek için:

1. Oluşturduğunuz kaydolma veya oturum açma kullanıcı akışını seçin.
2. sol menüdeki Ayarlar altında özellikler' i seçin.
3. Parola karmaşıklığı bölümünde self servis parola sıfırlama' yı seçin.
4. Kaydet’i seçin.

Kullanıcı akışını test etme

1. Genel Bakış sayfasını açmak için oluşturduğunuz kullanıcı akışını seçin ve ardından Kullanıcı akışını Çalıştır' ı seçin.
2. Uygulama için, daha önce kaydettiğiniz WebApp1 adlı Web uygulamasını seçin. Yanıt URL 'si gösterilmesi gerekir https://jwt.ms .
3. Kullanıcı akışını Çalıştır' ı seçin.
4. Kaydolma veya oturum açma sayfasından parolanızı unuttum? seçeneğini belirleyin.
5. Daha önce oluşturduğunuz hesabın e-posta adresini doğrulayın ve sonra devam' ı seçin.
6. Artık Kullanıcı parolasını değiştirme fırsatına sahipsiniz. Parolayı değiştirin ve devam' ı seçin. Belirteç öğesine döner https://jwt.ms ve size gösterilmesi gerekir.

Profil düzenlemesi Kullanıcı akışı oluşturma

Kullanıcıların uygulamanızdaki profilini düzenlemesini etkinleştirmek istiyorsanız, bir profil düzenleme Kullanıcı akışı kullanın.

1. Azure AD B2C kiracının Genel Bakış sayfasının menüsünde Kullanıcı akışları' nı seçin ve ardından Yeni Kullanıcı akışı' nı seçin.
2. Kullanıcı akışı oluştur sayfasında profil düzenlemesi Kullanıcı akışı ' nı seçin.
3. Sürüm seçin altında Önerilen' i seçin ve ardından Oluştur' u seçin.
4. Kullanıcı akışı için bir ad girin. Örneğin, profileediting1.
5. Kimlik sağlayıcıları Için yerel hesap oturumu açma' yı seçin.
6. Kullanıcı öznitelikleri için, müşterinin profilinde düzenleyebilmesini istediğiniz öznitelikleri seçin. Örneğin, daha fazla göster' i seçin ve görünen ad ve iş unvanı için her iki özniteliği ve talebi seçin. Tamam'a tıklayın.
7. Kullanıcı akışını eklemek için Oluştur ' a tıklayın. B2C_1 bir ön eki otomatik olarak ada eklenir.

Kullanıcı akışını test etme

1. Genel Bakış sayfasını açmak için oluşturduğunuz kullanıcı akışını seçin ve ardından Kullanıcı akışını Çalıştır' ı seçin.
2. Uygulama için, daha önce kaydettiğiniz WebApp1 adlı Web uygulamasını seçin. Yanıt URL 'si gösterilmesi gerekir https://jwt.ms .
3. Kullanıcı akışını Çalıştır' a tıklayın ve daha önce oluşturduğunuz hesapla oturum açın.
4. Artık Kullanıcı için görünen adı ve iş başlığını değiştirme fırsatına sahipsiniz. Devam’a tıklayın. Belirteç öğesine döner https://jwt.ms ve size gösterilmesi gerekir.

Uygulama uygulamaları için imzalama ve şifreleme Identity Experience Framework ekleme

1. Azure Portal oturum açın.
2. Kiracınız için kiracınızı içeren dizini Azure AD B2C olun. Portal araç çubuğunda Dizinler + abonelikler simgesini seçin.
3. Portal ayarları sayfasında | Dizinler + abonelikler sayfasında, dizin Azure AD B2C dizinlerinizi dizin adı listesinde bulup Değiştir'i seçin.
4. Aşağıdaki Azure portal için arama ve seçim Azure AD B2C.
5. Genel bakış sayfasının İlkeler'in altında, İlkeler'Identity Experience Framework.

İmzalama anahtarını oluşturma

1. İlke Anahtarları'ı ve ardından Ekle'yi seçin.
2. Seçenekler için'i Generate seçin.
3. Ad alanına TokenSigningKeyContainer girin. Ön ek B2C_1A_ otomatik olarak eklenebilir.
4. Anahtar türü olarak RSA'yi seçin.
5. Anahtar kullanımı için İmza'yi seçin.
6. Oluştur’u seçin.

Şifreleme anahtarını oluşturma

1. İlke Anahtarları'ı ve ardından Ekle'yi seçin.
2. Seçenekler için'i Generate seçin.
3. Ad alanına TokenEncryptionKeyContainer girin. _ ön B2C_1A eki otomatik olarak eklenebilir.
4. Anahtar türü olarak RSA'yi seçin.
5. Anahtar kullanımı için Şifreleme'yi seçin.
6. Oluştur’u seçin.

Uygulama Identity Experience Framework kaydetme

Azure AD B2C, kullanıcıların yerel hesaplarla kaydolması ve oturum açması için kullandığı iki uygulamayı kaydetmeniz gerekir: IdentityExperienceFramework, bir web API'si ve ProxyIdentityExperienceFramework, IdentityExperienceFramework uygulamasına temsilci izni olan yerel bir uygulama. Kullanıcılarınız kiracıya kayıtlı uygulamalarınıza erişmek için bir e-posta adresi veya kullanıcı adı ve parola ile kaydolarak "yerel hesap" oluşturur. Yerel hesaplar yalnızca kiracınız için Azure AD B2C vardır.

Bu iki uygulamanın kiracınıza yalnızca bir kez Azure AD B2C gerekir.

IdentityExperienceFramework uygulamasını kaydetme

Bir uygulamayı Azure AD B2C kiracınıza kaydetmek için uygulama deneyimini Uygulama kayıtları kullanabilirsiniz.

1. Yeni Uygulama kayıtları ve ardından Yeni kayıt'ı seçin.
2. Ad alanına IdentityExperienceFramework girin.
3. Desteklenen hesap türleri altında Yalnızca bu kuruluş dizininde hesaplar'ı seçin.
4. Yeniden Yönlendirme URI'si altında Web'i seçin ve ardından https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com girin, burada kiracı Azure AD B2C etki alanı your-tenant-name adıdır.
5. İzinler'in altında Yönetici onayı ver openid ve offline_access onay kutusunu seçin.
6. Kaydet’i seçin.
7. Uygulama (istemci) kimliğini daha sonraki bir adımda kullanmak üzere kaydedin.

Ardından, bir kapsam ekleyerek API'yi ortaya çıkarabilirsiniz:

1. Sol menüde, Yönet'in altında API'yi açığa çıkar'ı seçin.
2. Kapsam ekle'yi seçin, ardından Kaydet'i seçin ve varsayılan uygulama kimliği URI'lerini kabul etmeye devam eder.
3. Kiracınız içinde özel ilke yürütmeye izin veren bir kapsam oluşturmak için Azure AD B2C girin:
   • Kapsam adı:user_impersonation
   • Yönetici onayı görünen adı:Access IdentityExperienceFramework
   • Yönetici onayı açıklaması:Allow the application to access IdentityExperienceFramework on behalf of the signed-in user.
4. Kapsam ekle'yi seçin

---

ProxyIdentityExperienceFramework uygulamasını kaydetme

1. Yeni Uygulama kayıtları ve ardından Yeni kayıt'ı seçin.
2. Ad alanına ProxyIdentityExperienceFramework girin.
3. Desteklenen hesap türleri altında Yalnızca bu kuruluş dizininde hesaplar'ı seçin.
4. Yeniden Yönlendirme URI'si altında, genel istemci/yerel (mobil uygulama masaüstü) öğesini seçmek & kullanın.
5. Yeniden Yönlendirme URI'si için myapp://auth girin.
6. İzinler'in altında Yönetici onayı ver openid ve offline_access onay kutusunu seçin.
7. Kaydet’i seçin.
8. Uygulama (istemci) kimliğini daha sonraki bir adımda kullanmak üzere kaydedin.

Ardından, uygulamanın genel istemci olarak kabul edilmelidir:

1. Sol menüde, Yönet'in altında Kimlik Doğrulaması'ı seçin.
2. Gelişmiş ayarlar altında, Genel istemci akışlarına izin ver bölümünde Aşağıdaki mobil ve masaüstü akışlarını etkinleştir'i Evet olarak ayarlayın.
3. Kaydet’i seçin.
4. Uygulama bildiriminde "allowPublicClient": true'nin ayarlanmış olduğundan emin olur:
   1. Sol menüde, Yönet'in altında Bildirim'i seçerek uygulama bildirimini açın.
   2. allowPublicClient anahtarını bulun ve değerinin true olarak ayarlanmış olduğundan emin olur.

Şimdi, IdentityExperienceFramework kaydında daha önce ortaya çıkarmış olduğunuz API kapsamına izin verin:

1. Sol menüde, Yönet'in altında API izinleri'i seçin.
2. Yapılandırılmış izinler'in altında İzin ekle'yi seçin.
3. API'lerim sekmesini ve ardından IdentityExperienceFramework uygulamasını seçin.
4. İzin'in altında, user_impersonation tanımlandığı uygulama kapsamını seçin.
5. İzin ekle'yi seçin. Yönlendirilen şekilde, sonraki adıma devam etmeden önce birkaç dakika bekleyin.
6. ***Kiracı adınız için yönetici <onayını ver)> seçin.
7. Evet’i seçin.
8. Yenile'yi seçin ve ardından "Için verildi..." ifadesini doğrulayın kapsam için Durum altında görünür.

---

Özel ilke başlangıç paketi

Özel ilkeler, teknik profilleri ve kullanıcı yolculuklarını tanımlamak Azure AD B2C kiracınıza yüklediğiniz XML dosyaları kümesidir. Hızlı bir şekilde devam etmek için önceden yerleşik çeşitli ilkelere sahip başlangıç paketleri sağlaruz. Bu başlangıç paketlerinin her biri, açıklanan senaryolara ulaşmak için gereken en küçük teknik profil sayısını ve kullanıcı yolculuklarını içerir:

• LocalAccounts - Yalnızca yerel hesapların kullanımını sağlar.
• SocialAccounts - Yalnızca sosyal (veya federasyon) hesapların kullanımını sağlar.
• SocialAndLocalAccounts - Yerel ve sosyal hesapların kullanımını sağlar.
• SocialAndLocalAccountsWithMFA - Sosyal, yerel ve çok faktörlü kimlik doğrulama seçeneklerini sağlar.

Her başlangıç paketi şunları içerir:

• Temel dosya - Temel dosyada birkaç değişiklik yapılması gerekir. Örnek: TrustFrameworkBase.xml
• Yerelleştirme dosyası - Bu dosyada yerelleştirme değişiklikleri yapılır. Örnek: TrustFrameworkLocalization.xml
• Uzantı dosyası - Bu dosya, çoğu yapılandırma değişikliğinin olduğu dosyadır. Örnek: TrustFrameworkExtensions.xml
• Bağlı olan taraf dosyaları - Uygulama tarafından çağrılan göreve özgü dosyalar. Örnekler: SignUpOrSignin.xml, ProfileEdit.xml, PasswordReset.xml

Bu makalede, SocialAndLocalAccounts başlangıç paketinde XML özel ilke dosyalarını düzenlersiniz. Bir XML düzenleyicisine ihtiyacınız varsa, basit bir Visual Studio Codeplatformlar arası düzenleyici olan ' i deneyin.

Başlangıç paketini al

GitHub'den özel ilke başlangıç paketlerini alın, ardından SocialAndLocalAccounts başlangıç paketinde XML dosyalarını kiracı Azure AD B2C güncelleştirin.

1. .zip dosyasını indirin veya depoyu klonlama:

   git clone https://github.com/Azure-Samples/active-directory-b2c-custom-policy-starterpack
   

2. SocialAndLocalAccounts dizininde yer alan tüm dosyalarda dizesini kiracınız yourtenant için Azure AD B2C değiştirin.

   Örneğin, B2C kiracınız contosotenant ise tüm örnekleri yourtenant.onmicrosoft.com contosotenant.onmicrosoft.com olur.

Özel ilkeye uygulama kimlikleri ekleme

Uygulama kimliklerini dosyanın uzantı dosyasına TrustFrameworkExtensions.xml.

1. Açın SocialAndLocalAccounts/ TrustFrameworkExtensions.xml ve öğesini bulun <TechnicalProfile Id="login-NonInteractive"> .
2. Her iki örneğini, IdentityExperienceFrameworkAppId daha önce oluşturduğunuz IdentityExperienceFramework uygulamasının uygulama kimliğiyle değiştirin.
3. Her iki örneğini, ProxyIdentityExperienceFrameworkAppId daha önce oluşturduğunuz ProxyIdentityExperienceFramework uygulamasının uygulama kimliğiyle değiştirin.
4. Dosyayı kaydedin.

Bir kimlik sağlayıcısı olarak Facebook ekleme

SocialAndLocalAccounts Starter Pack, Facebook sosyal oturum açma bilgilerini içerir. Özel ilkeleri kullanmak için Facebook gerekli değildir , ancak burada, Federasyon sosyal oturum açmayı özel bir ilkede nasıl etkinleştirebileceğinizi göstermek için kullanırız.

Facebook uygulaması oluşturma

Facebook uygulama kimliği ve uygulama gizli anahtarı almak için Facebook uygulaması oluşturma bölümünde özetlenen adımları kullanın. Kayıt ayarlama ve Facebook hesabı ile oturum açma konusunda önkoşulları ve diğer adımları atlayın.

Facebook anahtarını oluşturma

Facebook uygulamanızın uygulama gizli anahtarını ilke anahtarı olarak ekleyin. Oluşturduğunuz uygulamanın uygulama gizli anahtarını, bu makalenin önkoşullarının bir parçası olarak kullanabilirsiniz.

1. Azure Portal oturum açın.
2. Azure AD B2C kiracınızı içeren dizini kullandığınızdan emin olun. Portal araç çubuğunda dizinler + abonelikler simgesini seçin.
3. Portal Ayarları | Dizinler + abonelikler sayfasında, Dizin adı listesinde Azure AD B2C dizininizi bulun ve ardından Değiştir' i seçin.
4. Azure portal, araması yapın ve Azure AD B2C seçin.
5. Genel Bakış sayfasında, ilkeler altında kimlik deneyimi çerçevesi' ni seçin.
6. Ilke anahtarlarını seçin ve ardından Ekle' yi seçin.
7. Seçenekler için öğesini seçin Manual .
8. Ad için girin FacebookSecret . Ön ek B2C_1A_ otomatik olarak eklenebilir.
9. Gizli dizi bölümünde Facebook uygulamanızın uygulama gizli anahtarını Developers.facebook.com adresinden girin. Bu değer, uygulama KIMLIĞI değil gizli dizi.
10. Anahtar kullanımı için imza' yı seçin.
11. Oluştur’u seçin.

Özel ilke başlangıç paketindeki TrustFrameworkExtensions.xml güncelleştirme

SocialAndLocalAccounts/ TrustFrameworkExtensions.xml Dosyasında, değerini client_id Facebook uygulama kimliğiyle değiştirin ve değişiklikleri kaydedin.

<TechnicalProfile Id="Facebook-OAUTH">
  <Metadata>
  <!--Replace the value of client_id in this technical profile with the Facebook app ID"-->
    <Item Key="client_id">00000000000000</Item>

ilkeleri Upload

1. Azure portal B2C kiracınızda kimlik deneyimi çerçevesi menü öğesini seçin.
2. Upload özel ilke' yi seçin.
3. Bu sırada, ilke dosyalarını karşıya yükleyin:
   1. TrustFrameworkBase.xml
   2. TrustFrameworkLocalization.xml
   3. TrustFrameworkExtensions.xml
   4. SignUpOrSignin.xml
   5. ProfileEdit.xml
   6. PasswordReset.xml

Dosyaları karşıya yüklerken, Azure her birine ön ek ekler B2C_1A_ .

Özel ilkeyi test etme

1. Özel ilkeler altında B2C_1A_signup_signin' yi seçin.
2. Özel ilkenin genel bakış sayfasında Uygulama Seç için, daha önce kaydettiğiniz WebApp1 adlı Web uygulamasını seçin.
3. Yanıt URL 'sinin olduğundan emin olun https://jwt.ms .
4. Şimdi Çalıştır' ı seçin.
5. Bir e-posta adresi kullanarak kaydolun.
6. Şimdi Çalıştır ' ı seçin.
7. Doğru yapılandırmaya sahip olmadığınızı onaylamak için aynı hesapla oturum açın.
8. Şimdi Çalıştır ' ı seçin ve Facebook ile oturum açmak ve özel ilkeyi test etmek için Facebook ' u seçin.