Configurare AEM Assets con Brand Portal

Adobe Experience Manager Assets Brand Portal consente di pubblicare risorse di marchio approvate da Adobe Experience Manager Assets su Brand Portal e di distribuirle agli utenti di Brand Portal.

AEM Assets è configurato con Brand Portal tramite Adobe Developer Console, che fornisce un token dell’account Adobe Identity Management Services (IMS) per l’autorizzazione del tenant di Brand Portal.

NOTA

La configurazione di AEM Assets con Brand Portal tramite Adobe Developer Console è supportata in AEM 6.5.4.0 e versioni successive.

In precedenza, Brand Portal era configurato tramite il gateway OAuth legacy, che utilizza lo scambio JSON Web Token (JWT) per ottenere un token di accesso IMS per l’autorizzazione.

La configurazione tramite il gateway OAuth legacy non è più supportata dal 6 aprile 2020 e viene modificata in Adobe Developer Console.

SUGGERIMENTO

Solo per i clienti esistenti

Si consiglia di continuare a utilizzare la configurazione del gateway OAuth esistente. Nel caso in cui si verifichino problemi con la configurazione del gateway OAuth legacy, elimina la configurazione esistente e crea una nuova configurazione tramite Adobe Developer Console.

Questa guida descrive i due casi d’uso seguenti:

  • Nuova configurazione: Se sei un nuovo utente di Brand Portal e desideri configurare l’istanza di authoring di AEM Assets con Brand Portal, puoi creare una configurazione tramite Adobe Developer Console.
  • Aggiorna la configurazione: Se sei un utente esistente di Brand Portal con configurazione su OAuth Gateway legacy, elimina la configurazione esistente e crea una nuova configurazione tramite Adobe Developer Console.

Le informazioni fornite si basano sul presupposto che chiunque legga questa Guida abbia familiarità con le seguenti tecnologie:

  • Installazione, configurazione e amministrazione dei pacchetti Adobe Experience Manager e AEM.

  • Utilizzo di sistemi operativi Linux e Microsoft Windows.

Prerequisiti

Per configurare AEM Assets con Brand Portal, è necessario quanto segue:

  • Un’istanza di authoring AEM Assets in esecuzione con l’ultimo Service Pack
  • URL tenant di Brand Portal
  • Un utente con privilegi di amministratore di sistema nell’organizzazione IMS del tenant di Brand Portal

Scarica e installa AEM 6.5

Scarica e installa l'ultimo Service Pack AEM

Scarica e installa AEM 6.5

Si consiglia di avere AEM 6.5 per impostare un'istanza di authoring AEM. Se non hai AEM in esecuzione, scaricalo dalle seguenti posizioni:

Dopo aver scaricato AEM, per istruzioni su come impostare un'istanza AEM dell'autore, consulta distribuzione e manutenzione.

Scarica e installa AEM più recente Service Pack

Per istruzioni dettagliate, vedi

Se non riesci a trovare l'ultimo pacchetto AEM o Service Pack, contatta il supporto.

Creare la configurazione

La configurazione di AEM Assets con Brand Portal richiede configurazioni sia nell’istanza di authoring di AEM Assets che in Adobe Developer Console.

  1. In AEM Assets, crea un account IMS e genera un certificato pubblico (chiave pubblica).
  2. In Adobe Developer Console, crea un progetto per il tenant di Brand Portal (organizzazione).
  3. Nel progetto, configura un’API utilizzando la chiave pubblica per creare una connessione a un account di servizio (JWT).
  4. Ottieni le credenziali dell'account del servizio e le informazioni sul payload JWT.
  5. In AEM Assets, configura l’account IMS utilizzando le credenziali dell’account del servizio e il payload JWT.
  6. In AEM Assets, configura il servizio cloud Brand Portal utilizzando l’account IMS e l’endpoint Brand Portal (URL dell’organizzazione).
  7. Verifica la configurazione pubblicando una risorsa da AEM Assets a Brand Portal.
NOTA

Un’istanza di authoring di AEM Assets può essere configurata con un solo tenant di Brand Portal.

Esegui i seguenti passaggi nella sequenza elencata se stai configurando AEM Assets con Brand Portal per la prima volta:

  1. Recuperare il certificato pubblico
  2. Crea connessione account di servizio (JWT)
  3. Configurare l’account IMS
  4. Configurare il servizio cloud
  5. Verificare la configurazione

Creare la configurazione IMS

La configurazione IMS autentica l’istanza di authoring di AEM Assets con il tenant di Brand Portal.

La configurazione IMS prevede due passaggi:

Recuperare il certificato pubblico

La chiave pubblica (certificato) autentica il tuo profilo in Adobe Developer Console.

  1. Accedi alla tua istanza di authoring di AEM Assets. L’URL predefinito è http://localhost:4502/aem/start.html.

  2. Dal pannello Strumenti Strumenti, passa a Sicurezza > Configurazioni IMS di Adobe.

  3. Nella pagina Configurazioni IMS di Adobe, fai clic su Crea. Reindirizzerà alla pagina Adobe IMS Technical Account Configuration . Per impostazione predefinita, viene visualizzata la scheda Certificato .

  4. Seleziona Adobe Brand Portal nell’elenco a discesa Soluzione cloud .

  5. Seleziona la casella di controllo Crea nuovo certificato e specifica un alias per la chiave pubblica. L'alias funge da nome della chiave pubblica.

  6. Fai clic su Crea certificato. Quindi, fai clic su OK per generare la chiave pubblica.

    Crea certificato

  7. Fai clic sull'icona Scarica chiave pubblica e salva il file della chiave pubblica (.crt) sul computer.

    La chiave pubblica verrà utilizzata in seguito per configurare l’API per il tenant di Brand Portal e generare le credenziali dell’account del servizio in Adobe Developer Console.

    Scarica certificato

  8. Fai clic su Avanti.

    Nella scheda Account viene creato l’account Adobe IMS che richiede le credenziali dell’account del servizio generate in Adobe Developer Console. Per il momento tieni aperta questa pagina.

    Apri una nuova scheda e crea una connessione a un account di servizio (JWT) in Adobe Developer Console per ottenere le credenziali e il payload JWT per la configurazione dell’account IMS.

Crea connessione account di servizio (JWT)

In Adobe Developer Console, progetti e API sono configurati a livello di tenant di Brand Portal (organizzazione). La configurazione di un’API crea una connessione a un account di servizio (JWT). Esistono due metodi per configurare l’API, generando una coppia di chiavi (chiavi private e pubbliche) o caricando una chiave pubblica. Per configurare AEM Assets con Brand Portal, devi generare una chiave pubblica (certificato) in AEM Assets e creare credenziali in Adobe Developer Console caricando la chiave pubblica. Queste credenziali sono necessarie per configurare l’account IMS in AEM Assets. Una volta configurato l’account IMS, puoi configurare il servizio cloud Brand Portal in AEM Assets.

Esegui i seguenti passaggi per generare le credenziali dell’account del servizio e il payload JWT:

  1. Accedi ad Adobe Developer Console con privilegi di amministratore di sistema nell’organizzazione IMS (tenant di Brand Portal). L'URL predefinito è https://www.adobe.com/go/devs_console_ui.

    NOTA

    Accertati di aver selezionato l’organizzazione IMS corretta (tenant di Brand Portal) dall’elenco a discesa (organizzazione) che si trova nell’angolo in alto a destra.

  2. Fai clic su Crea nuovo progetto. Per la tua organizzazione viene creato un progetto vuoto con un nome generato dal sistema.

    Fai clic su Modifica progetto per aggiornare il Titolo progetto e Descrizione, quindi fai clic su Salva.

  3. Nella scheda Panoramica progetto , fai clic su Aggiungi API.

  4. In Aggiungi una finestra API, seleziona AEM Brand Portal e fai clic su Avanti.

    Assicurati di avere accesso al servizio AEM Brand Portal.

  5. Nella finestra Configura API, fai clic su Carica la chiave pubblica. Quindi, fai clic su Seleziona un file e carica la chiave pubblica (.crt file) che hai scaricato nella sezione Ottieni certificato pubblico .

    Fai clic su Avanti.

    Carica chiave pubblica

  6. Verifica la chiave pubblica e fai clic su Avanti.

  7. Seleziona Assets Brand Portal come profilo di prodotto predefinito e fai clic su Salva API configurata.

    Seleziona profilo prodotto

  8. Una volta configurata l’API, vieni reindirizzato alla pagina di panoramica dell’API. Nella navigazione a sinistra sotto Credenziali, fai clic sull'opzione Account di servizio (JWT).

    NOTA

    Puoi visualizzare le credenziali ed eseguire azioni quali generare token JWT, copiare i dettagli delle credenziali, recuperare il segreto client e così via.

  9. Dalla scheda Credenziali client, copia l' ID client.

    Fai clic su Recupera segreto client e copia il segreto client.

    Credenziali account di servizio

  10. Passa alla scheda Genera JWT e copia le informazioni Payload JWT .

Ora puoi utilizzare l’ID client (chiave API), il segreto client e il payload JWT su configurare l’account IMS in AEM Assets.

Configurare l’account IMS

Verifica di aver eseguito i seguenti passaggi:

Esegui i seguenti passaggi per configurare l’account IMS.

  1. Apri la configurazione IMS e passa alla scheda Account . Hai tenuto aperta la pagina durante il recupero del certificato pubblico.

  2. Specifica un titolo per l’account IMS.

    Nel campo Server autorizzazioni , specifica l’URL: https://ims-na1.adobelogin.com/.

    Specifica l'ID client nel campo Chiave API, Segreto client e Payload (Payload JWT) che hai copiato durante la creazione della connessione dell'account del servizio (JWT)](#createnewintegration).[

    Fai clic su Crea.

    L’account IMS è configurato.

    Configurazione dell’account IMS

  3. Seleziona la configurazione dell’account IMS e fai clic su Verifica stato.

    Fare clic su Controlla nella finestra di dialogo. Una volta completata la configurazione, viene visualizzato un messaggio che informa che il Token viene recuperato correttamente.

ATTENZIONE

Puoi disporre di una sola configurazione IMS.

Verifica che la configurazione IMS superi il controllo di integrità. Se la configurazione non supera questa verifica, non è valida. Dovrai quindi eliminarla e creare una nuova configurazione valida.

Configurare il servizio cloud

Per configurare il servizio cloud Brand Portal, effettua le seguenti operazioni:

  1. Accedi alla tua istanza di authoring di AEM Assets.

  2. Dal pannello Strumenti Strumenti, passa a Cloud Services > AEM Brand Portal.

  3. Nella pagina Configurazioni Brand Portal, fai clic su Crea.

  4. Specifica un titolo per la configurazione.

    Seleziona la configurazione IMS creata durante la configurazione dell’account IMS.

    Nel campo URL servizio , specifica l’URL del tenant di Brand Portal (organizzazione).

  5. Fai clic su Salva e chiudi. Viene creata la configurazione cloud.

    L’istanza di authoring di AEM Assets è ora configurata con il tenant di Brand Portal.

Verificare la configurazione

Esegui i seguenti passaggi per convalidare la configurazione:

  1. Accedi alla tua istanza cloud di AEM Assets.

  2. Dal pannello Strumenti Strumenti, passa a Implementazione > Replica.

  3. Nella pagina Replica, fai clic su Agenti sull'autore.

    Puoi vedere i quattro agenti di replica creati per il tenant di Brand Portal.

    Individua gli agenti di replica del tenant di Brand Portal e fai clic sull’URL dell’agente di replica.

    NOTA

    Gli agenti di replica lavorano in parallelo e condividono la distribuzione del lavoro in modo uniforme, aumentando così la velocità di pubblicazione di quattro volte la velocità originale. Una volta configurato il servizio cloud, non è necessaria alcuna configurazione aggiuntiva per abilitare gli agenti di replica attivati per impostazione predefinita per abilitare la pubblicazione parallela di più risorse.

  4. Per verificare la connessione tra AEM Assets e Brand Portal, fai clic sull’icona Prova connessione .

    Viene visualizzato un messaggio che informa che il pacchetto di test è stato consegnato correttamente.

  5. Verifica i risultati del test su tutti e quattro gli agenti di replica.

    NOTA

    Evita di disabilitare uno qualsiasi degli agenti di replica, in quanto può causare il mancato funzionamento della replica delle risorse (in esecuzione nella coda).

    Assicurati che tutti e quattro gli agenti di replica siano configurati per evitare errori di timeout. Consulta risoluzione dei problemi relativi alla pubblicazione parallela in Brand Portal.

Ora puoi:

Per ulteriori informazioni, consulta la documentazione di Brand Portal .

Aggiorna la configurazione

Esegui i seguenti passaggi nella sequenza elencata per aggiornare le configurazioni esistenti ad Adobe Developer Console:

  1. Verificare i processi in esecuzione
  2. Elimina configurazioni esistenti
  3. Creare la configurazione

Verificare i processi in esecuzione

Assicurati che nessun processo di pubblicazione sia in esecuzione nell’istanza di authoring di AEM Assets prima di apportare eventuali modifiche. A questo scopo, puoi verificare lo stato dei processi attivi su tutti e quattro gli agenti di replica e verificare che le code siano inattive.

  1. Accedi alla tua istanza di authoring di AEM Assets.

  2. Dal pannello Strumenti Strumenti, passa a Implementazione > Replica distribuzione.

  3. Nella pagina Replica, fai clic su Agenti sull'autore.

  4. Individua gli agenti di replica del tenant di Brand Portal.

    Assicurati che la coda sia inattiva per tutti gli agenti di replica, nessun processo di pubblicazione è attivo.

Elimina le configurazioni esistenti

È necessario eseguire la seguente lista di controllo durante l'eliminazione delle configurazioni esistenti:

  • Elimina tutti e quattro gli agenti di replica
  • Elimina servizio cloud di Brand Portal
  • Elimina utente MAC
  1. Accedi alla tua istanza di authoring di AEM Assets e apri CRX Lite come amministratore. L’URL predefinito è http://localhost:4502/crx/de/index.jsp.

  2. Passa a /etc/replications/agents.author ed elimina tutti e quattro gli agenti di replica del tenant di Brand Portal.

  3. Passa a /etc/cloudservices/mediaportal ed elimina la configurazione del servizio cloud di Brand Portal.

  4. Passa a /home/users/mac ed elimina l’ utente MAC del tenant di Brand Portal.

È ora possibile creare la configurazione tramite Adobe Developer Console nell’istanza di authoring AEM 6.5.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now