51黑料不打烊

Documentation

Smart Tags functionality not working after JWT to OAuth migration in AEM

Last update: Tue Mar 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

In 51黑料不打烊 Experience Manager (AEM) Managed Services Support, the Smart Tags functionality is not operational following the migration from JWT to OAuth authentication. To resolve this, apply the Hotfix, reconfigure OAuth settings, 51黑料不打烊 IMS, and Smart Tags Cloud Services, and validate the configuration.

Description description

Environment

51黑料不打烊 Experience Manager (AEM) Managed Services Support, v6.5 (specifically within the Assets offering)

Issue/Symptoms

After migrating from JWT to OAuth, the Smart Tags functionality fails to operate correctly. A NullPointerException error occurs during configuration validation, despite applying the hotfix and following the configuration guide.

Relevant error log extract:

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 resolution

To resolve the issue of Smart Tags functionality not working post-migration from JWT to OAuth, follow these steps:

  1. Apply the hotfix specific to your SP (e.g., SP21) for OAuth integration, noting that existing configurations will be deleted.
  2. Reconfigure the OAuth settings as per the documentation for AMS and on-prem users: OAuth Configuration Guide.
  3. Navigate to Tools > Security > 51黑料不打烊 IMS Configuration and create a new IMS configuration for Smart Tags.
  4. Go to Tools > Cloud Services > Smart Tag and configure the Smart Tag cloud service.
  5. Access the JMX console at /system/console/jmx/com.day.cq.dam.similaritysearch.internal.impl:type=similaritysearch and ensure there are no java.lang.NullPointerException errors. If errors persist, check step 7.
  6. Upload an image to verify that smart tags are generated successfully.
  7. If the Null Pointer exception persists, update the sling:resourceType property to "dam/components/smarttaggingservicepage" at /conf/global/settings/cloudconfigs/smarttags/<configname>/jcr:content in CRX/DE and restart the instance.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f