SwissID アカウントでサインアップとサインインを設定する - Azure AD B2C

2025-05-06

重要

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

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

この記事では、Azure Active Directory B2C (Azure AD B2C) を使用して、アプリケーションで SwissID アカウントを使用して顧客にサインアップとサインインを提供する方法について説明します。 OpenID Connect プロトコルを使用して、ユーザーフローまたはカスタムポリシーに SwissID を追加します。詳細については、「 SwissID 統合ガイドライン - OpenID Connect」を参照してください。

[前提条件]

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

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

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

Azure AD B2C で SwissID アカウントを持つユーザーのサインインを有効にするには、アプリケーションを作成する必要があります。 SwissID アプリケーションを作成するには、次の手順に従います。

SwissID Business Partner サポートにお問い合わせください。

SwissID にサインアップした後、Azure AD B2C テナントに関する情報を入力します。

鍵	注
リダイレクト URI	`https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp` URI を指定します。カスタムドメインを使用する場合は、「`https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp`」と入力します。 `your-tenant-name`をテナントの名前に置き換え、`your-domain-name`をカスタムドメインに置き換えます。
トークンエンドポイントの認証方法	`client_secret_post`

アプリが登録されると、SwissID によって次の情報が提供されます。この情報を使用して、ユーザーフローまたはカスタムポリシーを構成します。

鍵	注
環境	SwissID OpenId の既知の構成エンドポイント。たとえば、`https://login.sandbox.pre.swissid.ch/idp/oauth2/.well-known/openid-configuration` のようにします。
クライアントID	SwissID クライアント ID。たとえば、`00001111-aaaa-2222-bbbb-3333cccc4444` のようにします。
パスワード	SwissID クライアントシークレット。

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

複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
Azure portal の左上隅にある [すべてのサービス] を選択してから、[Azure AD B2C] を検索して選択します。
[ID プロバイダー] を選択し、[新しい OpenID Connect プロバイダー] を選択します。
名前を入力します。たとえば、「 SwissID」と入力します。
[メタデータ URL] に、URL SwissID OpenId の既知の構成エンドポイントを入力します。例えば次が挙げられます。
```
https://login.sandbox.pre.swissid.ch/idp/oauth2/.well-known/openid-configuration
```
[クライアント ID] に、SwissID クライアント ID を入力します。
クライアントシークレットの場合は、SwissID クライアントシークレットを入力します。
[スコープ] に、openid profile emailを入力します。
[応答の種類] と [応答モード] の既定値のままにします。
(省略可能) ドメインヒントに「 swissid.com」と入力します。詳しくは、「Azure Active Directory B2C を使用した直接サインインの設定」をご覧ください。
[ ID プロバイダー要求マッピング] で、次の要求を選択します。
- ユーザー ID: sub
- 指定された名前: given_name
- 姓: family_name
- 電子メール: 電子メール
保存を選択します。

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

この時点で、SwissID ID プロバイダーは設定されていますが、どのサインインページでもまだ使用できません。ユーザーフローに SwissID ID プロバイダーを追加するには:

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

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

ポリシーキーを作成する

SwissID から受信したクライアントシークレットを Azure AD B2C テナントに格納する必要があります。

Azure portal にサインインします。
ご自分の Azure AD B2C テナントが含まれるディレクトリを必ず使用してください。上部のメニューで [ディレクトリ + サブスクリプション ] フィルターを選択し、テナントを含むディレクトリを選択します。
Azure portal の左上隅にある [すべてのサービス] を選択してから、[Azure AD B2C] を検索して選択します。
[概要] ページで、[Identity Experience Framework] を選びます。
[ポリシーキー] を選択し、[追加] を選びます。
[オプション] で、[Manual] を選択します。
ポリシーキーの名前を入力します。たとえば、SwissIDSecret のようにします。プレフィックス B2C_1A_ がキーの名前に自動的に追加されます。
[ シークレット] に、SwissID クライアントシークレットを入力します。
[ キーの使用法] で、[ Signature] を選択します。
Create をクリックしてください。

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

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

SwissID アカウントは、ポリシーの拡張ファイルの ClaimsProviders 要素に追加することで、要求プロバイダーとして定義できます。

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

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

<ClaimsProvider>
  <Domain>SwissID.com</Domain>
  <DisplayName>SwissID</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="SwissID-OpenIdConnect">
      <DisplayName>SwissID</DisplayName>
      <Protocol Name="OpenIdConnect" />
      <Metadata>
        <Item Key="METADATA">https://login.sandbox.pre.swissid.ch/idp/oauth2/.well-known/openid-configuration</Item>
        <Item Key="client_id">Your Swiss client ID</Item>
        <Item Key="response_types">code</Item>
        <Item Key="scope">openid profile email</Item>
        <Item Key="response_mode">form_post</Item>
        <Item Key="HttpBinding">POST</Item>
        <Item Key="UsePolicyInRedirectUri">false</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_SwissIDSecret" />
      </CryptographicKeys>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="sub" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" PartnerClaimType="iss" />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" AlwaysUseDefaultValue="true" />
        <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="given_name" />
        <OutputClaim ClaimTypeReferenceId="surName" PartnerClaimType="family_name" />
        <OutputClaim ClaimTypeReferenceId="email" />
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" />
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" />
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" />
        <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId" />
        <OutputClaimsTransformation ReferenceId="CreateDisplayName" />
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

client_idを SwissID クライアント 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="SwissIDExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="SwissIDExchange" TechnicalProfileReferenceId="SwissID-OpenIdConnect" />
  </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が表示されます。
[ 今すぐ実行 ] ボタンを選択します。
サインアップまたはサインインページで、SwissID を選択して SwissID アカウントでサインインします。

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

運用環境に移行する

SwissID IdP は、実稼働前環境と運用環境を提供します。この記事で説明する構成では、実稼働前環境を使用します。運用環境を使用するには、次の手順に従います。

運用環境については、SwissId サポートにお問い合わせください。
既知の構成エンドポイントの URI を使用して、ユーザーフローまたはカスタムポリシーを更新します。

次のステップ

アプリケーションに SwissID トークンを渡す方法について説明します。

次の方法で共有

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

[前提条件]

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

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

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

ポリシー キーを作成する

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

ユーザー体験を追加する

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

依存当事者ポリシーを構成する

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

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

運用環境に移行する

次のステップ

フィードバック

その他のリソース

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

ポリシーキーを作成する

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

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