Configurare AEM Assets con Brand Portal configure-integration-65

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

Adobe Experience Manager Assets Brand Portal consente di pubblicare in Brand Portal le risorse approvate per il marchio da Adobe Experience Manager Assets e distribuirle agli utenti di Brand Portal.

AEM Assets è configurato con Brand Portal tramite la console Adobe Developer, che fornisce un token di account Adobe Identity Management Services (IMS) per l’autorizzazione del tenant Brand Portal.

NOTE
La configurazione di AEM Assets con Brand Portal tramite la console Adobe Developer è supportata su AEM 6.5.4.0 e versioni successive.
In precedenza, Brand Portal era configurato tramite il precedente gateway OAuth, 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 a partire dal 6 aprile 2020 e viene modificata in Adobe Developer Console.
TIP
Solo per clienti esistenti
L’Adobe consiglia di continuare a utilizzare la configurazione legacy del gateway OAuth esistente. Se riscontri problemi con la configurazione legacy del gateway OAuth, elimina la configurazione esistente e crea una configurazione tramite la console Adobe Developer.

Questa guida descrive i due casi d’uso seguenti:

  • Nuova configurazione: se sei un nuovo utente di Brand Portal e desideri configurare l’istanza di AEM Assets Author con Brand Portal, puoi creare una configurazione tramite la console Adobe Developer.
  • Configurazione aggiornamento: se sei un utente Brand Portal esistente che dispone della configurazione sul gateway OAuth legacy, elimina la configurazione esistente e creane una tramite la console Adobe Developer.

Le informazioni fornite si basano sul presupposto che chiunque legga questa Guida conosca le seguenti tecnologie:

  • Installazione, configurazione e amministrazione di pacchetti Adobe Experience Manager e AEM.

  • Utilizzo dei sistemi operativi Linux® e Microsoft® Windows.

Prerequisiti prerequisites

Per configurare AEM Assets con Brand Portal, è necessario quanto segue:

  • Un’istanza AEM Assets Author in esecuzione con il Service Pack più recente
  • URL tenant Brand Portal
  • Un utente con privilegi di amministratore di sistema nell’organizzazione IMS del tenant di Brand Portal

Scaricare e installare AEM 6.5

Scarica e installa il Service Pack AEM più recente

Scaricare e installare AEM 6.5 aemquickstart

Per impostare un’istanza Autore AEM, si consiglia di usare AEM 6.5. Se l'AEM non è in funzione, scaricarlo dalle seguenti posizioni:

Dopo aver scaricato l’AEM, per istruzioni su come impostare un’istanza di creazione dell’AEM, consulta distribuzione e manutenzione.

Scarica e installa il Service Pack più recente per AEM servicepack

Per istruzioni dettagliate, vedere la Note sulla versione di AEM 6.5 Service Pack.

Contatta l’Assistenza clienti Adobe se non è possibile trovare il pacchetto AEM o il Service Pack più recente.

Creare la configurazione configure-new-integration-65

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

  1. In AEM Assets, crea un account IMS e genera un certificato pubblico (chiave pubblica).
  2. Nella console Adobe Developer, 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 di servizio e le informazioni sul payload JWT.
  5. In AEM Assets, configura l’account IMS utilizzando le credenziali dell’account di 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.
NOTE
Un’istanza Autore AEM Assets può essere configurata con un solo tenant Brand Portal.

Se stai configurando AEM Assets con Brand Portal per la prima volta, effettua le seguenti operazioni nella sequenza elencata:

Creare la configurazione IMS create-ims-configuration

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

La configurazione IMS prevede due passaggi:

Recuperare il certificato pubblico public-certificate

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

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

  2. Dalla sezione Strumenti Strumenti , passa a Sicurezza > Configurazioni Adobe IMS.

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

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

  5. Seleziona la Crea nuovo certificato e specificare 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 su Scarica chiave pubblica e salvare il file della chiave pubblica (.crt) sul computer.

    La chiave pubblica viene utilizzata in seguito per configurare l’API per il tenant Brand Portal e generare le credenziali dell’account del servizio nella console Adobe Developer.

    Scarica certificato

  8. Fai clic su Avanti.

    In Account , viene creato un account Adobe IMS che richiede le credenziali dell’account del servizio generate nella console di Adobe Developer. Per il momento tieni aperta questa pagina.

    Apri una nuova scheda e creare una connessione dell’account di servizio (JWT) in Adobe Developer Console in modo da poter ottenere le credenziali e il payload JWT per la configurazione dell’account IMS.

Creare la connessione dell’account di servizio (JWT) createnewintegration

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 dell’account di servizio (JWT). Esistono due metodi per configurare l’API: generando una coppia di chiavi (chiavi privata e pubblica) 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 di 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.

Per creare le credenziali dell’account di servizio e il payload JWT, effettua le seguenti operazioni:

  1. Accedi alla console Adobe Developer con i privilegi di amministratore di sistema nell’organizzazione IMS (tenant Brand Portal). L’URL predefinito è https://www.adobe.com/go/devs_console_ui.

    note note
    NOTE
    Accertati di aver selezionato l’organizzazione IMS corretta (tenant Brand Portal) dall’elenco a discesa (organizzazione) nell’angolo in alto a destra.
  2. Clic Crea nuovo progetto. Per l’organizzazione viene creato un progetto vuoto con un nome generato dal sistema.

    Clic Modifica progetto in modo da aggiornare Titolo progetto e Descrizione e fai clic su Salva.

  3. In Panoramica del progetto , fare clic su Aggiungi API.

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

    Assicurati di avere accesso al servizio AEM Brand Portal.

  5. In Configurare API finestra, fai clic su Carica la chiave pubblica. Quindi, fai clic su Seleziona un file e carica la chiave pubblica (file .crt) scaricata in 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 API. Dalla barra di navigazione a sinistra in Credenziali, fare clic su Account di servizio (JWT) opzione.

    note note
    NOTE
    Puoi visualizzare le credenziali ed eseguire azioni quali generare token JWT, copiare i dettagli delle credenziali e recuperare il segreto client.
  9. Dalla sezione Credenziali client , copia il ID client.

    Clic Recupera segreto client e copia segreto client.

    Credenziali account di servizio

  10. Accedi a Genera JWT e copia il Payload JWT informazioni.

Ora puoi 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 create-ims-account-configuration

Verifica di aver già eseguito i seguenti passaggi:

Per configurare l’account IMS:

  1. Apri la configurazione IMS e passa a Account scheda. La pagina è rimasta aperta 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 in Chiave API campo, Segreto client, e Payload (payload JWT) che hai copiato mentre creazione della connessione dell’account di 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.

    Clic Verifica nella finestra di dialogo. Una volta completata la configurazione, viene visualizzato un messaggio che informa che Token recuperato correttamente.

    Finestra di conferma configurazione integra

CAUTION
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. Elimina e crea un’altra configurazione valida.

Configurare il servizio cloud Brand Portal configure-the-cloud-service

  1. Accedi all’istanza Autore di AEM Assets.

  2. Dalla sezione Strumenti Strumenti , passa a Cloud Service > 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 durante configurazione dell’account IMS.

    In URL servizio , specifica l’URL del tenant Brand Portal (organizzazione).

    Finestra Configurazione Brand Portal

  5. Fai clic su Salva e chiudi. Viene creata la configurazione cloud.

    L’istanza Autore AEM Assets è ora configurata con il tenant Brand Portal.

Test e convalida della configurazione test-integration

  1. Accedi all’istanza cloud di AEM Assets.

  2. Dalla sezione Strumenti Strumenti , passa a Distribuzione > Replica.

    Pannello Strumenti

  3. Nella pagina Replica, fai clic su Agenti per creazione.

    Pagina di replica

    Puoi vedere 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.

    Configurazione della replica delle risorse

    note note
    NOTE
    Gli agenti di replica lavorano in parallelo e condividono equamente la distribuzione dei processi, in modo da aumentare la velocità di pubblicazione di quattro volte la velocità originale. Dopo aver configurato il servizio cloud, non è necessaria una 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 Verifica connessione icona.

    Verifica delle impostazioni di replica delle risorse

    Viene visualizzato un messaggio che informa che il pacchetto di prova è stato consegnato correttamente.

    Output di conferma del test

  5. Verifica i risultati del test per tutti e quattro gli agenti di replica.

    note note
    NOTE
    Evita di disabilitare gli agenti di replica, in quanto potrebbe impedire la replica delle risorse (in esecuzione nella coda).
    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.
    Non modificare le impostazioni generate automaticamente.

Ora puoi:

Consulta la Documentazione di Brand Portal per ulteriori informazioni.

Configurazione aggiornamento upgrade-integration-65

Per aggiornare le configurazioni esistenti alla console Adobe Developer, effettua le seguenti operazioni, nella sequenza elencata:

Verificare i processi in esecuzione verify-jobs

Prima di apportare qualsiasi modifica, assicurati che nell’istanza Autore AEM Assets non sia in esecuzione alcun processo di pubblicazione. A tale scopo, è possibile verificare lo stato dei processi attivi su tutti e quattro gli agenti di replica e assicurarsi che le code siano inattive.

  1. Accedi all’istanza Autore di AEM Assets.

  2. Dalla sezione Strumenti Strumenti , passa a Distribuzione > Replica della distribuzione.

  3. Nella pagina Replica, fai clic su Agenti per creazione.

    Agenti di replica per le risorse

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

    Assicurati che La coda è inattiva per tutti gli agenti di replica e nessun processo di pubblicazione è attivo.

    Impostazioni coda di replica

Elimina configurazioni esistenti delete-existing-configuration

Esegui il seguente elenco 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 all’istanza Autore di AEM Assets e apri CRX Lite come amministratore. L’URL predefinito è http://localhost:4502/crx/de/index.jsp.

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

    Agente di replica in CRXDE

  3. Accedi a /etc/cloudservices/mediaportal ed elimina la configurazione del servizio cloud Brand Portal.

    Dettagli dell’agente di replica in CRXDE

  4. Accedi a /home/users/mac ed elimina Utente Mac del tuo tenant Brand Portal.

    Maggiori dettagli dell’agente di replica in CRXDE

Ora puoi creare una configurazione tramite la console Adobe Developer nell’istanza Autore AEM 6.5.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2