从JWT迁移到OAuth服务器到服务器凭据

IMPORTANT
Adobe不再支持查询服务使用的服务帐户(JWT)凭据。 2025年6月30日之后,基于JWT的未过期凭据将不再刷新或验证API请求。 要防止服务中断,必须将每个符合条件的凭据迁移到OAuth服务器到服务器身份验证。

本指南向您展示了如何在Adobe Experience Platform中将未过期的JWT凭据迁移到OAuth服务器到服务器凭据。 完成此流程可确保在对JWT凭据的支持于2025年6月30日结束之前对查询服务的无中断访问。

本文档提供了有关执行迁移、了解影响以及验证已更新凭据的分步说明。

需要迁移的人员 who-needs-to-migrate

如果您在查询服务中使用未过期的凭据,则必须迁移每个凭据。 这适用于自动工作流、计划查询或自定义API集成中使用的凭据。

如果在​ 凭据 ​选项卡的​ 未过期的凭据 ​部分下列出凭据,则这些凭据会受到影响。

如何迁移凭据 how-to-migrate

可直接在Experience Platform UI中迁移凭据。 为此,请在左侧导航中导航到​ 查询,然后选择​ 凭据 ​选项卡。 在​ 未过期的凭据 ​部分中,识别标记为适于迁移的凭据,然后选择其旁边的​ 迁移

NOTE
迁移需要8到10秒时间,一旦开始,将无法取消。

查询服务凭据工作区中突出显示了查询、凭据和迁移。

迁移后,系统会更新凭据以使用OAuth服务器到服务器身份验证。 基于JWT的方法已自动停用,且状态更新为​ 已迁移

无需重新配置。 现有的工作和集成可继续不间断地工作。

迁移后发生的情况 after-migration

完成迁移后:

  • 您的凭据可继续无缝工作,因此您的作业或集成不需要任何更改。
  • 查询服务自动使用OAuth服务器到服务器身份验证。
  • 基于JWT的身份验证方法已停用,不再使用。
IMPORTANT
您无法撤消此更改。 迁移后,凭据无法恢复为JWT。

常见问题解答 faq

这些问题解决了共同关心的问题,并帮助您确保顺利、无中断的迁移。

为什么Adobe要弃用JWT凭据?

OAuth服务器到服务器是一种更安全和标准化的身份验证方法。 它提供了更好的生命周期管理,并支持更广泛的平台一致性。

如果我没有在2025年6月30日之前进行迁移,会发生什么?

JWT凭据将停止刷新,依赖这些凭据的集成将失败。 除非您启动该流程,否则Adobe无法代表您迁移凭据。

如何知道是否需要迁移?

如果凭据显示在“凭据”选项卡的​ 未过期的凭据 ​部分下,则必须迁移这些凭据。

是否需要更新集成或重新配置任何内容?

不会。迁移后,OAuth凭据会自动接管。 您的作业或集成中不需要手动更改。

我可以一次迁移所有凭据吗?

不会。必须使用​ 迁移 ​按钮分别迁移每个凭据。

我可以继续使用过期凭据吗?

可以。此更改不会影响过期凭据。 只能迁移未过期的JWT凭据。

我看到一条消息,显示“未找到未过期的凭据。”这是什么意思? 我需要采取任何措施吗?

此消息表示您尚未创建任何不会过期的凭据,因此无需执行任何操作。

我看到一条消息,显示“AEP管理员验证失败…” 这是什么意思? 我需要采取任何措施吗?

此消息指示您不是管理员,或者您没有创建非过期凭据的必要权限。

  • 如果您的权限最近未发生更改,这意味着您从未拥有创建凭据的权限,因此无需执行任何操作。
  • 如果最近更改了您的权限,请联系您的组织管理员,要求他们为您迁移凭据。

我可以为其他人迁移未过期的凭据吗?

可以,但前提是您是管理员。 只有管理员才具有为其他用户创建和迁移非过期凭据所需的权限,因此他们可以继续工作而不会中断。

后续步骤 next-steps

查看凭据选项卡中的每个未过期的凭据,并在2025年6月30日之前分别迁移它们。 如有疑问或需要支持,请联系您的Adobe客户代表。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb