Configurare AEM Assets con Brand Portal

Versione Collegamento articolo
AEM as a Cloud Service Fai clic qui
AEM 6.5 Questo articolo
AEM 6.4 Fai clic qui

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.

NOTA

La configurazione di AEM Assets con Brand Portal tramite la console Adobe Developer è 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 nella console Adobe Developer.

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 la console Adobe Developer.

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 la console Adobe Developer.
  • Configurazione dell'aggiornamento: Se sei un utente Brand Portal esistente con configurazione su gateway OAuth legacy, elimina la configurazione esistente e crea una nuova configurazione tramite la console Adobe Developer.

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:

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

Contatta il supporto se non riesci a trovare l'ultimo pacchetto AEM o Service Pack.

Creare la configurazione

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

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

Un’istanza di authoring di AEM Assets può essere configurata con un solo tenant 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

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

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

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

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

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

  5. Seleziona la 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 sul pulsante 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.

    Scarica certificato

  8. Fai clic su Avanti.

    In 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 creare una connessione account di servizio (JWT) nella console Adobe Developer per ottenere le credenziali e il payload JWT per la configurazione dell’account IMS.

Crea connessione 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 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 le credenziali nella console 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.

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

  1. Accedi alla console Adobe Developer 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 Titolo del progetto e Descrizione e fai clic su Salva.

  3. In Panoramica del progetto scheda , fai clic su Aggiungi API.

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

    Assicurati di avere accesso al servizio AEM Brand Portal.

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

    Fai clic su Avanti.

    Carica chiave pubblica

  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.

    Seleziona profilo prodotto

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

    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. Da Credenziali client , copia il ID client.

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

    Credenziali account di servizio

  10. Passa a Genera JWT e copia la Payload JWT informazioni.

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 pagina Account scheda . Hai tenuto la pagina aperta mentre 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 nel Chiave API campo, Segreto client e Payload (Payload JWT) che hai copiato mentre creazione della connessione dell'account del servizio (JWT).

    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.

    Fai clic su Controlla nella finestra di dialogo. Una volta completata la configurazione, viene visualizzato un messaggio che informa che Recupero del token completato.

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

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

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

  2. Da Strumenti Strumenti pannello, 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 mentre 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 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. Da Strumenti Strumenti pannello, passa a Distribuzione > 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 sul pulsante Prova connessione icona.

    Viene visualizzato un messaggio che informa che il 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. Vedi risolvere i problemi relativi alla pubblicazione parallela in Brand Portal.

    Non modificare le impostazioni generate automaticamente.

Ora puoi:

Vedi Documentazione di Brand Portal per ulteriori informazioni.

Configurazione dell'aggiornamento

Esegui i seguenti passaggi nella sequenza elencata per aggiornare le configurazioni esistenti alla console Adobe Developer:

  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. Da Strumenti Strumenti pannello, passa a Distribuzione > Replica della 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 è 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 eliminare Utente Mac del tenant Brand Portal.

Ora puoi crea configurazione tramite Adobe Developer Console nella tua istanza di authoring AEM 6.5.

In questa pagina