La funzionalità Tag avanzati non funziona dopo la migrazione da JWT a OAuth in AEM

Ultimo aggiornamento: 5 maggio 2025

In Supporto Managed Services per Adobe Experience Manager (AEM), la funzionalità Tag avanzati non è operativa in seguito alla migrazione dall’autenticazione JWT a OAuth. Per risolvere questo problema, applica l’Hotfix, riconfigura le impostazioni OAuth, Adobe IMS e Smart Tags Cloud Services e convalida la configurazione.

Descrizione

Ambiente

Supporto Adobe Experience Manager (AEM) per Managed Services, v6.5 (in particolare nell’offerta Assets)

Problema/Sintomi

Dopo la migrazione da JWT a OAuth, la funzionalità Tag avanzati non funziona correttamente. Si è verificato un errore NullPointerException durante la convalida della configurazione, nonostante l'applicazione dell'aggiornamento rapido e la procedura descritta nella guida alla configurazione.

Estrazione registro errori rilevante:

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)

Risoluzione

Per risolvere il problema di funzionamento della funzionalità Tag avanzati dopo la migrazione da JWT a OAuth, effettua le seguenti operazioni:

  1. Applica l’hotfix specifico all’SP (ad esempio, SP21) per l’integrazione OAuth, notando che le configurazioni esistenti verranno eliminate.
  2. Riconfigura le impostazioni OAuth in base alla documentazione per AMS e gli utenti locali: Guida alla configurazione OAuth.
  3. Passa a Strumenti > Sicurezza > Configurazione Adobe IMS e crea una nuova configurazione IMS per Tag avanzati.
  4. Vai a Strumenti > Servizi cloud > Tag avanzati e configura il servizio cloud di tag avanzati.
  5. Accedere alla console JMX all'indirizzo /system/console/jmx/com.day.cq.dam.similaritysearch.internal.impl:type=similaritysearch e verificare che non siano presenti errori java.lang.NullPointerException. Se gli errori persistono, controllare il passaggio 7.
  6. Carica un’immagine per verificare che i tag avanzati siano generati correttamente.
  7. Se l'eccezione Null Pointer persiste, aggiornare la proprietà sling:resourceType a "dam/components/smarttaggingservicepage" in /conf/global/settings/cloudconfigs/smarttags/<configname>/jcr:content in CRX/DE e riavviare l'istanza.
3d58f420-19b5-47a0-a122-5c9dab55ec7f