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

Makale
11/08/2023

Başlamadan önce, ayarladığınız ilke türünü seçmek için İlke türü seçin 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.

Dekont

Bu özellik genel önizleme aşamasındadır.

Önkoşullar

Kullanıcıların uygulamanıza kaydolabilmesi ve uygulamanızda oturum açabilmesi için bir kullanıcı akışı oluşturun.
Bir web uygulaması kaydedin.

Active Directory B2C'de özel ilkeleri kullanmaya başlama bölümündeki adımları tamamlayın
Bir web uygulaması kaydedin.

QQ uygulaması oluşturma

Azure Active Directory B2C'de (Azure AD B2C) QQ hesabı olan kullanıcılar için oturum açmayı etkinleştirmek için QQ geliştirici portalında bir uygulama oluşturmanız gerekir. Henüz bir QQ hesabınız yoksa adresinden kaydolabilirsiniz https://ssl.zc.qq.com.

QQ geliştirici programına kaydolma

QQ hesabı kimlik bilgilerinizle QQ geliştirici portalında oturum açın.
Oturum açtıktan sonra geliştirici olarak kaydolmak için adresine gidin https://open.qq.com/reg .
个人 (bireysel geliştirici) öğesini seçin.
Gerekli bilgileri girin ve 下一步 (sonraki adım) öğesini seçin.
E-posta doğrulama işlemini tamamlayın. Geliştirici olarak kaydoldıktan sonra onaylanması için birkaç gün beklemeniz gerekir.

QQ uygulaması kaydetme

Şuraya git: https://connect.qq.com/index.html.
应用管理 (uygulama yönetimi) öğesini seçin.
创建应用 (uygulama oluştur) öğesini seçin ve gerekli bilgileri girin.
授权回调域 (geri arama URL'si) için girinhttps://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp. Özel bir etki alanı kullanıyorsanız girin https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp. değerini kiracınızın adıyla ve your-domain-name özel etki alanınızla değiştirinyour-tenant-name.
创建应用 (uygulama oluştur) öğesini seçin.
Uygulama yönetimi sayfasına dönmek için onay sayfasında 应用管理 (uygulama yönetimi) öğesini seçin.
Oluşturduğunuz uygulamanın yanındaki 查看 (görünüm) öğesini seçin.
修改 (düzenle) öğesini seçin.
UYGULAMA KIMLIĞI ve UYGULAMA ANAHTARı'nı kopyalayın. Kimlik sağlayıcısını kiracınıza eklemek için bu değerlerin her ikisine de ihtiyacınız vardır.

QQ'yi kimlik sağlayıcısı olarak yapılandırma

Azure Portal oturum açın.
Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden Azure AD B2C kiracınıza geçmek için üstteki menüden Ayarlar simgesini seçin.
Azure portalında Azure AD B2C'yi arayın ve seçin.
Kimlik sağlayıcıları'nın ardından QQ (Önizleme) seçeneğini belirleyin.
Bir Ad girin. Örneğin, QQ.
İstemci Kimliği için, daha önce oluşturduğunuz QQ uygulamasının UYGULAMA Kimliğini girin.
İstemci gizli dizisi için kaydettiğiniz APP KEY değerini girin.
Kaydet'i seçin.

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

Azure AD B2C kiracınızda Kullanıcı akışları'yı seçin.
QQ kimlik sağlayıcısını eklemek istediğiniz kullanıcı akışına tıklayın.
Sosyal kimlik sağlayıcıları'nın altında QQ'yi seçin.
Kaydet'i seçin.
İlkenizi test etmek için Kullanıcı akışını çalıştır'ı seçin.
Uygulama için daha önce kaydettiğiniz testapp1 adlı web uygulamasını seçin. Yanıt URL'si göstermelidirhttps://jwt.ms.
Kullanıcı akışını çalıştır düğmesini seçin.
QQ hesabıyla oturum açmak için kaydolma veya oturum açma sayfasındaN QQ'yi 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 öğesine yönlendirilir https://jwt.ms.

İlke anahtarı oluşturma

Daha önce Azure AD B2C kiracınızda kaydettiğiniz istemci gizli dizisini depolamanız gerekir.

Azure Portal oturum açın.
Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden Azure AD B2C kiracınıza geçmek için üstteki menüden Ayarlar simgesini seçin.
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.
Genel Bakış sayfasında Kimlik Deneyimi Çerçevesi'ni seçin.
İlke Anahtarları'nı ve ardından Ekle'yi seçin.
Seçenekler için öğesini seçinManual.
İlke anahtarı için bir Ad girin. Örneğin, QQSecret. Ön ek B2C_1A_ , anahtarınızın adına otomatik olarak eklenir.
Gizli Dizi alanına daha önce kaydettiğiniz gizli dizinizi girin.
Anahtar kullanımı için öğesini seçinSignature.
Oluştur’a tıklayın.

QQ'yi kimlik sağlayıcısı olarak yapılandırma

Kullanıcıların QQ 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ındaki ClaimsProviders öğesine ekleyerek bir QQ hesabını talep sağlayıcısı olarak tanımlayabilirsiniz.

TrustFrameworkExtensions.xml dosyasını açın.
ClaimsProviders öğesini bulun. Yoksa kök öğesinin altına ekleyin.

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

<ClaimsProvider>
  <Domain>qq.com</Domain>
  <DisplayName>QQ (Preview)</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="QQ-OAuth2">
      <DisplayName>QQ</DisplayName>
      <Protocol Name="OAuth2" />
      <Metadata>
        <Item Key="ProviderName">qq</Item>
        <Item Key="authorization_endpoint">https://graph.qq.com/oauth2.0/authorize</Item>
        <Item Key="AccessTokenEndpoint">https://graph.qq.com/oauth2.0/token</Item>
        <Item Key="ClaimsEndpoint">https://graph.qq.com/oauth2.0/me</Item>
        <Item Key="scope">get_user_info</Item>
        <Item Key="HttpBinding">GET</Item>
        <Item Key="ClaimsResponseFormat">JsonP</Item>
        <Item Key="ResponseErrorCodeParamName">error</Item>
        <Item Key="external_user_identity_claim_id">openid</Item>
        <Item Key="client_id">Your QQ application ID</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_QQSecret" />
      </CryptographicKeys>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="UserId" PartnerClaimType="openid" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="qq.com" AlwaysUseDefaultValue="true" />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" AlwaysUseDefaultValue="true" />
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" />
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" />
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" />
        <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId" />
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

client_id uygulama kaydından uygulama kimliğine ayarlayın.
Dosyayı kaydedin.

Kullanıcı yolculuğu ekleme

Bu noktada, kimlik sağlayıcısı ayarlanmıştır, ancak henüz oturum açma sayfalarından herhangi birinde kullanılamaz. 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.

Başlangıç paketinden TrustFrameworkBase.xml dosyasını açın.
içeren Id="SignUpOrSignIn"UserJourney öğesinin tüm içeriğini bulun ve kopyalayın.
TrustFrameworkExtensions.xml dosyasını açın ve UserJourneys öğesini bulun. Öğesi yoksa bir tane ekleyin.
UserJourneys öğesinin alt öğesi olarak kopyaladığınız UserJourney öğesinin tüm içeriğini yapıştırın.
Kullanıcı yolculuğunun kimliğini 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.

veya içeren düzenleme adımı öğesini Type="CombinedSignInAndSignUp"Type="ClaimsProviderSelection" kullanıcı yolculuğunda 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.
Sonraki düzenleme adımında claimsexchange öğesi ekleyin. Kimliği hedef talep değişim kimliğinin değerine ayarlayın. TechnicalProfileReferenceId değerini daha önce oluşturduğunuz teknik profilin kimliğine güncelleştirin.

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="QQExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="QQExchange" TechnicalProfileReferenceId="QQ-OAuth2" />
  </ClaimsExchanges>
</OrchestrationStep>

Bağlı olan taraf ilkesini yapılandırma

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 kimliğiyle eşleşecek şekilde güncelleştirin.

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

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

Özel ilkeyi karşıya yükleme

Azure Portal oturum açın.
Portal araç çubuğunda Dizin + Abonelik simgesini ve ardından Azure AD B2C kiracınızı içeren dizini seçin.
Azure portalında Azure AD B2C'yi arayın ve seçin.
İlkeler'in altında Kimlik Deneyimi Çerçevesi'ne tıklayın.
Ö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, ve gibi SignUpSignIn.xmlbağlı olan taraf ilkesi.

Özel ilkenizi test edin

Bağlı olan taraf ilkenizi seçin, örneğin B2C_1A_signup_signin.
Uygulama için daha önce kaydettiğiniz bir web uygulamasını seçin. Yanıt URL'si göstermelidirhttps://jwt.ms.
Şimdi çalıştır düğmesini seçin.
QQ hesabıyla oturum açmak için kaydolma veya oturum açma sayfasındaN QQ'yi 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 öğesine yönlendirilir https://jwt.ms.

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

Önkoşullar

QQ uygulaması oluşturma

QQ geliştirici programına kaydolma

QQ uygulaması kaydetme

QQ'yi kimlik sağlayıcısı olarak yapılandırma

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

İlke anahtarı oluşturma

QQ'yi kimlik sağlayıcısı olarak yapılandırma

Kullanıcı yolculuğu ekleme

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

Bağlı olan taraf ilkesini yapılandırma

Özel ilkeyi karşıya yükleme

Özel ilkenizi test edin

Ek kaynaklar