Configure AEM Assets as a Cloud Service with Brand Portal

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

Flusso di lavoro di configurazione

AEM Assets come Cloud Service è configurato con Brand Portal tramite Developer Console, che fornisce un token account Adobe Identity Management Services (IMS) per l'autorizzazione del tenant del Brand Portal. 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 di 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 di 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 di 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. From the Tools panel, navigate to Security > Adobe IMS Configurations.

  3. Nella pagina Configurazioni IMS Adobe, fate clic su Crea. It will redirect to the Adobe IMS Technical Account Configuration page. By default, the Certificate tab opens.

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

  5. Selezionate la casella di controllo Crea nuovo certificato e specificate un alias per la chiave pubblica. L'alias funge da nome della chiave pubblica.

  6. Fai clic su Crea certificato. Then, click OK to generate the public key.

    Crea certificato

  7. Fate clic sull'icona Scarica chiave pubblica e salvate il file della 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 , Adobe viene creato un account IMS 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. Click Create new project. Per la vostra organizzazione viene creato un progetto vuoto con un nome generato dal sistema.

    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 la chiave pubblica (file .crt) che avete scaricato nella sezione Ottieni certificato pubblico.

    Fai clic su Avanti.

    Carica chiave pubblica

  6. Verifica la chiave pubblica e fai clic su Avanti.

  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. Nel menu di navigazione a sinistra in Credenziali, fate clic sull'opzione Account 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, copiate l'ID ​client.

    Click Retrieve Client Secret and copy the client secret.

    Credenziali account di servizio

  10. Navigate to the Generate JWT tab and copy the JWT Payload information.

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

  2. Specifica un titolo per l’account IMS.

    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/

    Specificate l'ID client nel campo chiave ​API, Segreto ​cliente e Payload (payload JWT) che avete copiato durante la creazione della connessionedell'account del servizio (JWT).

    Fai clic su Crea.

    L'account IMS è configurato.

    Configurazione dell’account IMS

  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.

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. 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'accountIMS.

    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 di 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. From the Tools panel, navigate to Deployment > Distribution.

    A Brand Portal distribution agent (bpdistributionagent0) is created under Publish to 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, fate clic sull'icona Verifica connessione .

    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:

See Brand Portal documentation for more information.

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. Follow the steps (from 1 to 4) as shown in the Test Configuration section and navigate to the distribution agent page.

  2. Fate 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