Configurare AEM Assets con Brand Portal

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

AEM Assets è configurato con Brand Portal tramite la console Adobe Developer, che fornisce un token di 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 di Brand Portal e desideri configurare l’istanza di AEM Assets Author con Brand Portal, puoi creare una configurazione tramite la console Adobe Developer.
• Configurazione aggiornamento: se sei un utente Brand Portal esistente che dispone della configurazione sul gateway OAuth legacy, elimina la configurazione esistente e creane una tramite la console Adobe Developer.

Le informazioni fornite si basano sul presupposto che chiunque legga questa Guida conosca le seguenti tecnologie:

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

• Utilizzo dei sistemi operativi Linux® e Microsoft® Windows.

Prerequisiti

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

• Un’istanza AEM Assets Author in esecuzione con il Service Pack più recente
• URL tenant Brand Portal
• Un utente con privilegi di amministratore di sistema nell’organizzazione IMS del tenant di Brand Portal

Scaricare e installare AEM 6.5

Scarica e installa il Service Pack AEM più recente

Scaricare e installare AEM 6.5

Per impostare un’istanza Autore AEM, si consiglia di usare AEM 6.5. Se l'AEM non è in funzione, scaricarlo dalle seguenti posizioni:

• Se sei già cliente AEM, scarica AEM 6.5 dal Sito Web Adobe Licensing.

• Se sei un partner Adobe, utilizza Programma di formazione per i partner Adobi per richiedere AEM 6.5.

Dopo aver scaricato l’AEM, per istruzioni su come impostare un’istanza di creazione dell’AEM, consulta distribuzione e manutenzione.

Scarica e installa il Service Pack più recente per AEM

Per istruzioni dettagliate, vedere la Note sulla versione di AEM 6.5 Service Pack.

Contatta l’Assistenza clienti Adobe se non è possibile trovare il pacchetto AEM o il Service Pack più recente.

Creare la configurazione

La configurazione di AEM Assets con Brand Portal richiede configurazioni sia nell’istanza di AEM Assets Author che nella console di Adobe Developer.

1. In AEM Assets, crea un account IMS e genera un certificato pubblico (chiave pubblica).
2. Nella console Adobe Developer, 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 di servizio e le informazioni sul payload JWT.
5. In AEM Assets, configura l’account IMS utilizzando le credenziali dell’account di 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.

Se stai configurando AEM Assets con Brand Portal per la prima volta, effettua le seguenti operazioni nella sequenza elencata:

1. Ottenere un certificato pubblico
2. Creare la connessione dell’account di servizio (JWT)
3. Configurare un account IMS
4. Configurare il servizio cloud
5. Verificare la configurazione

Creare la configurazione IMS

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

La configurazione IMS prevede due passaggi:

• Ottenere un certificato pubblico
• Configurare un account IMS

Recuperare il certificato pubblico

La chiave pubblica (certificato) autentica il profilo sulla console Adobe Developer.

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

2. Dalla sezione Strumenti , passa a Sicurezza > Configurazioni Adobe IMS.

3. Nella pagina Configurazioni Adobe IMS, fai clic su Crea. Viene reindirizzato al Configurazione account tecnico Adobe IMS pagina. Per impostazione predefinita, il Certificato viene visualizzata la scheda.

4. Seleziona Adobe Brand Portal nel Soluzione cloud elenco a discesa.

5. Seleziona la Crea nuovo certificato e specificare 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 su Scarica chiave pubblica e salvare il file della chiave pubblica (.crt) sul computer.

   La chiave pubblica viene utilizzata in seguito per configurare l’API per il tenant Brand Portal e generare le credenziali dell’account del servizio nella console Adobe Developer.

   

8. Fai clic su Avanti.

   In Account , viene creato un account Adobe IMS che richiede le credenziali dell’account del servizio generate nella console di Adobe Developer. Per il momento tieni aperta questa pagina.

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

Creare la connessione dell’account di servizio (JWT)

Nella console Adobe Developer, i progetti e le API sono configurati a livello di tenant Brand Portal (organizzazione). La configurazione di un’API crea una connessione dell’account di servizio (JWT). Esistono due metodi per configurare l’API: generando una coppia di chiavi (chiavi privata e pubblica) o caricando una chiave pubblica. Per configurare AEM Assets con Brand Portal, devi generare una chiave pubblica (certificato) in AEM Assets e creare le credenziali nella console di Adobe Developer 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.

Per creare le credenziali dell’account di servizio e il payload JWT, effettua le seguenti operazioni:

1. Accedi alla console Adobe Developer con i 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) nell’angolo in alto a destra.

2. Clic Crea nuovo progetto. Per l’organizzazione viene creato un progetto vuoto con un nome generato dal sistema.

   Clic Modifica progetto in modo da aggiornare Titolo progetto e Descrizione e fai clic su Salva.

3. In Panoramica del progetto , fare clic su Aggiungi API.

4. In Aggiungere una finestra API, seleziona AEM Brand Portal e fai clic su Successivo.

   Assicurati di avere accesso al servizio AEM Brand Portal.

5. In Configurare API finestra, fai clic su Carica la chiave pubblica. Quindi, fai clic su Seleziona un file e carica la chiave pubblica (file .crt) scaricata in ottenere un certificato pubblico sezione.

   Fai clic su Avanti.

   

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

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 API. Dalla barra di navigazione a sinistra in Credenziali, fare clic su Account di servizio (JWT) opzione.

   NOTA

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

9. Dalla sezione Credenziali client , copia il ID client.

   Clic Recupera segreto client e copia segreto client.

   

10. Accedi a Genera JWT e copia il Payload JWT informazioni.

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

Configurare l’account IMS

Verifica di aver già eseguito i seguenti passaggi:

• Ottenere un certificato pubblico
• Creare la connessione dell’account di servizio (JWT)

Per configurare l’account IMS:

1. Apri la configurazione IMS e passa a Account scheda. La pagina è rimasta aperta ottenimento del certificato pubblico.

2. Specifica un titolo per l’account IMS.

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

   Specifica l’ID client in Chiave API campo, Segreto client, e Payload (payload JWT) che hai copiato mentre creazione della connessione dell’account di servizio (JWT).

   Fai clic su Crea.

   L’account IMS è configurato.

   

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

   Clic Verifica nella finestra di dialogo. Una volta completata la configurazione, viene visualizzato un messaggio che informa che Token recuperato correttamente.

   

Configurare il servizio cloud Brand Portal

1. Accedi all’istanza Autore di AEM Assets.

2. Dalla sezione Strumenti , passa a Cloud Service > 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 configurazione dell’account IMS.

   In URL servizio , specifica l’URL del tenant Brand Portal (organizzazione).

   

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

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

Test e convalida della configurazione

1. Accedi all’istanza cloud di AEM Assets.

2. Dalla sezione Strumenti , passa a Distribuzione > Replica.

   

3. Nella pagina Replica, fai clic su Agenti per creazione.

   

   Puoi vedere 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 equamente la distribuzione dei processi, in modo da aumentare la velocità di pubblicazione di quattro volte la velocità originale. Dopo aver configurato il servizio cloud, non è necessaria una 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 sul pulsante Verifica connessione icona.

   

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

   

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

   NOTA

   Evita di disabilitare gli agenti di replica, in quanto potrebbe impedire la 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.

   Non modificare le impostazioni generate automaticamente.

Ora puoi:

• Pubblicare risorse da AEM Assets su Brand Portal
• Pubblicare risorse da Brand Portal su 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

Consulta la Documentazione di Brand Portal per ulteriori informazioni.

Configurazione aggiornamento

Per aggiornare le configurazioni esistenti alla console Adobe Developer, effettua le seguenti operazioni, nella sequenza elencata:

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

Verificare i processi in esecuzione

Prima di apportare qualsiasi modifica, assicurati che nell’istanza Autore AEM Assets non sia in esecuzione alcun processo di pubblicazione. A tale scopo, è possibile verificare lo stato dei processi attivi su tutti e quattro gli agenti di replica e assicurarsi che le code siano inattive.

1. Accedi all’istanza Autore di AEM Assets.

2. Dalla sezione Strumenti , passa a Distribuzione > Replica della distribuzione.

3. Nella pagina Replica, fai clic su Agenti per creazione.

   

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

   Assicurati che La coda è inattiva per tutti gli agenti di replica e nessun processo di pubblicazione è attivo.

   

Elimina configurazioni esistenti

Esegui il seguente elenco 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 all’istanza Autore di AEM Assets e apri CRX Lite come amministratore. L’URL predefinito è http://localhost:4502/crx/de/index.jsp.

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

   

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

   

4. Accedi a /home/users/mac ed elimina Utente Mac del tuo tenant Brand Portal.

   

Ora puoi creare una configurazione tramite la console Adobe Developer nell’istanza Autore AEM 6.5.