Configurare AEM Assets come Cloud Service con Portale marchio

La configurazione di Adobe Experience Manager Assets Brand Portal consente di pubblicare risorse del marchio approvate da Adobe Experience Manager Assets come istanza Cloud Service in Brand Portal e distribuirle agli utenti del Brand Portal.

Flusso di lavoro di configurazione

AEM Assets come Cloud Service è configurato con Portale marchio tramite Developer Console, che fornisce un token account Adobe Identity Management Services (IMS) per l'autorizzazione del tenant del Portale marchio. Richiede configurazioni sia in AEM Assets che Adobe Developer Console.

  1. In AEM Assets, create un account IMS e generate una chiave pubblica (certificato).
  2. In Adobe Developer Console, crea un progetto per il tenant del Brand Portal (organizzazione).
  3. In questo progetto, configura un'API utilizzando la chiave pubblica per creare una connessione a un account di servizio.
  4. Ottenete le credenziali dell'account del servizio e le informazioni sul payload JSON Web Token (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.
NOTA

Un AEM Assets come istanza Cloud Service può essere configurato solo con un tenant Brand Portal.

Prerequisiti

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

  • Un AEM Assets funzionante come istanza Cloud Service
  • URL tenant del Brand Portal
  • Un utente con privilegi di amministratore di sistema nell’organizzazione IMS del tenant di Brand Portal

Creare la configurazione

Effettuate i seguenti passaggi nella sequenza specificata per configurare AEM Assets con Brand Portal.

  1. Recuperare il certificato pubblico
  2. Creare una 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'AEM Assets come istanza Cloud Service con il tenant del Brand Portal.

La configurazione IMS prevede due passaggi:

Recuperare il certificato pubblico

La chiave pubblica (certificato) autentica il tuo profilo in Adobe Developer Console.

  1. Effettuate l'accesso a AEM Assets.

  2. Dal pannello Strumenti, andate a Sicurezza > Configurazioni IMS Adobe.

  3. Nella pagina Configurazioni IMS Adobe, fare clic su Crea. Verrà reindirizzato alla pagina Adobe IMS Technical Account Configuration. Per impostazione predefinita, viene visualizzata la scheda Certificate.

  4. Selezionare Portale marchio Adobe nell'elenco a discesa Cloud Solution.

  5. Selezionare la casella di controllo 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, fare clic su OK per generare la chiave pubblica.

    Crea certificato

  7. Fare clic sull'icona Scarica chiave pubblica e salvare il file di chiave pubblica (CRT) sul computer.

    La chiave pubblica verrà utilizzata in seguito per configurare l'API per il tenant del Brand Portal e generare le credenziali dell'account di servizio in Adobe Developer Console.

    Scarica certificato

  8. Fai clic su Avanti.

    Nella scheda Account viene creato account IMS del Adobe che richiede le credenziali dell'account del 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 JWT (Service Account). 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 una chiave pubblica (certificato) in AEM Assets e creare le credenziali in console Sviluppatore Adobe caricando la chiave pubblica. Queste credenziali sono necessarie 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 è https://www.adobe.com/go/devs_console_ui.

    NOTA

    Accertatevi di aver selezionato l'organizzazione IMS corretta (tenant Brand Portal) dall'elenco a discesa (organizzazione) nell'angolo superiore destro.

  2. Fare clic su Crea nuovo progetto. Per la vostra organizzazione viene creato un progetto vuoto con un nome generato dal sistema.

    Fare clic su Modifica progetto per aggiornare il Titolo progetto e Descrizione, quindi fare clic su Salva.

  3. Nella scheda Panoramica progetto, fare clic su Aggiungi API.

  4. Nella Aggiungi una finestra API, selezionare AEM Brand Portal e fare clic su Next.

    Assicuratevi di avere accesso al servizio AEM Brand Portal.

  5. Nella finestra Configura API, fare clic su Carica la chiave pubblica. Quindi, fare clic su Selezionare un file e caricare la chiave pubblica (.crt file) scaricata nella sezione ottenere il certificato pubblico.

    Fai clic su Avanti.

    Carica chiave pubblica

  6. Verificare la chiave pubblica e fare clic su Next.

  7. Selezionate Assets Brand Portal come profilo di prodotto predefinito, quindi fate clic su Salva API configurata.

    Seleziona profilo di prodotto

  8. Una volta configurata l'API, verrete reindirizzati alla pagina di panoramica dell'API. Dalla navigazione a sinistra in Credenziali, fare clic sull'opzione Account di servizio (JWT).

    NOTA

    Potete visualizzare le credenziali ed eseguire azioni quali generare token JWT, copiare i dettagli delle credenziali, recuperare il segreto client e così via.

  9. Dalla scheda Credenziali client, copiare l' ID client.

    Fare clic su Recupera Segreto cliente e copiare il segreto client.

    Credenziali account di servizio

  10. Passare alla scheda Genera JWT e copiare le informazioni relative al payload JWT.

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

Verifica di aver eseguito i seguenti passaggi:

Effettuate le seguenti operazioni per configurare l'account IMS.

  1. Aprite IMS Configuration e passate alla scheda Account. La pagina è rimasta aperta durante il recupero del certificato pubblico.

  2. Specifica un titolo per l’account IMS.

    Nel campo Server di autorizzazione, specificate l'URL: https://ims-na1.adobelogin.com/

    Specificate l'ID client nel campo Chiave API, Segreto client e Payload (payload JWT) che avete copiato durante la creazione della connessione dell'account del servizio (JWT)](#createnewintegration).[

    Fai clic su Crea.

    L'account IMS è configurato.

    Configurazione dell’account IMS

  3. Selezionate la configurazione dell'account IMS e fate clic su Verifica stato.

    Fare clic su Check nella finestra di dialogo. In caso di configurazione corretta, viene visualizzato un messaggio che informa che il Token viene recuperato correttamente.

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

Per configurare il servizio cloud Brand Portal, effettuate le seguenti operazioni:

  1. Effettuate l'accesso a AEM Assets.

  2. Dal pannello Strumenti, andate a Cloud Services > AEM Brand Portal.

  3. Nella pagina Configurazioni Brand Portal, fate clic su Crea.

  4. Specifica un titolo per la configurazione.

    Selezionare la configurazione IMS creata durante la configurazione dell'account IMS.

    Nel campo URL servizio, specificate l'URL tenant (organizzazione) del Portale marchio.

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

    L'AEM Assets come istanza Cloud Service ora è configurato con il tenant del Brand Portal.

Verificare la configurazione

Effettuate le seguenti operazioni per convalidare la configurazione:

  1. Effettuate l'accesso a AEM Assets.

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

    Un agente di distribuzione Brand Portal (bpdistributionagent0) viene creato in Pubblica su Brand Portal.

  3. Fate clic su Pubblica su Brand Portal per aprire l'agente di distribuzione.

    Potete visualizzare le code di distribuzione nella scheda Stato.

    Un agente di distribuzione contiene due code:

    • Coda di elaborazione: per la distribuzione delle risorse in Brand Portal.

    • Coda di errore: per le risorse per le quali la distribuzione non è riuscita.

    NOTA

    È consigliabile esaminare gli errori e cancellare periodicamente la coda di errore.

  4. Per verificare la connessione tra AEM Assets come Cloud Service e Brand Portal, fare clic sull'icona Test Connection.

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

    NOTA

    Evita di disabilitare l’agente di distribuzione, in quanto potrebbe impedire la corretta distribuzione delle risorse (in esecuzione nella coda).

Ora puoi:

Per ulteriori informazioni, consultate la documentazione del Portale del marchio.

Registri di distribuzione

Potete monitorare i registri degli agenti di distribuzione per il flusso di lavoro di pubblicazione delle risorse.

Ad esempio, è stata pubblicata una risorsa da AEM Assets al Portale del marchio per convalidare la configurazione.

  1. Seguire i passaggi (da 1 a 4) come mostrato nella sezione Configurazione di prova e passare alla pagina agente di distribuzione.

  2. Fare clic su Registri per visualizzare i registri di elaborazione e di errore.

L'agente di distribuzione ha generato i seguenti registri:

  • INFORMAZIONI: Si tratta di un registro generato dal sistema che attiva la configurazione corretta dell'agente di distribuzione.
  • DSTRQ1 (richiesta 1): si attiva durante la prova della connessione.

Quando viene pubblicata la risorsa, vengono generati i seguenti registri di richieste e risposte:

Richiesta dell’agente di distribuzione:

  • DSTRQ2 (richiesta 2): viene attivata la richiesta di pubblicazione della risorsa.
  • DSTRQ3 (richiesta 3): Il sistema attiva un’altra richiesta per pubblicare la cartella AEM Assets (in cui esiste la risorsa) e replicare la cartella in Brand Portal.

Risposta dell’agente di distribuzione:

  • queue-bpdistributionagent0 (DSTRQ2): la risorsa viene pubblicata su Brand Portal.
  • queue-bpdistributionagent0 (DSTRQ3): Il sistema replica la cartella AEM Assets (contenente la risorsa) in Brand Portal.

Nell’esempio precedente, viene attivata un’ulteriore combinazione di richiesta e risposta. Impossibile trovare la cartella principale (Aggiungi percorso) nel Portale marchio perché la risorsa è stata pubblicata per la prima volta. Pertanto, è stata attivata un'ulteriore richiesta per creare una cartella principale con lo stesso nome in Portale marchio in cui la risorsa viene pubblicata.

NOTA

La richiesta aggiuntiva viene generata nel caso in cui la cartella principale non esista nel Brand Portal o sia stata modificata in AEM Assets.

In questa pagina