Configurare AEM Assets con Brand Portal

Le risorse Adobe Experience Manager (AEM) sono configurate con Portale marchio tramite Adobe I/O, che fornisce un token IMS per l'autorizzazione del tenant del Portale marchio.

NOTA

La configurazione AEM Assets con Portale marchio tramite Adobe I/O è supportata in AEM 6.4.8.0 e versioni successive.

Precedentemente, Brand Portal era stato configurato nell’interfaccia classica tramite il gateway OAuth legacy, 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 gateway OAuth esistente. Se si verificano problemi con la configurazione del gateway OAuth legacy, eliminare la configurazione esistente e creare una nuova configurazione tramite Adobe I/O.

Questa guida descrive i due casi d’uso seguenti:

  • Nuova configurazione: Se siete un nuovo utente di Brand Portal e desiderate configurare l’istanza di creazione di AEM Assets con Brand Portal, potete creare una nuova configurazione in Adobe I/O.
  • Configurazione aggiornamento: Se siete un utente esistente di Brand Portal con l’istanza di creazione AEM Assets configurata con Brand Portal su OAuth Gateway legacy, è consigliabile eliminare le configurazioni esistenti e creare una nuova configurazione in Adobe I/O.

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

  • Installazione, configurazione e amministrazione di 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 creazione di AEM Assets con l’ultimo Service Pack.
  • URL del tenant di Brand Portal.
  • Un utente con privilegi di amministratore di sistema nell’organizzazione IMS del tenant di Brand Portal.

Download e installazione AEM 6.4

Download e installazione della versione più recente di AEM Service Pack

Download e installazione AEM 6.4

Si consiglia di AEM 6.4 per impostare un’istanza AEM di creazione. Se non disponete di AEM pronti, scaricatelo dalle seguenti posizioni:

  • Se siete già clienti AEM, scaricate AEM 6.4 dal sito Web delle licenze Adobe.

  • Se siete un partner Adobe, utilizzate il programma di formazione per i partner Adobi ](https://adobe.allegiancetech.com/cgi-bin/qwebcorporate.dll?idx=82357Q) per richiedere AEM 6.4.[

Dopo aver scaricato AEM, per istruzioni su come impostare un'istanza AEM di creazione, vedere implementazione e manutenzione.

Download e installazione AEM Service Pack più recente

Per istruzioni dettagliate, vedete

Se non riesci a trovare il pacchetto di AEM o il Service Pack più recente, contatta la Assistenza clienti.

Creare la configurazione

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

  1. Recuperare il certificato pubblico
  2. Adobe I/O Createintegration
  3. Creare la configurazione dell’account IMS
  4. Configurare il servizio cloud
  5. Verificare la configurazione
NOTA

Un’istanza di autore AEM Assets può essere configurata solo con un 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 consente di autenticare il profilo su Adobe I/O.

  1. Effettuate il login all’istanza di creazione 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.

    Aprite una nuova scheda e Create Adobe I/O integration per ottenere i dettagli di integrazione per le configurazioni dell'account IMS.

Crea 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. Accedete alla Adobe I/O console 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/

    Incollate la chiave API, il segreto cliente e il payload JWT che avete copiato alla fine di Create Adobe I/O integration.

    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. Effettuate il login all’istanza di creazione 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 creazione AEM Assets ora è integrata con il tenant del Brand Portal.

Verificare la configurazione

  1. Effettuate il login all’istanza di creazione AEM Assets

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

  2. Dal pannello Strumenti Strumenti, passare a Distribuzione >> Replica.

  3. Viene visualizzata la pagina Replica.

    Fare clic su Agenti sull'autore.

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

    Individuate gli agenti di replica del tenant del Brand Portal.

    Fate clic sull'URL dell'agente di replica.

    NOTA

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

  5. Per verificare la connessione tra autore AEM Assets e Brand Portal, fate clic su Test Connection.

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

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

    NOTA

    Evitare di disattivare gli agenti di replica, in quanto potrebbe causare errori di replica di alcune risorse.

    Verificate che tutti e quattro gli agenti di replica siano configurati in modo da evitare errori di timeout. Consultate risoluzione dei problemi relativi alla pubblicazione parallela in Brand Portal.

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

Configurazione aggiornamento

Per aggiornare le configurazioni esistenti, eseguite i seguenti passaggi 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 eventuali modifiche, verificate che nessun processo di pubblicazione sia in esecuzione nell’istanza di authoring AEM Assets. A tal fine, è possibile verificare tutti e quattro gli agenti di replica e assicurarsi che la coda sia ideale/vuota.

  1. Effettuate il login all’istanza di creazione AEM Assets

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

  2. Dal pannello Strumenti Strumenti, passare a Distribuzione >> Replica.

  3. Viene visualizzata la pagina Replica.

    Fare clic su Agenti sull'autore.

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

    Verificare 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

Per eliminare la configurazione esistente, effettuate le seguenti operazioni:

  1. Accedete all’istanza di creazione di AEM Assets e aprite CRX Lite come amministratore.

    URL predefinito: http:// localhost:4502/crx/de/index.jsp

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

  3. Passare a /etc/cloudservices/mediaportal ed eliminare la configurazione del Cloud Service.

  4. Andate a /home/users/mac ed eliminate l' utente MAC del tenant del Brand Portal.

È ora possibile creare la configurazione nell'istanza di authoring di AEM 6.4 su Adobe I/O.

Una volta completata la replica, potete pubblicare risorse, cartelle e raccolte in Brand Portal. Per informazioni dettagliate, consultate:

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