Show Menu
ARGOMENTI×

Configurare AEM Assets con Brand Portal

Risorse Adobe Experience Manager (AEM) è configurato con Brand Portal tramite Adobe Developer Console, che fornisce un token IMS per l’autorizzazione del tenant del Brand Portal.
La configurazione di Risorse AEM con il portale del marchio tramite Adobe Developer Console è supportata in AEM 6.5.4.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.
La configurazione tramite OAuth legacy non è più supportata dal 6 aprile 2020 e viene modificata in configurazione tramite Adobe Developer Console.
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 precedente, eliminate la configurazione esistente e create una nuova configurazione tramite Adobe Developer Console.
Questa guida descrive i due casi d’uso seguenti:
  • Nuova configurazione : Se sei un nuovo utente del Brand Portal e vuoi configurare l’istanza di creazione di Risorse AEM con Brand Portal, puoi creare una nuova configurazione in Adobe Developer Console.
  • Configurazione aggiornamento: Se sei un utente esistente di Brand Portal con l’istanza di creazione di Risorse AEM configurata con Brand Portal su OAuth Gateway legacy, si consiglia di eliminare le configurazioni esistenti e creare una nuova configurazione in Adobe Developer Console.
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.

Scaricare e installare AEM 6.5

È consigliabile disporre di AEM 6.5 per configurare un’istanza di creazione AEM. Se AEM non è già operativo, scaricatelo dai seguenti percorsi:
Dopo aver scaricato AEM, per istruzioni su come impostare un’istanza di creazione AEM, consultate Implementazione e manutenzione .

Download e installazione dell'ultimo Service Pack di AEM

Per istruzioni dettagliate, vedete
Contatta l’Assistenza clienti se non riesci a trovare il pacchetto AEM o il Service Pack più recente.

Creare la configurazione

La configurazione di Risorse AEM con Brand Portal richiede configurazioni sia nell’istanza di creazione di Risorse AEM che in Adobe Developer Console.
  1. Nell’istanza di creazione di AEM Assets, crea un account IMS e genera un certificato pubblico (chiave pubblica).
  2. In Adobe Developer Console, crea un progetto per il tenant del Brand Portal (organizzazione).
  3. Nel progetto, configura un'API utilizzando la chiave pubblica per creare una connessione a un account di servizio (JWT).
  4. Ottenete le credenziali dell'account del servizio e le informazioni sul payload JWT.
  5. Nell’istanza di creazione di AEM Assets, configura l’account IMS utilizzando le credenziali dell’account del servizio e il payload JWT.
  6. Nell’istanza di creazione di AEM Assets, configura il servizio cloud Brand Portal tramite l’account IMS e l’endpoint del Brand Portal (URL organizzazione).
  7. Verifica la configurazione pubblicando una risorsa dall’istanza di creazione di AEM Assets al Brand Portal.
Un tenant di Brand Portal può essere configurato solo con un’istanza di autore di AEM Assets.
Non configurate un tenant di Brand Portal con più istanze di creazione di AEM Assets.
Se stai configurando Risorse AEM con Brand Portal per la prima volta, effettua i seguenti passaggi nella sequenza elencata:

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 in Adobe Developer Console.
  1. Accedi all’istanza di creazione di Risorse AEM. L’URL predefinito è http:// localhost:4502/aem/start.html
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Nella pagina Configurazioni Adobe IMS, fate clic su Crea .
  4. Viene nuovamente visualizzata la pagina Configurazione account tecnico di Adobe IMS. By default, the Certificate tab opens.
    Selezionate la soluzione cloud 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 . Quindi, fate clic su OK nella finestra di dialogo per generare il certificato pubblico.
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    Il file del certificato verrà utilizzato nei passaggi successivi per configurare l'API per il tenant del Brand Portal e generare le credenziali dell'account del servizio in Adobe Developer Console.
  8. Fai clic su Avanti .
    Nella scheda Account , potete creare l'account Adobe IMS, ma per questo dovrete disporre delle credenziali dell'account di servizio generate in Adobe Developer Console. Per il momento tieni aperta questa pagina.
    Aprite una nuova scheda e create una connessione account di servizio (JWT) in Adobe Developer Console per ottenere le credenziali e il payload JWT per configurare l'account IMS.

Creare una connessione account di servizio (JWT)

In Adobe Developer Console, i progetti e le API sono configurati a livello di organizzazione (tenant Brand Portal). La configurazione di un'API crea una connessione a un account di servizio (JWT) in Adobe Developer Console. Esistono due metodi per configurare l'API, generando una coppia di chiavi (chiavi private e pubbliche) o caricando una chiave pubblica. Per configurare l’istanza di creazione di Risorse AEM con il Brand Portal, devi generare un certificato pubblico (chiave pubblica) nell’istanza di creazione di Risorse AEM e creare le credenziali in Adobe Developer Console caricando la chiave pubblica. Questa chiave pubblica viene utilizzata per configurare l'API per l'organizzazione Brand Portal selezionata e genera le credenziali e il payload JWT per l'account del servizio. Queste credenziali vengono ulteriormente utilizzate per configurare l'account IMS nell'istanza di creazione di AEM Assets. Una volta configurato l’account IMS, puoi configurare il servizio cloud Brand Portal nell’istanza di creazione di Risorse AEM.
Effettuate le seguenti operazioni per generare le credenziali dell'account del servizio e il payload JWT:
  1. Accedete ad Adobe Developer Console con privilegi di amministratore di sistema nell’organizzazione IMS (tenant Brand Portal). L’URL predefinito è
    Accertatevi di aver selezionato l'organizzazione IMS corretta (tenant Brand Portal) dal menu a discesa (elenco organizzazioni) situato nell'angolo superiore destro.
  2. Click Create new project . Viene creato un progetto vuoto per la vostra organizzazione.
    Fate clic su Modifica progetto per aggiornare il Titolo e la Descrizione del progetto, quindi fate clic su Salva .
  3. Nella scheda Panoramica progetto, fate clic su Aggiungi API .
  4. Nella finestra Aggiungi un API, selezionate AEM Brand Portal e fate clic su Avanti .
    Assicuratevi di avere accesso al servizio AEM Brand Portal.
  5. Nella finestra Configura API, fate clic su Carica la chiave pubblica. Quindi, fate clic su Seleziona un file e caricate il certificato pubblico (file .crt) scaricato nella sezione Ottieni certificato pubblico.
    Fai clic su Avanti .
  6. Verifica il certificato pubblico e fai clic su Avanti .
  7. Selezionate il profilo di prodotto predefinito Assets Brand Portal e fate clic su Salva configurazione .
  8. Con l'API configurata, verrete reindirizzati alla panoramica dell'API. Nel menu di navigazione a sinistra, in Credenziali , fate clic su Account servizio (JWT) .
    Potete visualizzare le credenziali ed eseguire altre azioni (generare token JWT, copiare i dettagli delle credenziali, recuperare il segreto client e così via) in base alle esigenze.
  9. Dalla scheda Credenziali ​client, copiate l'ID ​client.
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
Ora puoi usare l’ID client (chiave API), il segreto client e il payload JWT per configurare l’account IMS nell’istanza cloud di AEM Assets.

Creare la configurazione dell’account IMS

Verifica di aver eseguito i seguenti passaggi:
Effettuate le seguenti operazioni per configurare l'account IMS creato per ottenere il certificato pubblico.
  1. Aprite IMS Configuration (Configurazione IMS) e passate alla scheda Account . La pagina è rimasta aperta durante il recupero del certificato pubblico.
  2. Specifica un titolo per l’account IMS.
    In Server autorizzazioni , immetti l’URL: https://ims-na1.adobelogin.com/
    Incollate l'ID client nella chiave API, nel segreto client e nel payload JWT che avete copiato durante la creazione della connessione dell'account del servizio (JWT).
    Fai clic su Crea .
    L'account IMS è configurato.
  3. Seleziona la configurazione IMS e fai clic su Verifica stato .
    Fare clic su Controlla nella finestra di dialogo. Se la configurazione è stata completata, viene visualizzato un messaggio che informa che il token è stato recuperato correttamente.
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 il servizio cloud Brand Portal, effettuate le seguenti operazioni:
  1. Accedi all’istanza di creazione di Risorse AEM.
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. Nella pagina Configurazioni Brand Portal, fate clic su Crea .
  4. Specifica un titolo per la configurazione.
    Selezionate la configurazione IMS creata durante la configurazione dell'account IMS.
    In the Service URL , enter your Brand Portal tenant (organization) URL.
  5. Fai clic su Salva e chiudi . Viene creata la configurazione cloud. L’istanza di creazione di AEM Assets è ora configurata con il tenant del Brand Portal.

Verificare la configurazione

Effettuate le seguenti operazioni per convalidare la configurazione:
  1. Accedi all’istanza cloud di AEM Assets.
  2. From the Tools panel, navigate to Deployment > Replication .
  3. Nella pagina Replica, fate 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.
    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 AEM Assets e Brand Portal, fai clic su Prova connessione .
    Nella parte inferiore della pagina viene visualizzato un messaggio che informa che il pacchetto di test è stato consegnato correttamente.
  6. Verificate i risultati del test su tutti e quattro gli agenti di replica uno per uno.
    Evitare di disattivare gli agenti di replica, in quanto potrebbe causare errori di replica di alcune risorse.
L’istanza di creazione di Risorse AEM è stata configurata correttamente con Brand Portal. È ora possibile:

Aggiornamento della configurazione

Per aggiornare le configurazioni esistenti, eseguite i seguenti passaggi nella sequenza elencata:

Verificare i processi in esecuzione

Prima di apportare eventuali modifiche, accertati che nell’istanza di creazione di Risorse AEM non sia in esecuzione alcun processo di pubblicazione. A tal fine, è possibile verificare tutti e quattro gli agenti di replica e assicurarsi che la coda sia ideale/vuota.
  1. Accedi all’istanza di creazione di Risorse AEM.
  2. Dal pannello Strumenti , accedi a Distribuzione > Replica ​distribuzione.
  3. Nella pagina Replica, fate clic su Agenti sull’autore .
  4. Individuate gli agenti di replica del tenant del Brand Portal.
    Verificate 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 delle configurazioni esistenti.
  • Elimina tutti e quattro gli agenti di replica
  • Elimina servizio cloud
  • Elimina utente MAC
  1. Accedi all’istanza di creazione di Risorse AEM e apri CRX Lite come amministratore. L’URL predefinito è
    http:// localhost:4502/crx/de/index.jsp
  2. Individuate /etc/replications/agents.author ed eliminate tutti e quattro gli agenti di replica del tenant del Brand Portal in uso.
  3. Andate a /etc/cloudservices/mediaportal ed eliminate la configurazione del servizio Cloud.
  4. Individuate /home/users/mac ed eliminate l'utente ​MAC del tenant di Brand Portal.
Ora puoi creare la configurazione nell’istanza di creazione di AEM 6.5.
Una volta completata la replica, potete pubblicare risorse, cartelle e raccolte in Brand Portal. Per informazioni dettagliate, consultate: