Azure Active Directory B2C でトークンを構成する
"開始する前に"、[ポリシーの種類の選択] セレクターを使用して、設定するポリシーの種類を選択します。 Azure Active Directory B2C には、ユーザーがアプリケーションを操作する方法を定義する 2 つの方法 (定義済みのユーザー フローを使用する、または完全に構成可能なカスタム ポリシーを使用する) があります。 この記事で必要な手順は、方法ごとに異なります。
この記事では、Azure Active Directory B2C (Azure AD B2C) でトークンの有効期間と互換性を構成する方法について説明します。
前提条件
- ユーザー フローを作成して、ユーザーがアプリケーションにサインアップおよびサインインできるようにします。
- Web アプリケーションを登録します。
- 「Active Directory B2C でのカスタム ポリシーの概要」にある手順を完了します。
- Web アプリケーションを登録します。
トークンの有効期間の動作
次のようなトークンの有効期間を構成できます。
- [アクセスと ID トークンの有効期間 (分)] - OAuth 2.0 ベアラー トークンと ID トークンの有効期間。 既定値は 60 分 (1 時間) です。 最短は 5 分以内です。 最長 (この値を含む) は 1,440 分 (24 時間) です。
- [更新トークンの有効期間 (日)] - アプリケーションが
offline_access
スコープを許可されていた場合に、新しいアクセス トークンを取得するために更新トークンを使用できる最長期間です。 既定値は 14 日です。 最短は 1 日以内です。 最長 (この値を含む) は 90 日です。 - [更新トークンのスライディング ウィンドウの有効期間] - 更新トークンのスライディング ウィンドウの種類。
Bounded
は、 [有効期間の長さ (日)] に指定されたとおりに更新トークンを延長できることを示しています。No expiry
は、更新トークンのスライディング ウィンドウの有効期間が決して期限切れにならないことを示しています。 - [有効期間の長さ (日)] - この期間が経過すると、アプリケーションによって取得された最新の更新トークンの有効期間にかかわらず、ユーザーは強制的に再認証を求められます。 この値は、 [更新トークンの有効期間] の値以上でなければなりません。
次の図は、更新トークンのスライディング ウィンドウの有効期間における動作を示しています。
Note
PKCE で認可コード フローを使用するシングルページ アプリケーションでは、更新トークンの有効期間は常に 24 時間ですが、モバイル アプリ、デスクトップ アプリ、Web アプリではこの制限がありません。 「ブラウザーでの更新トークンのセキュリティへの影響」で詳細情報を参照してください。
トークンの有効期間を構成する
ユーザー フロー トークンの有効期間を構成するには、次を実行します。
- Azure portal にサインインします。
- 複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
- Azure portal の左上隅にある [すべてのサービス] を選択してから、 [Azure AD B2C] を検索して選択します。
- [ユーザー フロー (ポリシー)] を選択します。
- あらかじめ作成しておいたユーザー フローを開きます。
- [プロパティ] を選択します。
- [トークンの有効期間] で、お使いのアプリケーションのニーズに合わせてプロパティを調整します。
- [保存] を選択します。
トークンの互換性の設定を変更するには、拡張機能、または影響を与えるポリシーの証明書利用者ファイルに、トークン発行者の技術プロファイル メタデータを設定します。 トークン発行者の技術プロファイルは次の例のようになります。
<ClaimsProviders>
<ClaimsProvider>
<DisplayName>Token Issuer</DisplayName>
<TechnicalProfiles>
<TechnicalProfile Id="JwtIssuer">
<Metadata>
<Item Key="token_lifetime_secs">3600</Item>
<Item Key="id_token_lifetime_secs">3600</Item>
<Item Key="refresh_token_lifetime_secs">1209600</Item>
<Item Key="rolling_refresh_token_lifetime_secs">7776000</Item>
<!--<Item Key="allow_infinite_rolling_refresh_token">true</Item>-->
<Item Key="IssuanceClaimPattern">AuthorityAndTenantGuid</Item>
<Item Key="AuthenticationContextReferenceClaimPattern">None</Item>
</Metadata>
</TechnicalProfile>
</TechnicalProfiles>
</ClaimsProvider>
</ClaimsProviders>
以下の値は前の例で設定されています。
- token_lifetime_secs - アクセス トークンの有効期間 (秒)。 既定値は 3,600 (1 時間) です。 最小値は 300 (5 分) です。 最大値は 86,400 (24 時間) です。
- id_token_lifetime_secs - ID トークンの有効期間 (秒)。 既定値は 3,600 (1 時間) です。 最小値は 300 (5 分) です。 最大値は 86,400 (24 時間) です。
- refresh_token_lifetime_secs - 更新トークンの有効期間 (秒) です。 既定値は 1,209,600 (14 日) です。 最小値は 86,400 (24 時間) です。 最大値は 7,776,000 (90 日) です。
- rolling_refresh_token_lifetime_secs - 更新トークンのスライディング ウィンドウの有効期間 (秒)。 既定値は 7,776,000 (90 日) です。 最小値は 86,400 (24 時間) です。 最大値は 31,536,000 (365 日) です。 スライディング ウィンドウの有効期間を適用しない場合は、
allow_infinite_rolling_refresh_token
の値をtrue
に設定します。 - allow_infinite_rolling_refresh_token - 更新トークンのスライディング ウィンドウの有効期間は無期限です。
トークンの互換性の設定
次のようなトークンの互換性を構成できます。
- [発行者 (iss) 要求] - アクセスと ID トークン発行者の形式。
- [サブジェクト (sub) 要求] - トークンによって情報がアサートされるプリンシパル (アプリケーションのユーザーなど)。 この値は変更不可で、再割り当ても再利用もできません。 そのため、この値を使用すると、トークンを使用してリソースにアクセスする場合などに安全に承認チェックができます。 既定では、サブジェクト要求には、ディレクトリ内のユーザーのオブジェクト ID が設定されます。
- [ユーザー フローを表す要求] - この要求は、実行されたユーザー フローを示します。 指定できる値は
tfp
(既定値) またはacr
です。
ユーザー フローの互換性設定を構成するには、次のようにします。
- [ユーザー フロー (ポリシー)] を選択します。
- あらかじめ作成しておいたユーザー フローを開きます。
- [プロパティ] を選択します。
- [トークンの互換性設定] で、お使いのアプリケーションのニーズに合わせてプロパティを調整します。
- [保存] を選択します。
トークンの互換性の設定を変更するには、拡張機能または変更したいポリシーの証明書利用者ファイルにトークン発行者の技術プロファイル メタデータを設定します。 トークン発行者の技術プロファイルは次の例のようになります。
<ClaimsProviders>
<ClaimsProvider>
<DisplayName>Token Issuer</DisplayName>
<TechnicalProfiles>
<TechnicalProfile Id="JwtIssuer">
<Metadata>
...
<Item Key="IssuanceClaimPattern">AuthorityAndTenantGuid</Item>
<Item Key="AuthenticationContextReferenceClaimPattern">None</Item>
</Metadata>
</TechnicalProfile>
</TechnicalProfiles>
</ClaimsProvider>
</ClaimsProviders>
発行者 (iss) 要求: 発行者 (iss) 要求は、IssuanceClaimPattern メタデータ項目で設定します。 指定できる値は、
AuthorityAndTenantGuid
およびAuthorityWithTfp
です。ポリシー ID を表す要求の設定: この値を設定するためのオプションは、
TFP
(Trust Framework Policy) およびACR
(Authentication Context Reference) です。TFP
が推奨値です。 AuthenticationContextReferenceClaimPattern に値None
を設定します。ClaimsSchema 要素に、次の要素を追加します。
<ClaimType Id="trustFrameworkPolicy"> <DisplayName>Trust framework policy name</DisplayName> <DataType>string</DataType> </ClaimType>
証明書利用者ポリシーの OutputClaims 要素の下に、次の出力要求を追加します。
<OutputClaim ClaimTypeReferenceId="trustFrameworkPolicy" Required="true" DefaultValue="{policy}" PartnerClaimType="tfp" />
ACR の場合は、AuthenticationContextReferenceClaimPattern 項目を削除します。
サブジェクト (サブ) 要求: このオプションは、既定で ObjectID に設定されています。この設定を
Not Supported
に切り替える場合は、次の行を置き換えます。<OutputClaim ClaimTypeReferenceId="objectId" PartnerClaimType="sub" />
置き換えた後の行は次のとおりです。
<OutputClaim ClaimTypeReferenceId="sub" />
アプリに省略可能な要求を提供する
アプリケーション要求は、アプリケーションに返される値です。 ユーザー フローを更新して、目的の要求を含めます。
- [ユーザー フロー (ポリシー)] を選択します。
- あらかじめ作成しておいたユーザー フローを開きます。
- [アプリケーション クレーム] を選択します。
- アプリケーションに返信する要求と属性を選択します。
- [保存] を選択します。
証明書利用者ポリシーの技術プロファイルの出力要求は、アプリケーションに返される値です。 出力要求を追加すると、ユーザー体験が成功した後、その要求がトークンに発行され、アプリケーションに送信されます。 証明書利用者セクション内の技術プロファイル要素を変更して、目的の要求を出力要求として追加します。
- カスタム ポリシー ファイルを開きます。 たとえば、SignUpOrSignin.xml などです。
- OutputClaims 要素を検索します。 トークンに含める OutputClaim を追加します。
- 出力要求の属性を設定します。
次の例では、accountBalance
要求を追加します。 accountBalance 要求が、残高としてアプリケーションに送信されます。
<RelyingParty>
<DefaultUserJourney ReferenceId="SignUpOrSignIn" />
<TechnicalProfile Id="PolicyProfile">
<DisplayName>PolicyProfile</DisplayName>
<Protocol Name="OpenIdConnect" />
<OutputClaims>
<OutputClaim ClaimTypeReferenceId="displayName" />
<OutputClaim ClaimTypeReferenceId="givenName" />
<OutputClaim ClaimTypeReferenceId="surname" />
<OutputClaim ClaimTypeReferenceId="email" />
<OutputClaim ClaimTypeReferenceId="objectId" PartnerClaimType="sub"/>
<OutputClaim ClaimTypeReferenceId="identityProvider" />
<OutputClaim ClaimTypeReferenceId="tenantId" AlwaysUseDefaultValue="true" DefaultValue="{Policy:TenantObjectId}" />
<!--Add the optional claims here-->
<OutputClaim ClaimTypeReferenceId="accountBalance" DefaultValue="" PartnerClaimType="balance" />
</OutputClaims>
<SubjectNamingInfo ClaimType="sub" />
</TechnicalProfile>
</RelyingParty>
OutputClaim 要素には、次の属性が含まれています。
- ClaimTypeReferenceId - ポリシー ファイルまたは親ポリシー ファイルの ClaimsSchema セクションで既に定義されている種類の要求の識別子。
- PartnerClaimType - トークン内の要求の名前を変更できます。
- DefaultValue - 既定値です。 また、テナント ID など、要求リゾルバーに対する既定値も設定できます。
- AlwaysUseDefaultValue - 既定値の使用を強制します。
認可コードの有効期間
OAuth 2.0 認可コード フローを使用している場合、アプリは認可コードを使用してターゲット リソースのアクセス トークンを要求できます。 認可コードは有効期間が短く、約 10 分後には期限切れとなります。 承認コードの有効期間は構成できません。 必ず 10 分以内にアプリケーションが認可コードを引き換えるようにしてください。
次のステップ
- アクセス トークンを要求方法の詳細を確認します。
- 開発者のベスト プラクティスにより回復力を実現する方法について説明します。