重要
2025 年 5 月 1 日より、Azure AD B2C は新規のお客様向けに購入できなくなります。 詳細については、FAQ を参照してください。
開始する前にこのページの上部にある ポリシーの種類 セレクターを使用して、設定するポリシーの種類を選択します。 Azure Active Directory B2C には、ユーザーがアプリケーションを操作する方法を定義する 2 つの方法 (定義済みのユーザー フローを使用する、または完全に構成可能なカスタム ポリシーを使用する) があります。 この記事で必要な手順は、方法ごとに異なります。
注
この機能はパブリック プレビュー段階にあります。
[前提条件]
- ユーザーが サインアップしてアプリケーションにサインインできるように、ユーザー フローを作成します。
- Web アプリケーションを登録します。
- 「Active Directory B2C でのカスタム ポリシーの概要」の手順を完了してください。 このチュートリアルでは、Azure AD B2C テナント構成を使用するようにカスタム ポリシー ファイルを更新する方法について説明します。
- Web アプリケーションを登録します。
- https://kf.qq.comで承認済みの Weixin Open Platform アカウントを取得します。
- Weixin Open Platform で承認されたアプリケーションを取得します。
WeChat アプリケーションを作成する
Azure Active Directory B2C (Azure AD B2C) で WeChat アカウントを持つユーザーのサインインを有効にするには、 WeChat 管理センターでアプリケーションを作成する必要があります。 Weixin Open Platform アカウントをまだお持ちでない場合は、 https://kf.qq.comで情報を取得できます。 Weixin Open Platform アカウントとアプリケーションは、ユーザー フローに ID プロバイダーとして WeChat をリンクするために承認されている必要があります。
WeChat アプリケーションを登録する
- WeChat 資格情報を使用して https://open.weixin.qq.com/ にサインインします。
- 管理中心 (管理センター) を選択します。
- 手順に従って新しいアプリケーションを登録します。
- [ 開発情報 ] セクションで、[Authorization callback domain]\(承認コールバック ドメイン\) を
your-tenant-name.b2clogin.comに設定します。 - アプリケーションの状態が "承認済み" であることを確認します。
- アプリケーションの詳細の上部で、アプリ ID と APP KEY をコピーします。 テナントに対して ID プロバイダーを構成するには、両方が必要です。
ID プロバイダーとして WeChat を構成する
少なくとも外部 ID プロバイダー管理者特権を持つアカウントで Azure portal にサインインします。
複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
Azure portal の左上隅にある [ すべてのサービス ] を選択し、 Azure AD B2C を検索して選択します。
[ID プロバイダー] を選択し、[WeChat (プレビュー)]を選択します。
名前を入力します。 たとえば、 WeChat です。
クライアント ID には、前に作成した WeChat アプリケーションのアプリ ID を入力します。
クライアント シークレットの場合は、記録した APP KEY を入力します。
保存 を選択します。
ユーザー フローに WeChat ID プロバイダーを追加する
Azure AD B2C テナントで、[ ユーザー フロー] を選択します。
WeChat ID プロバイダーを追加するユーザー フローをクリックします。
[ソーシャル ID プロバイダー] で、[WeChat] を選択します。
保存 を選択します。
ポリシーをテストするには、[ ユーザー フローの実行] を選択します。
[アプリケーション] で、以前に登録した testapp1 という名前の Web アプリケーションを選択します。 応答 URL に
https://jwt.msが表示されます。[ ユーザー フローの実行 ] ボタンを選択します。
サインアップまたはサインイン ページで、WeChat を選択して WeChat アカウントでサインインします。
サインイン プロセスが成功すると、ブラウザーは https://jwt.ms にリダイレクトされ、Azure AD B2C によって返されるトークンの内容が表示されます。
ポリシー キーを作成する
以前に Azure AD B2C テナントに記録したクライアント シークレットを格納する必要があります。
- Azure portal にサインインします。
- 複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
- Azure portal の左上隅にある [すべてのサービス] を選択してから、[Azure AD B2C] を検索して選択します。
- [概要] ページで、[Identity Experience Framework] を選びます。
- [ポリシー キー] を選択し、[追加] を選びます。
-
[オプション] で、[
Manual] を選択します。 - ポリシー キーの名前を入力します。 たとえば、
WeChatSecretのようにします。 プレフィックスB2C_1A_がキーの名前に自動的に追加されます。 - [ シークレット] に、前に記録したクライアント シークレットを入力します。
- [ キーの使用法] で、[
Signature] を選択します。 - Create をクリックしてください。
ID プロバイダーとして WeChat を構成する
ユーザーが WeChat アカウントを使用してサインインできるようにするには、Azure AD B2C がエンドポイント経由で通信できるクレーム プロバイダーとしてアカウントを定義する必要があります。 エンドポイントは、特定のユーザーが認証されたことを確認するために Azure AD B2C によって使用されるクレームのセットを提供します。
WeChat アカウントをクレーム プロバイダーとして定義するには、ポリシーの拡張ファイルの ClaimsProviders 要素に追加します。
TrustFrameworkExtensions.xmlを開きます。
ClaimsProviders 要素を検索します。 存在しない場合は、ルート要素の下に追加します。
次のように新しい ClaimsProvider を追加します。
<ClaimsProvider> <Domain>wechat.com</Domain> <DisplayName>WeChat (Preview)</DisplayName> <TechnicalProfiles> <TechnicalProfile Id="WeChat-OAuth2"> <DisplayName>WeChat</DisplayName> <Protocol Name="OAuth2" /> <Metadata> <Item Key="ProviderName">wechat</Item> <Item Key="authorization_endpoint">https://open.weixin.qq.com/connect/qrconnect</Item> <Item Key="AccessTokenEndpoint">https://api.weixin.qq.com/sns/oauth2/access_token</Item> <Item Key="ClaimsEndpoint">https://api.weixin.qq.com/sns/userinfo</Item> <Item Key="scope">snsapi_login</Item> <Item Key="HttpBinding">GET</Item> <Item Key="AccessTokenResponseFormat">json</Item> <Item Key="ClientIdParamName">appid</Item> <Item Key="ClientSecretParamName">secret</Item> <Item Key="ExtraParamsInAccessTokenEndpointResponse">openid</Item> <Item Key="ExtraParamsInClaimsEndpointRequest">openid</Item> <Item Key="ResponseErrorCodeParamName">errcode</Item> <Item Key="external_user_identity_claim_id">unionid</Item> <Item Key="client_id">Your WeChat application ID</Item> </Metadata> <CryptographicKeys> <Key Id="client_secret" StorageReferenceId="B2C_1A_WeChatSecret" /> </CryptographicKeys> <OutputClaims> <OutputClaim ClaimTypeReferenceId="UserId" PartnerClaimType="unionid" /> <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="wechat.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="WeChatExchange" />
</ClaimsProviderSelections>
...
</OrchestrationStep>
<OrchestrationStep Order="2" Type="ClaimsExchange">
...
<ClaimsExchanges>
<ClaimsExchange Id="WeChatExchange" TechnicalProfileReferenceId="WeChat-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が表示されます。 - [ 今すぐ実行 ] ボタンを選択します。
- サインアップまたはサインイン ページで、WeChat を選択して WeChat アカウントでサインインします。
サインイン プロセスが成功すると、ブラウザーは https://jwt.ms にリダイレクトされ、Azure AD B2C によって返されるトークンの内容が表示されます。