接続アプリケーションでのアイドル更新トークン TTL の制限
セキュリティを強化するために、アイドル更新トークンの TTL (存続可能時間) に 30 日の制限を設定します。これは、更新トークンが期限切れになる前に無効になる可能性がある時間です。アイドル TTL はスライディングウィンドウとして機能します。トークンが 30 日以内に使用されるたびに、そのアイドル TTL がリセットされます。アプリケーション開発者として、この制限を有効にすると、登録者の更新トークンポリシーに影響します。
必要なエディション
| 使用可能なインターフェース: Salesforce Classic および Lightning Experience の両方 |
接続アプリケーションを作成できるエディション: Group Edition、Essentials Edition、Professional Edition、Enterprise Edition、Performance Edition、Unlimited Edition、および Developer Edition 接続アプリケーションをインストールできるエディション: すべてのエディション |
| 必要なユーザー権限 | |
|---|---|
| 接続アプリケーションを参照、作成、更新または削除する | 「アプリケーションのカスタマイズ」および「すべてのデータの編集」または「接続アプリケーションの管理」のいずれか |
メモ アイドル更新トークンの TTL の制限に関する外部クライアントアプリケーションのドキュメントをお探しですか?この記事を参照してください。
これらの変更を有効にするときは、登録者に通知します。以下は、あなたと登録者が把握しておく必要のある重要な特長です。
- これらのポリシーは制限の影響を受ける。
- 更新トークンは取り消されるまで有効です
- 数値単位時間後に更新トークンを期限切れにする
- 数値単位時間に更新トークンを使用しない場合、更新トークンを期限切れにする
- "[Refresh token is valid until revoked (更新トークンは取り消されるまで有効です)] ポリシーと [Expire refresh token if not used for number unit of time (時間単位に更新トークンを使用しない場合は期限切れにする)] ポリシーでは、この制限により UI、動作、メタデータに矛盾が生じます。"これらの矛盾を修正するには、アプリケーションを更新し、登録者に同様の操作を促します。
- [Immediately expire refresh token (更新トークンをすぐに期限切れにする)] ポリシーは、この制限の影響を受けません。
この制限が各保険契約にどのように影響するかの詳細を次に示します。
| 更新トークンポリシー | アイドル TTL 制限による動作の変更 | UI、動作、およびメタデータの不一致を修正する方法 |
|---|---|---|
| 更新トークンは取り消されるまで有効です | このポリシーは、アイドル TTL 制限が適用されて無効になります。UI では、このオプションが非表示になり、ポリシーの選択が [特定の時間に使用されない場合、更新トークンを期限切れにする] に変更され、有効期間が 30 日に設定されます。 | Salesforce はこの変更を反映するためにアプリケーションのメタデータを自動的に更新しません。ConnectedAppOauthPolicy メタデータ型を更新するには、refreshTokenPolicy フィールドの値を specific_inactivity:30:DAYS に変更します。 |
| 更新トークンをすぐに期限切れにする | なし | 該当なし |
| 数値単位時間後に更新トークンを期限切れにする | 更新トークンでは、引き続きアプリケーションポリシーで設定された有効期間が使用されます。期間が 30 日を超える場合、アイドル TTL 制限も適用されます。 たとえば、設定された有効期間が 1 年の場合、アイドル状態のトークンは 30 日後に期限切れになります。継続的な使用の場合、トークンは最大 1 年間使用できます。 |
該当なし |
| 数値単位時間に更新トークンを使用しない場合、更新トークンを期限切れにする | このポリシーで設定された有効期間は、すでにスライディングウィンドウのあるアイドル TTL として機能します。唯一の変更点は、設定された有効期間が 30 日を超えることができないことです。 | Salesforce はこの変更を反映するために UI またはメタデータを自動的に更新しません。
|
アイドル TTL 制限を有効にするには、次の手順を実行します。
- [設定] から、[クイック検索] ボックスに「アプリケーション」と入力し、[アプリケーションマネージャー] をクリックします。
- アプリケーションを見つけて、[編集] をクリックします。
- [API (OAuth 設定の有効化)] セクションで、[Limit Idle Refresh Token Time-to-Live (TTL) to 30 Days (アイドル更新トークンの存続可能時間 (TTL) を 30 日間に制限)] を有効にします。
- 変更内容を保存します。
- [管理] をクリックし、[ポリシーの編集] を選択します。
- 動作、UI、メタデータの不一致を修正します。更新するメタデータ型と項目についての詳細は、上記の表を参照してください。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
