Aracılığıyla paylaş

Azure Active Directory B2C kullanarak bir Microsoft hesabıyla kaydolma ve oturum açma ayarlama

Önemli

1 Mayıs 2025 tarihinden itibaren Azure AD B2C artık yeni müşteriler için satın alınamayacak. SSS bölümünden daha fazla bilgi edinebilirsiniz.

Başlamadan önce, ayarlamakta olduğunuz ilke türünü seçmek için bu sayfanın üst kısmındaki İlke türü seç seçicisini kullanın. Azure Active Directory B2C, kullanıcıların uygulamalarınızla nasıl etkileşim kurduğunu tanımlamak için iki yöntem sunar: önceden tanımlanmış kullanıcı akışları veya tam olarak yapılandırılabilir özel ilkeler aracılığıyla. Bu makalede gerekli adımlar her yöntem için farklıdır.

Uyarı

Azure Active Directory B2C'de özel ilkeler öncelikli olarak karmaşık senaryoları ele almak için tasarlanmıştır. Çoğu senaryoda, yerleşik kullanıcı akışlarını kullanmanızı öneririz. Bunu yapmadıysanız, Active Directory B2C'de özel ilkeleri kullanmaya başlama bölümünde özel ilke başlangıç paketi hakkında bilgi edinin.

Önkoşullar

Microsoft hesabı uygulaması oluşturma

Azure Active Directory B2C'de (Azure AD B2C) Microsoft hesabı olan kullanıcılar için oturum açmayı etkinleştirmek için Azure portalında bir uygulama oluşturmanız gerekir. Daha fazla bilgi için Microsoft kimlik platformunda bir uygulamayı kaydetme bölümüne bakın. Henüz bir Microsoft hesabınız yoksa adresinden bir https://www.live.com/hesap alabilirsiniz.

  1. Azure portalınaoturum açın.

  2. Birden çok kiracıya erişiminiz varsa, en üstteki menüden Ayarlar simgesini seçerek Dizinler + abonelikler menüsünden Microsoft Entra ID kiracınıza geçiş yapın.

  3. Azure portalının sol üst köşesindeki Tüm hizmetler'i seçin ve ardından Uygulama kayıtları'nı arayın ve seçin.

  4. Yeni kayıtseçin.

  5. Uygulamanız için bir Ad girin. Örneğin , MSAapp1.

  6. Desteklenen hesap türleri'nin altında kişisel Microsoft hesapları (örneğin Skype, Xbox) seçeneğini belirleyin.

    Farklı hesap türü seçimleri hakkında daha fazla bilgi için bkz . Hızlı Başlangıç: Microsoft kimlik platformuna uygulama kaydetme.

  7. Yeniden Yönlendirme URI'si (isteğe bağlı) altındaWeb'i seçin ve girinhttps://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp. Özel bir etki alanı kullanıyorsanız girinhttps://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp. your-tenant-name değerini Azure AD B2C kiracınızın adıyla ve your-domain-name değerini özel etki alanınızla değiştirin.

  8. Kayıt Seç

  9. Uygulamaya Genel Bakış sayfasında gösterilen Uygulama (istemci) Kimliğini kaydedin. Sonraki bölümde kimlik sağlayıcısını yapılandırırken istemci kimliğine ihtiyacınız vardır.

  10. Sertifikalar ve gizliler seçin

  11. Yeni istemci gizli anahtarına tıklayın

  12. Gizli için bir Açıklama girin (örneğin Uygulama parolası 1) ve Ekle'ye tıklayın.

  13. Değer sütununda gösterilen uygulama parolasını kaydedin. Kimlik sağlayıcısını sonraki bölümde yapılandırırken istemci sırrına ihtiyacınız olacak.

Microsoft'u kimlik sağlayıcısı olarak yapılandırma

  1. Azure portalında en az Dış Kimlik Sağlayıcısı Yöneticisi ayrıcalıklarına sahip bir hesapla oturum açın.
  2. Birden çok kiracıya erişiminiz varsa Azure AD B2C kiracınıza geçiş yapmak için Dizinler + abonelikler menüsünde, üstteki menüden Ayarlar simgesini seçin.
  3. Azure portalının sol üst köşesindeki Tüm hizmetler'i seçin, Azure AD B2C'yi arayın ve seçin.
  4. Kimlik sağlayıcıları'yı ve ardından Microsoft Hesabı'yı seçin.
  5. Bir Ad girin. Örneğin , MSA.
  6. İstemci Kimliği için, daha önce oluşturduğunuz Microsoft Entra uygulamasının Uygulama (istemci) kimliğini girin.
  7. Kaydettiğiniz istemci gizli anahtarını istemci gizli anahtarı için girin.
  8. Kaydetseçeneğini seçin.

Kullanıcı akışına Microsoft kimlik sağlayıcısı ekleme

Bu noktada, Microsoft kimlik sağlayıcısı ayarlanmıştır, ancak henüz oturum açma sayfalarından birinde kullanılamaz. Microsoft kimlik sağlayıcısını bir kullanıcı akışına eklemek için:

  1. Azure AD B2C kiracınızda Kullanıcı akışları'yı seçin.
  2. Microsoft kimlik sağlayıcısını eklemek istediğiniz kullanıcı akışına tıklayın.
  3. Sosyal kimlik sağlayıcıları altında Microsoft Hesabı'nı seçin.
  4. Kaydetseçeneğini seçin.
  5. İlkenizi test etmek için Kullanıcı akışını çalıştır'ı seçin.
  6. Uygulama için daha önce kaydettiğiniz testapp1 adlı web uygulamasını seçin. Yanıt URL'si göstermelidirhttps://jwt.ms.
  7. Kullanıcı akışını çalıştır düğmesini seçin.
  8. Kaydolma veya oturum açma sayfasında Microsoft hesabıyla oturum açmak için Microsoft'u seçin.

Oturum açma işlemi başarılı olursa, tarayıcınız, Azure AD B2C tarafından döndürülen belirtecin içeriğini görüntüleyen https://jwt.ms adresine yönlendirilir.

İsteğe bağlı talepleri yapılandırma

family_name ve given_name taleplerini Microsoft Entra ID'den almak istiyorsanız, Azure portalı arayüzünde veya uygulama bildiriminde uygulamanız için isteğe bağlı talepler yapılandırabilirsiniz. Daha fazla bilgi için bkz. Microsoft Entra uygulamanıza isteğe bağlı talepler sağlama.

  1. Azure portalınaoturum açın. Microsoft Entra ID öğesini arayıp seçin.
  2. Yönet bölümünde Uygulama kayıtları'nı seçin.
  3. Listede isteğe bağlı talepleri yapılandırmak istediğiniz uygulamayı seçin.
  4. Yönet bölümünde Belirteç yapılandırması (önizleme) öğesini seçin.
  5. seçin İsteğe bağlı talep ekle.
  6. Yapılandırmak istediğiniz belirteç türünü seçin.
  7. Eklenecek isteğe bağlı talepleri seçin.
  8. Ekle'yi tıklatın.

İlke anahtarı oluşturma

Uygulamayı Microsoft Entra kiracınızda oluşturduğunuza göre, bu uygulamanın istemci gizli anahtarını Azure AD B2C kiracınızda depolamanız gerekir.

  1. Azure portalınaoturum açın.
  2. Birden çok kiracıya erişiminiz varsa Azure AD B2C kiracınıza geçiş yapmak için Dizinler + abonelikler menüsünde, üstteki menüden Ayarlar simgesini seçin.
  3. Azure portalının sol üst köşesindeki Tüm hizmetler'i seçin ve ardından Azure AD B2C'yi arayıp seçin.
  4. Genel Bakış sayfasında Kimlik Deneyimi Çerçevesi'ni seçin.
  5. İlke Anahtarları'nı ve ardından Ekle'yi seçin.
  6. Seçenekler için Manual öğesini seçin.
  7. İlke anahtarı için bir Ad girin. Örneğin, MSASecret. Ön ek B2C_1A_ , anahtarınızın adına otomatik olarak eklenir.
  8. Gizli Bilgi alanına, önceki bölümde kaydettiğiniz istemci gizli bilgisini girin.
  9. Anahtar kullanımı için Signature seçin.
  10. Oluştur'utıklayın.

Microsoft'u kimlik sağlayıcısı olarak yapılandırma

Kullanıcıların Microsoft hesabı kullanarak oturum açmasını sağlamak için hesabı Azure AD B2C'nin bir uç nokta üzerinden iletişim kurabileceği bir talep sağlayıcısı olarak tanımlamanız gerekir. Uç nokta, belirli bir kullanıcının kimliğini doğrulamak için Azure AD B2C tarafından kullanılan bir dizi talep sağlar.

İlkenizin uzantı dosyasına ClaimsProvider öğesini ekleyerek Microsoft Entra Id'yi talep sağlayıcısı olarak tanımlayabilirsiniz.

  1. TrustFrameworkExtensions.xml ilke dosyasını açın.

  2. ClaimsProviders öğesini bulun. Eğer yoksa, bunu kök öğesinin altına ekleyin.

  3. Aşağıdaki gibi yeni bir ClaimsProvider ekleyin:

    <ClaimsProvider>
  <Domain>live.com</Domain>
  <DisplayName>Microsoft Account</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="MSA-MicrosoftAccount-OpenIdConnect">
      <DisplayName>Microsoft Account</DisplayName>
      <Protocol Name="OpenIdConnect" />
      <Metadata>
        <Item Key="ProviderName">https://login.live.com</Item>
        <Item Key="METADATA">https://login.live.com/.well-known/openid-configuration</Item>
        <Item Key="response_types">code</Item>
        <Item Key="response_mode">form_post</Item>
        <Item Key="scope">openid profile email</Item>
        <Item Key="HttpBinding">POST</Item>
        <Item Key="UsePolicyInRedirectUri">false</Item>
        <Item Key="client_id">Your Microsoft application client ID</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_MSASecret" />
      </CryptographicKeys>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="oid" />
        <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="given_name" />
        <OutputClaim ClaimTypeReferenceId="surName" PartnerClaimType="family_name" />
        <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="name" />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" PartnerClaimType="iss" />
        <OutputClaim ClaimTypeReferenceId="email" />
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" />
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" />
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" />
        <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId" />
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

  4. client_id değerini, daha önce kaydettiğiniz Microsoft Entra uygulamasının Uygulama (istemci) kimliğiyle değiştirin.

  5. Dosyayı kaydedin.

İlkenizi, Azure AD B2C'nin Microsoft Entra Id'de Microsoft hesabı uygulamanızla nasıl iletişim kuracaklarını bilmesi için yapılandırmış oldunuz.

Bir kullanıcı yolculuğu ekleyin

Bu noktada, kimlik sağlayıcısı ayarlanmıştır, ancak henüz giriş sayfalarından herhangi birinde erişilebilir değildir. Kendi özel kullanıcı yolculuğunuz yoksa, mevcut şablon kullanıcı yolculuğunun bir kopyasını oluşturun, aksi takdirde sonraki adıma geçin.

  1. Başlangıç paketinden TrustFrameworkBase.xml dosyasını açın.
  2. içeren Id="SignUpOrSignIn" öğesinin tüm içeriğini bulun ve kopyalayın.
  3. TrustFrameworkExtensions.xml açın ve UserJourneys öğesini bulun. Öğesi yoksa bir tane ekleyin.
  4. UserJourneys öğesinin alt öğesi olarak kopyaladığınız UserJourney öğesinin tüm içeriğini yapıştırın.
  5. Kullanıcı yolculuğunun Id'sini yeniden adlandırın. Örneğin, Id="CustomSignUpSignIn".

Kimlik sağlayıcısını kullanıcı yolculuğuna ekleme

Artık bir kullanıcı yolculuğunuz olduğuna göre, yeni kimlik sağlayıcısını kullanıcı yolculuğuna ekleyin. Önce bir oturum açma düğmesi eklersiniz, ardından düğmeyi bir eyleme bağlarsınız. Eylem, daha önce oluşturduğunuz teknik profildir.

  1. Kullanıcı yolculuğunda Type="CombinedSignInAndSignUp" veya Type="ClaimsProviderSelection" içeren düzenleme adımı öğesini bulun. Genellikle ilk düzenleme adımıdır. ClaimsProviderSelections öğesi, kullanıcının oturum açabileceği kimlik sağlayıcılarının listesini içerir. Öğelerin sırası, kullanıcıya sunulan oturum açma düğmelerinin sırasını denetler. ClaimsProviderSelection XML öğesi ekleyin. TargetClaimsExchangeId değerini kolay bir ad olarak ayarlayın.

  2. Sonraki düzenleme adımında claimsexchange öğesi ekleyin. Id'yi hedef talepler değişimi kimliğinin değerine ayarlayın. TechnicalProfileReferenceId değerini daha önce oluşturduğunuz teknik profilin Id'sine güncelleyin.

Aşağıdaki XML, kimlik sağlayıcısıyla bir kullanıcı yolculuğunun ilk iki düzenleme adımını gösterir:

<OrchestrationStep Order="1" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
  <ClaimsProviderSelections>
    ...
    <ClaimsProviderSelection TargetClaimsExchangeId="MicrosoftAccountExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="MicrosoftAccountExchange" TechnicalProfileReferenceId="MSA-MicrosoftAccount-OpenIdConnect" />
  </ClaimsExchanges>
</OrchestrationStep>

Bağımlı taraf ilkesini yapılandırın

Bağlı olan taraf ilkesi, örneğin SignUpSignIn.xml, Azure AD B2C'nin yürüteceği kullanıcı yolculuğunu belirtir. Bağlı olan taraf içinde DefaultUserJourney öğesini bulun. ReferenceId değerini, kimlik sağlayıcısını eklediğiniz kullanıcı yolculuğu ID'si ile eşleşecek şekilde güncelleyin.

Aşağıdaki örnekte, kullanıcı yolculuğu için CustomSignUpSignInReferenceId değeri olarak CustomSignUpSignInayarlanmıştır:

<RelyingParty>
  <DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
  ...
</RelyingParty>

Özel ilkeyi karşıya yükle

  1. Azure portalınaoturum açın.
  2. Portal araç çubuğunda Dizin + Abonelik simgesini ve ardından Azure AD B2C kiracınızı içeren dizini seçin.
  3. Azure portalında Azure AD B2C'yi arayın ve seçin.
  4. İlkeler altında Kimlik Deneyimi Çerçevesi'ni seçin.
  5. Özel İlkeyi Karşıya Yükle'yi seçin ve değiştirdiğiniz iki ilke dosyasını şu sırayla karşıya yükleyin: uzantı ilkesi, örneğin TrustFrameworkExtensions.xml, ardından da SignUpSignIn.xml gibi bağlı olan taraf ilkesi.

Özel ilkenizi test edin

  1. Bağlı olan taraf ilkenizi seçin, örneğin B2C_1A_signup_signin.
  2. Uygulama için daha önce kaydettiğiniz bir web uygulamasını seçin. Yanıt URL'si göstermelidirhttps://jwt.ms.
  3. Şimdi çalıştır düğmesini seçin.
  4. Kaydolma veya oturum açma sayfasında Microsoft hesabıyla oturum açmak için Microsoft'u seçin.

Oturum açma işlemi başarılı olursa, tarayıcınız, Azure AD B2C tarafından döndürülen belirtecin içeriğini görüntüleyen https://jwt.ms adresine yönlendirilir.