Configurare AEM Assets con Brand Portal

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

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

Questa guida descrive i due casi d’uso seguenti:

• Nuova configurazione: Se sei un nuovo utente Brand Portal e desideri configurare la tua istanza di authoring AEM Assets con Brand Portal, puoi creare la configurazione tramite Adobe Developer Console.
• Aggiorna la configurazione: Se sei un utente Brand Portal esistente con configurazione su gateway OAuth 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 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:

• Se sei un cliente AEM esistente, scarica AEM 6.5 dal sito web Adobe Licensing.

• Se sei un partner di Adobe, utilizza Adobe Partner Training Program per richiedere AEM 6.5.

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

Scarica e installa AEM Service Pack più recente

Per istruzioni dettagliate, vedi

• Note sulla versione di AEM 6.5 Service Pack

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 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 organizzazione).
7. Verifica la configurazione pubblicando una risorsa da AEM Assets a 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 Brand Portal.

La configurazione IMS prevede due passaggi:

• Recuperare il certificato pubblico
• Configurare l’account IMS

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 , 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.

   

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 Brand Portal e generare le credenziali dell’account del servizio in Adobe Developer Console.

   

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, i progetti e le API sono configurati a livello di tenant 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 Brand Portal). L'URL predefinito è https://www.adobe.com/go/devs_console_ui.

   NOTA

   Accertati di aver selezionato l’organizzazione IMS corretta (tenant 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.

   

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.

   

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.

   

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:

• Recuperare il certificato pubblico
• Crea connessione account di servizio (JWT)

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) 🔗.

   Fai clic su Crea.

   L’account IMS è configurato.

   

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.

   

Configurare il servizio cloud

Esegui i seguenti passaggi per configurare il servizio cloud Brand Portal:

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

2. Dal pannello 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 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 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 , passa a Implementazione > Replica.

   

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

   

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

   Individua gli agenti di replica del tenant 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:

• Pubblicare risorse da AEM Assets su Brand Portal
• Pubblicare risorse da Brand Portal ad AEM Assets - Asset Sourcing in Brand Portal
• Pubblicare cartelle da AEM Assets su Brand Portal
• Pubblicare raccolte da AEM Assets su Brand Portal
• Pubblicare predefiniti, schemi e facet in Brand Portal
• Pubblicare tag in Brand Portal

Per ulteriori informazioni, consulta la documentazione Brand Portal .

Configurazione dell'aggiornamento

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 , passa a Implementazione > Replica distribuzione.

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

   

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

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

   

Elimina 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 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 Brand Portal.

   

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

   

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

   

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