Show Menu
ARGOMENTI×

Configurare AEM Assets con Brand Portal

Adobe Experience Manager (AEM) Assets è configurato con Portale marchio tramite Developer Console di Adobe, che fornisce un token IMS per l’autorizzazione del tenant del Brand Portal.
La configurazione AEM Assets con il portale del marchio tramite console per sviluppatori di Adobi è supportata in AEM 6.5.4.0 e versioni successive.
In precedenza, il Portale marchio era stato configurato 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 gateway OAuth legacy non è più supportata dal 6 aprile 2020 e viene modificata in console per sviluppatori di Adobe.
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 console sviluppatore di Adobe.
Questa guida descrive i due casi d’uso seguenti:
  • Nuova configurazione : Se siete un nuovo utente del Brand Portal e desiderate configurare ’istanza di creazione di AEM Assets con Brand Portal, potete creare la configurazione in Adobe Developer Console.
  • 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, eliminate la configurazione esistente e create una nuova configurazione 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 tenant del Brand Portal.
  • Un utente con privilegi di amministratore di sistema nell’organizzazione IMS del tenant di Brand Portal.

Download e installazione AEM 6.5

Si consiglia di AEM 6.5 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.5 dal sito Web delle licenze di Adobe.
  • Se siete un partner Adobe, utilizzate programma di formazione per i partner del Adobe per richiedere AEM 6.5.
Dopo aver scaricato AEM, per istruzioni su come impostare un’istanza AEM di creazione, consultate 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 l’Assistenza clienti.

Creare la configurazione

La configurazione di AEM Assets con Brand Portal richiede configurazioni sia nell’istanza di creazione AEM Assets che Developer Console Adobe.
  1. In AEM Assets, create un account IMS e generate 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. In AEM Assets, configurate l'account IMS utilizzando le credenziali dell'account del servizio e il payload JWT.
  6. In AEM Assets, configurate il servizio cloud Brand Portal utilizzando l'account IMS e l'endpoint del Brand Portal (URL organizzazione).
  7. Verificate la configurazione pubblicando una risorsa da AEM Assets al Brand Portal.
Un’istanza di autore AEM Assets può essere configurata solo con un tenant Brand Portal.
Effettuate i seguenti passaggi nella sequenza elencata se state configurando AEM Assets con Brand Portal per la prima volta:

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. Accedete all’istanza di creazione AEM Assets. L’URL predefinito è http://localhost:4502/aem/start.html
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Nella pagina Configurazioni IMS Adobe, fate clic su Crea .
  4. Viene nuovamente visualizzata la pagina Configurazione account tecnico IMS del Adobe . By default, the Certificate tab opens.
    Selezionate la soluzione cloud Portale marchio Adobe.
  5. Mark the Create new certificate checkbox and specify an alias for the certificate. 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 in seguito per configurare l'API per il tenant del Brand Portal e generare le credenziali dell'account di servizio in Adobe Developer Console.
  8. Fai clic su Avanti .
    Nella scheda Account , viene creato l'account IMS Adobe, ma per tale scopo sarà necessario 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 tenant del Brand Portal (organizzazione). 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 AEM Assets con Brand Portal, dovete generare un certificato pubblico (chiave pubblica) in AEM Assets e creare le credenziali in Developer Console caricando la chiave pubblica. Questa chiave pubblica viene utilizzata per configurare l'API per il tenant del Portale marchio selezionato e genera le credenziali e il payload JWT per l'account del servizio. Tali credenziali vengono ulteriormente utilizzate per configurare l'account IMS in AEM Assets. Una volta configurato l'account IMS, potete configurare il servizio cloud Brand Portal in AEM Assets.
Effettuate le seguenti operazioni per generare le credenziali dell'account del servizio e il payload JWT:
  1. Accedete a console per sviluppatori di Adobe 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) dall'elenco a discesa (organizzazione) 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 API configurata.
  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 potete 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 eseguito i seguenti passaggi:
Effettuate le seguenti operazioni per configurare l'account IMS.
  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 la chiave ​API (ID client), il segreto ​cliente e il payload (payload JWT) che avete copiato durante la creazione della connessione Creare una connessione account di servizio (JWT) dell'account del servizio (JWT).
    Fai clic su Crea .
    L'account IMS è configurato.
  3. Select the IMS account configuration and click Check Health .
    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.
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 configurare il servizio cloud Brand Portal, effettuate le seguenti operazioni:
  1. Accedete all’istanza di creazione AEM Assets.
  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 AEM Assets ora è configurata con il tenant del Brand Portal.

Verificare la configurazione

Effettuate le seguenti operazioni per convalidare la configurazione:
  1. Effettuate l'accesso all'istanza di AEM Assets cloud .
  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 *test è stato consegnato correttamente.
  6. Verificare i risultati del test su tutti e quattro gli agenti di replica.
    Evitate di disattivare qualsiasi agente di replica. Potrebbe causare il fallimento della replica di alcune delle risorse.
L’istanza di creazione di AEM Assets è stata configurata correttamente con Brand Portal ed è 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, 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 le code siano inattive.
  1. Accedete all’istanza di creazione AEM Assets.
  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

Durante l'eliminazione delle configurazioni esistenti è necessario eseguire la seguente checklist.
  • Elimina tutti e quattro gli agenti di replica
  • Elimina servizio cloud Brand Portal
  • Elimina utente MAC
  1. Accedete all’istanza di creazione AEM Assets e aprite 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. Individuate /etc/cloudservices/mediaportal ed eliminate la configurazione del Cloud Service.
  4. Individuate /home/users/mac ed eliminate l'utente ​MAC del tenant di Brand Portal.
È ora possibile creare la configurazione tramite Adobe Developer Console nell’istanza di creazione AEM 6.5.