ドキュメントExperience Platformクエリサービスガイド

JWT から OAuth サーバー間資格情報への移行

最終更新日: 2025年5月20日
  • トピック:

作成対象:

  • ユーザー
  • 開発者
IMPORTANT
Adobeは、クエリサービスで使用されるサービスアカウント(JWT)資格情報のサポートを廃止します。 2025 年 6 月 30 日(PT)以降、JWT に基づく有効期限のない資格情報は、API リクエストを更新または認証しなくなります。 サービスが中断されないようにするには、適格な各資格情報を OAuth サーバー間認証に移行する必要があります。

このガイドでは、有効期限のない JWT 資格情報をAdobe Experience Platformの OAuth サーバー間資格情報に移行する方法について説明します。 このプロセスを完了することで、JWT 資格情報のサポートが 2025 年 6 月 30 日(PT)に終了する前に、クエリサービスへの中断のないアクセスが保証されます。

このドキュメントでは、移行を実行し、影響を理解し、更新された資格情報を検証する手順を説明します。

移行する必要があるユーザー

有効期限のない資格情報をクエリサービスで使用する場合は、それぞれを移行する必要があります。 これは、自動ワークフロー、スケジュール済みクエリ、カスタム API 統合のいずれかで使用される資格情報に適用されます。

「資格情報」タブの「有効期限のない資格情報」セクションに資格情報が表示される場合、それらの資格情報が影響を受けます。

資格情報の移行方法

資格情報はExperience Platform UI で直接移行できます。 これを行うには、左側のナビゲーションで クエリ に移動し、「資格情報」タブを選択します。 「有効期限のない資格情報」セクションで、移行対象としてマークされた資格情報を特定し、その横にある「移行」を選択します。

NOTE
移行には 8 ~ 10 秒かかり、開始後にキャンセルすることはできません。

「クエリ」、「資格情報」および「移行」がハイライト表示されたクエリサービス資格情報ワークスペース

移行後、システムは OAuth サーバー間認証を使用するように資格情報を更新します。 JWT ベースのメソッドは自動的に廃止され、ステータスが 移行済み に更新されます。

再設定は必要ありません。 既存のジョブと統合は引き続き中断なく機能します。

移行後の処理

移行が完了したら、次の手順を実行します。

  • 資格情報は引き続きシームレスに機能するので、ジョブや統合で変更を加える必要はありません。
  • クエリサービスは、OAuth サーバー間認証を自動的に使用します。
  • JWT ベースの認証方法は廃止され、使用されなくなりました。
IMPORTANT
この変更を元に戻すことはできません。 移行後は、資格情報を JWT に戻すことはできません。

よくある質問

これらの質問は、一般的な問題に対処し、中断のないスムーズな移行を確実にするのに役立ちます。

Adobeで JWT 資格情報が非推奨(廃止予定)になる理由

OAuth サーバー間は、より安全で標準化された認証方法です。 ライフサイクル管理が向上し、より広範なプラットフォームの一貫性をサポートします。

2025 年 6 月 30 日(PT)までに移行しない場合はどうなりますか?

JWT 資格情報は更新を停止し、これらに依存する統合は失敗します。 プロセスを開始しない限り、Adobeはユーザーに代わって資格情報を移行できません。

移行が必要かどうかを確認するにはどうすればよいですか?

「資格情報」タブの「有効期限のない資格情報 セクションに資格情報が表示される場合は、その資格情報を移行する必要があります。

統合を更新したり、再設定したりする必要がありますか?

いいえ。移行後は、OAuth 認証情報が自動的に引き継ぎます。 ジョブや統合では、手動の変更は必要ありません。

すべての資格情報を一度に移行できますか?

いいえ。移行 ボタンを使用して、各資格情報を個別に移行する必要があります。

有効期限が切れる資格情報を引き続き使用できますか?

はい。有効期限が切れる資格情報は、この変更の影響を受けません。 有効期限のない JWT 資格情報のみを移行する必要があります。

「​ 有効期限のない資格情報が見つかりません。」これはどういう意味ですか? 何か行動を起こす必要がありますか。

このメッセージは、有効期限のない資格情報がまだ作成されていないことを意味するので、必要な操作はありません。

「AEP管理者の検証に失敗しました ​…」というメッセージが表示されます これはどういう意味ですか? 何か行動を起こす必要がありますか。

このメッセージは、あなたが管理者でないか、有効期限のない資格情報を作成するために必要な権限がないことを示しています。

  • 権限が最近変更されていない場合は、資格情報を作成するためのアクセス権がないので、アクションは必要ありません。
  • 最近アクセス許可が変更された場合は、組織の管理者に問い合わせて、資格情報の移行を依頼してください。

有効期限のない資格情報を他のユーザーに移行できますか?

はい。ただし、管理者の場合に限ります。 有効期限のない認証情報を作成して他のユーザーに移行するために必要な権限を持っているのは管理者のみなので、管理者は中断することなく作業を続行できます。

次の手順

「​ 資格情報 ​」タブで有効期限のない各資格情報を確認し、2025 年 6 月 30 日(PT)までに個別に移行します。 ご質問やサポートについては、Adobe アカウント担当者にお問い合わせください。

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