Azure Active Directory B2C を使用して QQ アカウントでサインアップとサインインを設定する

2025-05-02

重要

2025 年 5 月 1 日より、Azure AD B2C は新規のお客様向けに購入できなくなります。詳細については、FAQ を参照してください。

開始する前にこのページの上部にある ポリシーの種類 セレクターを使用して、設定するポリシーの種類を選択します。 Azure Active Directory B2C には、ユーザーがアプリケーションを操作する方法を定義する 2 つの方法 (定義済みのユーザーフローを使用する、または完全に構成可能なカスタムポリシーを使用する) があります。この記事で必要な手順は、方法ごとに異なります。

注

この機能はパブリックプレビュー段階にあります。

[前提条件]

ユーザーがサインアップしてアプリケーションにサインインできるように、ユーザーフローを作成します。
Web アプリケーションを登録します。

「Active Directory B2C でのカスタムポリシーの概要」の手順を完了してください。このチュートリアルでは、Azure AD B2C テナント構成を使用するようにカスタムポリシーファイルを更新する方法について説明します。
Web アプリケーションを登録します。

QQ アプリケーションを作成する

Azure Active Directory B2C (Azure AD B2C) で QQ アカウントを持つユーザーのサインインを有効にするには、 QQ 開発者ポータルでアプリケーションを作成する必要があります。まだ QQ アカウントをお持ちでない場合は、 https://ssl.zc.qq.comでサインアップできます。

QQ 開発者プログラムに登録する

QQ アカウントの資格情報を使用して QQ 開発者ポータルにサインインします。
サインインした後、 https://open.qq.com/reg に移動して開発者として自分自身を登録します。
个人 (個々の開発者) を選択します。
必要な情報を入力し、 下一步 (次の手順) を選択します。
電子メールの確認プロセスを完了します。開発者として登録した後、承認されるまで数日待つ必要があります。

QQ アプリケーションを登録する

https://connect.qq.com/index.html にアクセスします。
应用管理 (アプリ管理) を選択します。
创建应用 (アプリの作成) を選択し、必要な情報を入力します。
授权回调域 (コールバック URL) には、「https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp」と入力します。カスタムドメインを使用する場合は、「https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp」と入力します。 your-tenant-nameをテナントの名前に置き換え、your-domain-nameをカスタムドメインに置き換えます。
创建应用 (アプリの作成) を選択します。
確認ページで 、应用管理 (アプリ管理) を選択してアプリ管理ページに戻ります。
作成したアプリの横にある表示を選択します。
修改 (編集) を選択します。
アプリ ID とアプリキーをコピーします。 ID プロバイダーをテナントに追加するには、これらの値の両方が必要です。

ID プロバイダーとして QQ を構成する

Azure portal にサインインします。
複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
Azure portal で、 [Azure AD B2C] を検索して選択します。
ID プロバイダーを選択し、QQ (プレビュー) を選択します。
名前を入力します。たとえば、 QQ です。
クライアント ID には、先ほど作成した QQ アプリケーションのアプリ ID を入力します。
クライアントシークレットの場合は、記録した APP KEY を入力します。
保存を選択します。

ユーザーフローに QQ ID プロバイダーを追加する

Azure AD B2C テナントで、[ ユーザーフロー] を選択します。
QQ ID プロバイダーを追加するユーザーフローをクリックします。
[ソーシャル ID プロバイダー] で、[QQ] を選択します。
保存を選択します。
ポリシーをテストするには、[ ユーザーフローの実行] を選択します。
[アプリケーション] で、以前に登録した testapp1 という名前の Web アプリケーションを選択します。 応答 URL にhttps://jwt.msが表示されます。
[ ユーザーフローの実行 ] ボタンを選択します。
サインアップまたはサインインページで 、QQ を選択して QQ アカウントでサインインします。

サインインプロセスが成功すると、ブラウザーは https://jwt.ms にリダイレクトされ、Azure AD B2C によって返されるトークンの内容が表示されます。

ポリシーキーを作成する

以前に Azure AD B2C テナントに記録したクライアントシークレットを格納する必要があります。

Azure portal にサインインします。
複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
Azure portal の左上隅にある [すべてのサービス] を選択してから、[Azure AD B2C] を検索して選択します。
[概要] ページで、[Identity Experience Framework] を選びます。
[ポリシーキー] を選択して、[追加] を選択します。
[オプション] で、[Manual] を選択します。
ポリシーキーの名前を入力します。たとえば、QQSecret のようにします。プレフィックス B2C_1A_ がキーの名前に自動的に追加されます。
[ シークレット] に、前に記録したクライアントシークレットを入力します。
[ キーの使用法] で、[ Signature] を選択します。
Create をクリックしてください。

ID プロバイダーとして QQ を構成する

ユーザーが QQ アカウントを使用してサインインできるようにするには、Azure AD B2C がエンドポイントを介して通信できるクレームプロバイダーとしてアカウントを定義する必要があります。エンドポイントは、特定のユーザーが認証されたことを確認するために Azure AD B2C によって使用されるクレームのセットを提供します。

QQ アカウントをクレームプロバイダーとして定義するには、ポリシーの拡張ファイルの ClaimsProviders 要素に追加します。

TrustFrameworkExtensions.xmlを開きます。
ClaimsProviders 要素を検索します。存在しない場合は、ルート要素の下に追加します。

次のように新しい ClaimsProvider を追加します。

<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アプリケーション登録のアプリケーション ID に設定します。
ファイルを保存します。

ユーザー体験を追加する

この時点で、ID プロバイダーは設定されていますが、どのサインインページでもまだ使用できません。独自のカスタムユーザー体験がない場合は、既存のテンプレートユーザー体験の複製を作成します。それ以外の場合は、次の手順に進みます。

スターターパックから TrustFrameworkBase.xml ファイルを開きます。
を含む Id="SignUpOrSignIn" 要素の内容全体を検索してコピーします。
TrustFrameworkExtensions.xml を開き、UserJourneys 要素を見つけます。要素が存在しない場合は、要素を追加します。
UserJourneys 要素の子としてコピーした UserJourney 要素の内容全体を貼り付けます。
ユーザージャーニーの ID を変更します。たとえば、Id="CustomSignUpSignIn" のようにします。

ID プロバイダーをユーザー体験に追加する

これでユーザー体験が作成されたので、新しい ID プロバイダーをユーザー体験に追加します。最初にサインインボタンを追加し、そのボタンをアクションにリンクします。あなたが以前に作成した技術プロファイルがこのアクションです。

ユーザー体験に Type="CombinedSignInAndSignUp"または Type="ClaimsProviderSelection" を含むオーケストレーションステップ要素を見つけます。通常は、オーケストレーションの最初の手順です。 ClaimsProviderSelections 要素には、ユーザーがサインインできる ID プロバイダーの一覧が含まれています。要素の順序は、ユーザーに表示されるサインインボタンの順序を制御します。 ClaimsProviderSelection XML 要素を追加します。 TargetClaimsExchangeId の値をフレンドリ名に設定します。
次のオーケストレーション手順で、 ClaimsExchange 要素を追加します。 Id をターゲット要求交換 ID の値に設定します。TechnicalProfileReferenceId の値を、先ほど作成した技術プロファイルの ID に更新します。

次の XML は、ID プロバイダーを使用したユーザー体験の最初の 2 つのオーケストレーション手順を示しています。

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

依存先パーティーポリシーを構成する

証明書利用者ポリシー ( SignUpSignIn.xmlなど) は、Azure AD B2C が実行するユーザー体験を指定します。 依存するパーティー内で DefaultUserJourney 要素を検索します。追加した ID プロバイダーのユーザージャーニー ID と一致するように ReferenceId を更新します。

次の例では、 CustomSignUpSignIn ユーザー体験の ReferenceId が CustomSignUpSignInに設定されています。

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

カスタムポリシーをアップロードする

Azure portal にサインインします。
ポータルのツールバーで [ディレクトリ + サブスクリプション ] アイコンを選択し、Azure AD B2C テナントが含まれているディレクトリを選択します。
Azure portal で、 [Azure AD B2C] を検索して選択します。
[ ポリシー] で、[ Identity Experience Framework] を選択します。
[ カスタムポリシーのアップロード] を選択し、変更した 2 つのポリシーファイルを次の順序でアップロードします。拡張機能ポリシー ( TrustFrameworkExtensions.xmlなど)、証明書利用者ポリシー ( SignUpSignIn.xmlなど)。

カスタムポリシーをテストする

関連パーティポリシー（例: B2C_1A_signup_signin）を選択してください。
[ アプリケーション] で、以前に登録した Web アプリケーションを選択します。 応答 URL にhttps://jwt.msが表示されます。
[ 今すぐ実行 ] ボタンを選択します。
サインアップまたはサインインページで 、QQ を選択して QQ アカウントでサインインします。

サインインプロセスが成功すると、ブラウザーは https://jwt.ms にリダイレクトされ、Azure AD B2C によって返されるトークンの内容が表示されます。

次の方法で共有

Azure Active Directory B2C を使用して QQ アカウントでサインアップとサインインを設定する

[前提条件]

QQ アプリケーションを作成する

QQ 開発者プログラムに登録する

QQ アプリケーションを登録する

ID プロバイダーとして QQ を構成する

ユーザー フローに QQ ID プロバイダーを追加する

ポリシー キーを作成する

ID プロバイダーとして QQ を構成する

ユーザー体験を追加する

ID プロバイダーをユーザー体験に追加する

依存先パーティーポリシーを構成する

カスタム ポリシーをアップロードする

カスタム ポリシーをテストする

フィードバック

その他のリソース

ユーザーフローに QQ ID プロバイダーを追加する

ポリシーキーを作成する

カスタムポリシーをアップロードする

カスタムポリシーをテストする