ドキュメントExperience Cloud KCS

AEMでのJWTからOAuthへの移行後、スマートタグ機能が機能しない

最終更新日： 2026年6月22日

Adobe Experience Manager（AEM）Managed Services サポートでは、JWTからOAuth認証への移行後、スマートタグ機能は動作しません。 この問題を解決するには、ホットフィックスを適用し、OAuth設定、Adobe IMS、およびスマートタグクラウドサービスを再設定し、設定を検証します。

説明 description

環境

Adobe Experience Manager（AEM）Managed Services サポート、v6.5 （特にAssetsの製品内）

問題/症状

JWTからOAuthに移行すると、スマートタグ機能が正しく動作しません。 ホットフィックスを適用し、設定ガイドに従っているにもかかわらず、設定の検証中にNullPointerException エラーが発生します。

関連するエラーログ抽出：

java.lang.NullPointerExceptionat com.google.common.base.Preconditions.checkNotNull(Preconditions.java:192)at com.google.common.cache.LocalCache.get(LocalCache.java:3931)at com.google.common.cache.LocalCache$LocalManualCache.get(LocalCache.java:4721)at com.day.cq.dam.similaritysearch.internal.impl.SimilaritySearchServiceImpl.getServiceVersion(SimilaritySearchServiceImpl.java:478)at com.day.cq.dam.similaritysearch.internal.impl.SimilaritySearchMBeanImpl.validateConfigs(SimilaritySearchMBeanImpl.java:201)

解決策 resolution

JWTからOAuthへの移行後にスマートタグ機能が機能しない問題を解決するには、次の手順に従います。

  1. OAuth統合のためにSP （SP21など）に固有のホットフィックスを適用します。既存の設定は削除されます。
  2. AMSおよびオンプレミス ユーザー向けのドキュメント：OAuth設定ガイド ​に従って、OAuth設定を再構成します。
  3. ツール に移動します > セキュリティ > Adobe IMS設定を実行し、スマートタグ用の新しいIMS設定を作成します。
  4. ツール に移動 > クラウドサービス > スマートタグ とスマートタグクラウドサービスの設定。
  5. /system/console/jmx/com.day.cq.dam.similaritysearch.internal.impl:type=similaritysearchのJMX コンソールにアクセスし、java.lang.NullPointerException エラーがないことを確認します。 エラーが引き続き発生する場合は、手順7を確認します。
  6. 画像をアップロードして、スマートタグが正常に生成されたことを確認します。
  7. ヌルポインターの例外が解決しない場合は、CRX/DEの/conf/global/settings/cloudconfigs/smarttags/<configname>/jcr:contentでsling:resourceType プロパティを"dam/components/smarttaggingservicepage"に更新し、インスタンスを再起動します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles