Configurare AEM Assets con Brand Portal

Adobe Experience Manager (AEM) Assets è configurato con Brand Portal tramite Adobe I/O, che fornisce un token IMS per l’autorizzazione del tenant Brand Portal.

NOTA

La configurazione di AEM Assets con Brand Portal tramite Adobe I/O è supportata in AEM 6.4.8.0 e versioni successive.

In precedenza, Brand Portal era configurato nell’interfaccia classica tramite la versione precedente del gateway OAuth, che utilizza lo scambio di token JWT per ottenere un token di accesso IMS per l’autorizzazione.

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 I/O.

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 una nuova configurazione in Adobe I/O.
  • Aggiorna la configurazione: Se sei un utente Brand Portal esistente con la tua istanza di authoring AEM Assets configurata con Brand Portal sul gateway OAuth legacy, ti consigliamo di eliminare le configurazioni esistenti e crearne di nuove su Adobe I/O.

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 Service Pack più recente.
  • URL del 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.4

Scarica e installa l'ultimo Service Pack AEM

Scarica e installa AEM 6.4

Si consiglia di avere AEM 6.4 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 Service Pack più recente

Per istruzioni dettagliate, vedi

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

Creare la configurazione

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. Adobe I/O Creare l’integrazione
  3. Creare la configurazione dell’account IMS
  4. Configurare il servizio cloud
  5. Verificare la configurazione
NOTA

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

Creare la configurazione IMS

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

La configurazione IMS prevede due passaggi:

Recuperare il certificato pubblico

Il certificato pubblico ti consente di autenticare il profilo su Adobe I/O.

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

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

    Interfaccia utente di configurazione dell’account Adobe IMS

  3. Viene visualizzata la pagina Configurazioni Adobe IMS.

    Fai clic su Crea.

    Viene visualizzata la pagina Configurazione account tecnico Adobe IMS.

  4. Per impostazione predefinita, viene aperta la scheda Certificato.

    In Soluzione cloud, seleziona Adobe Brand Portal.

  5. Seleziona la casella di controllo Crea nuovo certificato e specifica un alias per il certificato. L’alias funge da nome della finestra di dialogo.

  6. Fai clic su Crea certificato. Viene visualizzata una finestra di dialogo. Fai clic su OK per generare il certificato pubblico.

    Crea certificato

  7. Fai clic su Scarica chiave pubblica e salva il file di certificato AEM-Adobe-IMS.crt sul computer. Il file del certificato viene utilizzato per creare Adobe I/O integrazione.

    Scarica certificato

  8. Fai clic su Avanti.

    Nella scheda Account, puoi creare l’account Adobe IMS, ma dovrai disporre dei dettagli di integrazione. Per il momento tieni aperta questa pagina.

    Apri una nuova scheda e Crea Adobe I/O integrazione per ottenere i dettagli di integrazione per le configurazioni dell’account IMS.

Creare l'integrazione Adobe I/O

Adobe I/OL’integrazione di genera i valori di Chiave API, Segreto client e Payload (JWT), necessari per definire le configurazioni dell’account IMS.

  1. Accedi alla console Adobe I/O con privilegi di amministratore di sistema nell’organizzazione IMS del tenant Brand Portal.

    URL predefinito: https://console.adobe.io/

  2. Fai clic su Create Integration (Crea integrazione).

  3. Seleziona Access an API (Accesso a un’API) e fai clic su Continue (Continua).

    Creare una nuova integrazione

  4. Viene visualizzata la pagina Create a new integration (Crea una nuova integrazione).

    Seleziona la tua organizzazione dall’elenco a discesa.

    In Experience Cloud, seleziona AEM Brand Portal e fai clic su Continue (Continua).

    Se l’opzione Brand Portal è disabilitata, assicurati di aver selezionato l’organizzazione corretta dalla casella a discesa sopra l’opzione Adobe Services. Se non sai qual è la tua organizzazione, contatta l’amministratore.

    Creare un’integrazione

  5. Specifica un nome e una descrizione per l’integrazione. Fai clic su Seleziona un file dal computer e carica il file AEM-Adobe-IMS.crt scaricato nella sezione Recupero del certificato pubblico.

  6. Seleziona il profilo della tua organizzazione.

    In alternativa, seleziona il profilo predefinito Assets Brand Portal e fai clic su Create Integration (Crea integrazione). L’integrazione viene creata.

  7. Fai clic su Continue to integration details (Passa ai dettagli dell’integrazione) per visualizzare le informazioni sull’integrazione.

    Copia il valore di API Key (Chiave API).

    Fai clic su Retrieve Client Secret (Recupera segreto client) e copia la chiave del segreto client.

    Informazioni su chiave API, segreto client e payload di un’integrazione

  8. Passa alla scheda JWT e copia il valore del payload JWT.

    Le informazioni relative alla chiave API, al segreto client e al payload JWT verranno utilizzate per creare la configurazione dell’account IMS.

Creare la configurazione dell’account IMS

Verifica di aver eseguito i seguenti passaggi:

Procedura per creare la configurazione dell’account IMS:

  1. Apri la scheda Account nella pagina Configurazione IMS. Hai tenuto aperta questa pagina alla fine della sezione Recuperare il certificato pubblico.

  2. Specifica un titolo per l’account IMS.

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

    Incolla la chiave API, il segreto client e il payload JWT che hai copiato al termine di Crea Adobe I/O integrazione.

    Fai clic su Crea.

    L’integrazione viene creata.

    Configurazione dell’account IMS

  3. Seleziona la configurazione IMS e fai clic su Verifica stato. Viene visualizzata una finestra di dialogo.

    Fai clic su Verifica. Una volta stabilita la connessione, viene visualizzato il messaggio Token recuperato correttamente.

ATTENZIONE

Puoi disporre di una sola configurazione IMS. Non creare più configurazioni 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 creare la configurazione del servizio cloud di Brand Portal, effettua le seguenti operazioni:

  1. Accedi alla tua istanza di authoring di AEM Assets

    URL predefinito: http:// localhost:4502/aem/start.html

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

    Viene aperta la pagina Configurazioni di Brand Portal.

  3. Fai clic su Crea.

  4. Specifica un titolo per la configurazione.

    Seleziona la configurazione IMS creata nel passaggio Creare la configurazione dell’account IMS.

    In URL servizio, immetti l’URL del tenant di Brand Portal.

  5. Fai clic su Salva e chiudi. Viene creata la configurazione cloud. L’istanza di authoring di AEM Assets è ora integrata con il tenant Brand Portal.

Verificare la configurazione

  1. Accedi alla tua istanza di authoring di AEM Assets

    URL predefinito: http:// localhost:4502/aem/start.html

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

  3. Viene visualizzata la pagina Replica.

    Fai clic su Agenti sull'autore.

  4. Per ogni tenant vengono creati quattro agenti di replica.

    Individua gli agenti di replica del tenant Brand Portal.

    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.

  5. Per verificare la connessione tra l'autore di AEM Assets e Brand Portal, fai clic su Prova connessione.

  6. Osserva la parte inferiore dei risultati del test per verificare che la replica sia riuscita.

  7. Verifica i risultati del test su tutti e quattro gli agenti di replica uno per uno.

    NOTA

    Evita di disabilitare uno qualsiasi degli agenti di replica, in quanto può causare errori di replica di alcune delle risorse.

    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.

Brand Portal è stato configurato correttamente con l’istanza di authoring di AEM Assets. Ora puoi:

Configurazione dell'aggiornamento

Esegui i seguenti passaggi nella sequenza elencata per aggiornare le configurazioni esistenti:

  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. Per questo, puoi verificare tutti e quattro gli agenti di replica e verificare che la coda sia ideale/vuota.

  1. Accedi alla tua istanza di authoring di AEM Assets

    URL predefinito: http:// localhost:4502/aem/start.html

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

  3. Viene visualizzata la 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 il seguente elenco di controllo durante l'eliminazione della configurazione esistente.

  • Elimina tutti e quattro gli agenti di replica
  • Elimina servizio cloud
  • Elimina utente MAC

Esegui i seguenti passaggi per eliminare la configurazione esistente:

  1. Accedi alla tua istanza di authoring di AEM Assets e apri CRX Lite come amministratore.

    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 Cloud Service.

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

Ora è possibile creare la configurazione sull'istanza di authoring AEM 6.4 su Adobe I/O.

Una volta completata la replica, puoi pubblicare risorse, cartelle e raccolte in Brand Portal. Per ulteriori informazioni, consulta:

In questa pagina