Azure Active Directory B2C カスタムポリシーで SAML ID プロバイダー技術プロファイルを定義する

[アーティクル]
01/11/2024

注意

Azure Active Directory B2C で、カスタムポリシーは、主に、複雑なシナリオに取り組む用途向けに設計されています。ほとんどのシナリオで、組み込みユーザーフローを使用することをお勧めします。まだ行っていない場合は、Active Directory B2C でのカスタムポリシーの概要に関する記事で、カスタムポリシースターターパックの詳細を確認してください。

Azure Active Directory B2C (Azure AD B2C) では、SAML 2.0 ID プロバイダーのサポートを提供しています。この記事では、この標準化されたプロトコルをサポートするクレームプロバイダーとやりとりするための、技術プロファイルの詳細について説明します。 SAML 技術プロファイルを使用すると、ADFS や Salesforce などの SAML ベースの ID プロバイダーとフェデレーションできます。このフェデレーションにより、ユーザーは、既存のソーシャル ID またはエンタープライズ ID でサインインできます。

メタデータ交換

メタデータとは、サービスプロバイダーや ID プロバイダーなど、SAML パーティーの構成を公開するために SAML プロトコルで使用される情報です。メタデータは、サインインとサインアウト、証明書、サインイン方法など、サービスの場所を定義します。 ID プロバイダーは、メタデータを使用して Azure AD B2C と通信する方法を知ります。メタデータは XML 形式で構成され、他方の当事者がメタデータの整合性を検証できるように、デジタル署名で署名されることもあります。 Azure AD B2C が SAML ID プロバイダーとフェデレーションを行う場合、SAML 要求を開始して、SAML 応答を待機するサービスプロバイダーとして機能します。また、場合によっては、ID プロバイダーが開始した未承諾の SAML 認証を受け入れます。

メタデータは、両当事者で「静的なメタデータ」または「動的メタデータ」として構成できます。静的なモードでは、1 つの当事者からメタデータ全体をコピーし、他方の当事者に設定します。動的モードでは、他方の当事者が動的に構成を読み取る間にメタデータに URL を設定します。原則は同じであり、Azure AD B2C 技術プロファイルのメタデータを ID プロバイダーに設定し、ID プロバイダーのメタデータを Azure AD B2C に設定します。

各 SAML ID プロバイダーにはサービスプロバイダーを公開し、設定する様々な手順がありますが、この Azure AD B2C の場合は、ID プロバイダーに Azure AD B2C メタデータを設定します。この詳しい手順については、ID プロバイダーのドキュメントを参照してください。

次の例は、Azure AD B2C テクニカルプロファイルの SAML メタデータへの URL アドレスを示しています。

https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/your-policy/samlp/metadata?idptp=your-technical-profile

次の値を置き換えます。

your-tenant-name は、fabrikam.b2clogin.com などのテナント名に置き換えます。
your-policy は、実際のポリシー名に置き換えます。 SAML プロバイダーのテクノロジプロファイルを構成するポリシー、またはそのポリシーから継承されるポリシーを使用します。
your-technical-profile は、実際の SAML ID プロバイダー技術プロファイルの名前に置き換えます。

デジタル署名証明書の交換

Azure AD B2C と SAML ID プロバイダー間の信頼関係をビルドするには、秘密キーで有効な X509 証明書を提供する必要があります。秘密キー付きの証明書 (.pfx ファイル) を Azure AD B2C ポリシー鍵ストアにアップロードします。 Azure AD B2C は、提供された証明書を使用して SAML サインイン要求にデジタル署名します。

証明書は、次の方法で使用されます。

Azure AD B2C は証明書の Azure AD B2C 秘密キーを使用して SAML 要求を生成し、署名します。 SAML 要求が ID プロバイダーに送信され、ID プロバイダーが証明書の Azure AD B2C 秘密キーを使用して要求を検証します。 Azure AD B2C の公開証明書には、技術プロファイルメタデータを介してアクセスできます。代わりに、.cer ファイルを SAML ID プロバイダーに手動でアップロードすることもできます。
ID プロバイダーは Azure AD B2C に送信されたデータに、証明書の ID プロバイダーの秘密キーを使用して署名します。 Azure AD B2C では、ID プロバイダーの公開証明書を使用してデータを検証します。 ID プロバイダーはそれぞれ様々なセットアップ手順を持ちますが、詳しい手順については、ID プロバイダーのドキュメントを参照してください。 Azure AD B2C では、ポリシーで ID プロバイダーのメタデータを使用して証明書の公開キーにアクセスする必要があります。

自己署名証明書は、ほとんどのシナリオで受け入れ可能です。運用環境では、証明機関が発行した X509 証明書を使用することをお勧めします。また、このドキュメントの後半で説明する、非運用環境に無効では、両側で SAML の署名を無効にできます。

次の図は、メタデータと証明書の交換を示しています。

デジタル暗号化

SAML 応答のアサーションを暗号化するには、ID プロバイダーは常に Azure AD B2C の技術プロファイルの暗号化証明書の公開キーを使用します。 Azure AD B2C はデータの暗号化を解除する必要がある場合には、暗号化証明書の秘密部分を使用します。

SAML 応答のアサーションを暗号化する場合:

有効な秘密キー付きの X509 証明書 (.pfx ファイル) を Azure AD B2C ポリシー鍵ストアにアップロードします。
識別子 SamlAssertionDecryption の CryptographicKey 要素を技術プロファイル CryptographicKeys コレクションに追加します。 StorageReferenceId を、ステップ 1 で作成したポリシーキーの名前に設定します。
技術プロファイルメタデータ WantsEncryptedAssertions を true に設定します。
ID プロバイダーを新しい Azure AD B2C の技術プロファイルメタデータで更新します。 use プロパティ付きの KeyDescriptor が証明書の公開キーを含む encryption に設定されます。

次の例は、暗号化に使用される SAML メタデータのキー記述子セクションを示しています。

<KeyDescriptor use="encryption">
  <KeyInfo xmlns="https://www.w3.org/2000/09/xmldsig#">
    <X509Data>
      <X509Certificate>valid certificate</X509Certificate>
    </X509Data>
  </KeyInfo>
</KeyDescriptor>

Protocol

Protocol 要素の Name 属性は SAML2 に設定する必要があります。

入力クレーム

InputClaims 要素は、SAML AuthN 要求のサブジェクト内で NameId を送信するために使用されます。これを実行するには、次に示すように subject に設定された PartnerClaimType が含まれる入力要求を追加します。

<InputClaims>
	<InputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="subject" />
</InputClaims>

出力クレーム

OutputClaims 要素には、AttributeStatement セクション下に SAML ID プロバイダーにより返される要求の一覧が存在します。お使いのポリシーに定義されている要求の名前を、ID プロバイダーで定義されている名前にマップする必要があるかもしれません。 DefaultValue 属性を設定している限り、ID プロバイダーにより返されない要求を追加することもできます。

サブジェクト名の出力要求

[件名] の SAML アサーション NameId を正規化された要求として読み取るには、要求 PartnerClaimType を SPNameQualifier 属性の値に設定します。 SPNameQualifier 属性が表示されない場合は、PartnerClaimType 要求を NameQualifier 属性の値に設定します。

SAML アサーション:

<saml:Subject>
  <saml:NameID SPNameQualifier="http://your-idp.com/unique-identifier" Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">david@contoso.com</saml:NameID>
  <SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
    <SubjectConfirmationData InResponseTo="_cd37c3f2-6875-4308-a9db-ce2cf187f4d1" NotOnOrAfter="2020-02-15T16:23:23.137Z" Recipient="https://your-tenant.b2clogin.com/your-tenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase/samlp/sso/assertionconsumer" />
    </SubjectConfirmation>
  </saml:SubjectConfirmation>
</saml:Subject>

出力要求：

<OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="http://your-idp.com/unique-identifier" />

SAML アサーションに SPNameQualifier または NameQualifier の両方の属性が表示されない場合は、PartnerClaimType 要求を assertionSubjectName に設定します。 NameId がアサーション XML 内の最初の値であることを確認します。複数のアサーションを定義した場合、Azure AD B2C は、最後のアサーションからサブジェクト値を取得します。

次の例は、SAML ID プロバイダーにより返される要求を示しています。

issuerUserId 要求は、assertionSubjectName 要求にマップされます。
givenName 要求にマップされている first_name 要求。
surname 要求にマップされている last_name 要求。
displayName 要求は、name 要求にマップされます。
どの名前にもマップされていない email 要求。

また、技術プロファイルは、ID プロバイダーにより返されない要求も返します。

ID プロバイダーの名前を保持する identityProvider 要求。
既定値の socialIdpAuthentication である authenticationSource 要求。

<OutputClaims>
  <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="assertionSubjectName" />
  <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="first_name" />
  <OutputClaim ClaimTypeReferenceId="surname" PartnerClaimType="last_name" />
  <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="name" />
  <OutputClaim ClaimTypeReferenceId="email"  />
  <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="contoso.com" />
  <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
</OutputClaims>

OutputClaimsTransformations 要素には、出力要求を修正したり新しい要求を生成するために使用される、OutputClaimsTransformation 要素のコレクションが含まれている場合があります。

Metadata

属性	必須	説明
PartnerEntity	はい	SAML ID プロバイダーのメタデータの URL です。または、ID プロバイダーのメタデータをコピーし、CDATA の要素 `<![CDATA[Your IDP metadata]]>` の内部にそれを埋め込みます。 ID プロバイダーのメタデータを埋め込むことは推奨されません。 ID プロバイダーによって設定が変更されたり、証明書が更新されたりする可能性があります。 ID プロバイダーのメタデータが変更されている場合は、新しいメタデータを取得し、新しいものでポリシーを更新します。
WantsSignedRequests	いいえ	技術プロファイルでは、送信認証要求すべてを署名する必要があるかどうかを示します。指定できる値: `true` または `false`。既定値は `true` です。値を `true` に設定すると、 SamlMessageSigning 暗号化キーを指定する必要があり、送信認証要求すべてが署名されます。値が `false` に設定されている場合、SigAlg と Signature パラメーター (クエリ文字列または post パラメーター) は要求から省略されます。このメタデータは、メタデータ AuthnRequestsSigned 属性も制御し、これは ID プロバイダーと供給される Azure AD B2C の技術プロファイルのメタデータに出力されます。技術プロファイルメタデータ内の WantsSignedRequests 値が `false` に設定され、ID プロバイダーメタデータ WantAuthnRequestsSigned 値が `false` に設定されている、または指定がない場合、Azure AD B2C では要求の署名は行われません。
XmlSignatureAlgorithm	いいえ	SAML 要求に署名するために Azure AD B2C が使用するメソッド。このメタデータでは、SAML 要求の SigAlg パラメーター (クエリ文字列または post パラメーター) の値を制御します。指定できる値: `Sha256`、`Sha384`、`Sha512`、または `Sha1` (既定値)。両方の側で同じ値の署名アルゴリズムを構成するようにします。証明書でサポートされているアルゴリズムのみを使用してください。
WantsSignedAssertions	いいえ	技術プロファイルで、着信アサーションすべてに署名が必要かどうかを示します。指定できる値: `true` または `false`。既定値は `true` です。値が `true` に設定されている場合、ID プロバイダーによって Azure AD B2C に送信されるすべてのアサーションセクション `saml:Assertion` に署名する必要があります。値が `false` に設定されているとき、ID プロバイダーではアサーションに署名しませんが、その場合でも Azure AD B2C によって署名は検証されません。このメタデータは、メタデータフラグ WantsAssertionsSigned も制御し、これは ID プロバイダーと供給される Azure AD B2C の技術プロファイルのメタデータに出力されます。アサーションの検証を無効にした場合、応答の署名の検証も無効にできます (詳細については、ResponsesSigned を参照)。
ResponsesSigned	いいえ	指定できる値: `true` または `false`。既定値は `true` です。値が `false` に設定されている場合、ID プロバイダーは、SAML 応答を署名しませんが、その場合でも Azure AD B2C は署名を検証しません。値が `true` に設定されている場合、ID プロバイダーによって Azure AD B2C に送信される SAML 応答が署名され、必ず検証されます。 SAML 応答の検証を無効にした場合、アサーション署名の検証も無効にできます (詳細については、WantsSignedAssertions を参照)。
WantsEncryptedAssertions	いいえ	技術プロファイルで、着信アサーションすべてに暗号化が必要かどうかを示します。指定できる値: `true` または `false`。既定値は `false` です。値が `true` に設定されている場合、ID プロバイダーによって Azure AD B2C に送信されるアサーションが必ず署名され、SamlAssertionDecryption 暗号化キーを指定する必要があります。値が `true` に設定されている場合、Azure AD B2C 技術プロファイルのメタデータには encryption セクションが含まれます。 ID プロバイダーはメタデータを読み取り、Azure AD B2C 技術プロファイルのメタデータに提供されている公開キーを使用して SAML 応答アサーションを暗号化します。アサーションの暗号化を有効にした場合、応答の署名の検証を無効にする必要があります (詳細については、ResponsesSigned を参照)。
NameIdPolicyFormat	いいえ	要求されたサブジェクトを表すために使用する名前識別子に対する制約を指定します。省略した場合、要求されたサブジェクトに対して ID プロバイダーがサポートするあらゆる種類の識別子を使用できます。たとえば、「 `urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified` 」のように入力します。 NameIdPolicyFormat は NameIdPolicyAllowCreate とともに使用できます。サポートされている名前 ID ポリシーに関するガイダンスについては、ID プロバイダーのドキュメントを参照してください。
NameIdPolicyAllowCreate	いいえ	NameIdPolicyFormat を使用するときに、NameIDPolicy の `AllowCreate` プロパティも指定できます。このメタデータの値は `true` または `false` で、ID プロバイダーがサインインフロー中に新しいアカウントを作成できるかどうかを示します。この詳しい手順については、ID プロバイダーのドキュメントを参照してください。
AuthenticationRequestExtensions	いいえ	Azure AD B2C と ID プロバイダー間で同意される省略可能なプロトコルメッセージ拡張機能要素。拡張機能は、XML 形式で表示されます。 CDATA 要素 `<![CDATA[Your IDP metadata]]>` 内部に XML データを追加します。拡張機能要素がサポートされているかどうかは、ID プロバイダーのドキュメントを確認してください。
IncludeAuthnContextClassReferences	いいえ	認証コンテキストクラスを識別する URI 参照を 1 つ以上指定します。たとえば、ユーザーがユーザー名とパスワードのみでサインインできるようにするには、値を `urn:oasis:names:tc:SAML:2.0:ac:classes:Password` に設定します。保護されたセッション (SSL/TLS) でユーザー名とパスワードを使用してサインインできるようにするには、`PasswordProtectedTransport` を指定します。サポートされている AuthnContextClassRef URI に関するガイダンスについては、ID プロバイダーのドキュメントを参照してください。複数の URI をコンマ区切りのリストで指定します。
IncludeKeyInfo	いいえ	バインディングが `HTTP-POST` に設定されているときに、証明書の公開キーが SAML 認証要求に含まれるかどうかを示します。指定できる値: `true` または `false`。
IncludeClaimResolvingInClaimsHandling	いいえ	入力と出力の要求について、要求の解決を技術プロファイルに含めるかどうかを指定します。指定できる値: `true` または `false` (既定値)。技術プロファイルで要求リゾルバーを使用する場合は、これを `true` に設定します。
SingleLogoutEnabled	いいえ	サインイン中に技術プロファイルがフェデレーション ID プロバイダーからサインアウトを試行しているかどうかを示します。詳しくは、Azure AD B2C のセッションサインアウトに関する記事をご覧ください。指定できる値は `true`(既定値) または`false`です。
ForceAuthN	いいえ	SAML 認証要求に ForceAuthN 値を渡し、ユーザーに認証を求めることが外部 SAML IDP に強制されるか判断します。既定では、初回ログインで Azure AD B2C によって ForceAuthN が false に設定されます。セッションがリセットされた場合 (OIDC で `prompt=login` を使用するなど)、ForceAuthN 値が `true` に設定されます。下の画像のようにメタデータ項目を設定すると、外部 IDP へのすべての要求の値が適用されます。指定できる値: `true` または `false`。
ProviderName	いいえ	SAML 認証要求で ProviderName の値を渡します。

暗号化キー

CryptographicKeys 要素には次の属性が存在します。

属性	必須	説明
SamlMessageSigning	はい	SAML メッセージを署名するために使用する X509 証明書 (RSA キーセット)。 Azure AD B2C では、このキーを使用して、要求に署名し、ID プロバイダーに送信します。
SamlAssertionDecryption	いいえ*	X509 証明書 (RSA キーセット)。 SAML ID プロバイダーは、証明書の公開部分を使用して、SAML 応答のアサーションを暗号化します。 Azure AD B2C は、証明書の非公開部分を使用してアサーションの暗号化を解除します。 * 外部 IDP で SAML アサーションを暗号化する場合は必須。
MetadataSigning	いいえ	SAML データを署名するために使用する X509 証明書 (RSA キーセット)。 Azure AD B2C では、このキーを使用して、メタデータに署名します。

次のステップ

Azure AD B2C での SAML ID プロバイダーの使用例については、次の記事を参照してください。

Azure Active Directory B2C カスタム ポリシーで SAML ID プロバイダー技術プロファイルを定義する