限制外部客户端应用程序中的空闲刷新令牌 TTL
为了提高安全性,请将空闲刷新令牌 TTL(生存时间)设置为 30 天的限制。空闲 TTL 是刷新令牌在过期前可能不活动的时间。空闲 TTL 用作滑动窗口:在 30 天内每次使用令牌时,其空闲 TTL 都会重置。作为应用程序开发人员,当您打开此限制时,它会影响订阅者的刷新令牌策略。
所需的 Edition
| 适用于:Lightning Experience |
| 适用于:Professional、Performance、Unlimited 和 Developer Edition |
| 所需用户权限 | |
|---|---|
| 配置外部客户端应用程序 OAuth 设置 | 创建、编辑和删除外部客户端应用程序 |
备注 查找有关限制空闲刷新令牌 TTL 的连接的应用程序文档?请参阅此文章。
与您的订阅者合作,让他们知道您何时启用这些更改。以下是一些对您和订阅者非常重要的亮点。
- 这些策略受限制的影响。
- 刷新标记在撤销前有效
- 刷新标记在特定时间后过期
- 刷新标记过期(如果未用于特定时间)
- 对于“刷新标记在撤销前有效”和“刷新标记如果未在特定时间内过期”策略,该限制会导致与 UI、行为和元数据不一致。要修复这些不一致,请更新您的应用程序并鼓励订阅者也这样做。
- “立即过期刷新标记”策略不受该限制的影响。
| 刷新令牌策略 | 空闲 TTL 限制的行为更改 | 如何修复 UI、行为和元数据的不一致 |
|---|---|---|
| 刷新标记在撤销前有效 | 随着空闲 TTL 限制的强制执行,此策略不再有效。在 UI 中,此选项变为隐藏,策略选择更改为“如果未在特定时间内使用,刷新令牌过期”,有效期设置为 30 天。 |
Salesforce 不会自动更新应用程序的元数据以反映此更改。 在 ExtlClntAppOauthConfigurablePolicies 元数据类型中:
|
| 刷新标记立即过期 | 无 | 不适用 |
| 刷新标记在特定时间后过期 | 刷新令牌仍使用应用程序策略中配置的有效期。如果超过 30 天,空闲 TTL 限制也适用。 例如,如果配置的有效期是 1 年,空闲令牌仍会在 30 天后过期。在连续使用的情况下,令牌可以持续最多 1 年。 |
不适用 |
| 刷新标记过期(如果未用于特定时间) | 此策略的此配置有效期已用作具有滑动窗口的空闲 TTL。唯一的变化是有效期现在不能超过 30 天。 | Salesforce 不会自动更新 UI 或元数据以反映此更改。 在 UI 中,将有效期更新为 30 天。 在 ExtlClntAppOauthConfigurablePolicies 元数据类型中:
|
要打开空闲 TTL 限制,请执行以下步骤。
- 从“设置”中,在快速查找框中输入外部,然后单击外部客户端应用程序管理器。
- 查找应用程序,并单击编辑设置。
- 在 OAuth 设置中,找到安全部分,并打开将空闲刷新令牌的生存时间 (TTL) 限制为 30 天。
- 保存更改。
- 转到“策略”选项卡,找到“应用程序授权”部分。现在,刷新令牌策略标题表示空闲 TTL 限制已强制执行。
- 修复与行为、UI 和元数据的任何不一致。有关要更新哪些元数据类型和字段的具体信息,请参考上表。
本文章是否解决您的问题?
请与我们共享您的想法,以便我们进行改进!

