AEM Assets configureren met Brand Portal

Versie Artikelkoppeling
AEM as a Cloud Service Klik hier
AEM 6,5 Dit artikel

Met Adobe Experience Manager Assets Brand Portal kunt u goedgekeurde merkmiddelen van Adobe Experience Manager Assets naar Brand Portal publiceren en deze aan Brand Portal-gebruikers distribueren.

AEM Assets is geconfigureerd met Brand Portal via Adobe Developer Console, die een Adobe Identity Management Services (IMS)-accounttoken aanschaft voor toestemming van de Brand Portal-huurder.

OPMERKING

Het configureren van AEM Assets met Brand Portal via Adobe Developer Console wordt ondersteund op AEM 6.5.4.0 en hoger.

Eerder, werd Brand Portal gevormd via erfenis OAuth Gateway, die JSON Web Token (JWT) uitwisseling gebruikt om een token van de Toegang te verkrijgen IMS voor vergunning.

Configuratie via verouderde OAuth Gateway wordt vanaf 6 april 2020 niet meer ondersteund en wordt gewijzigd in Adobe Developer Console.

TIP

Alleen voor bestaande klanten

Het wordt geadviseerd om de bestaande oudere configuratie van de Gateway te blijven gebruiken OAuth. In het geval, ontmoet u problemen met erfenisOAuth configuratie van de Gateway, schrapt de bestaande configuratie en creeert nieuwe configuratie via de Console van Adobe Developer.

In deze Help worden de volgende twee gebruiksgevallen beschreven:

  • Nieuwe configuratie: Als u een nieuwe Brand Portal-gebruiker bent en uw AEM Assets-auteurinstantie met Brand Portal wilt configureren, kunt u configuratie maken via Adobe Developer Console.
  • Upgradeconfiguratie: Als u een bestaande Brand Portal-gebruiker bent die configuratie heeft op een verouderde OAuth Gateway, verwijdert u de bestaande configuratie en maakt u een nieuwe configuratie via Adobe Developer Console.

De verstrekte informatie is gebaseerd op de veronderstelling dat iedereen die deze Hulp leest met de volgende technologieën vertrouwd is:

  • Adobe Experience Manager- en AEM-pakketten installeren, configureren en beheren.

  • Linux- en Microsoft Windows-besturingssystemen gebruiken.

Vereisten

U hebt het volgende nodig om AEM Assets te configureren met Brand Portal:

  • Een AEM Assets-auteur-exemplaar met de nieuwste Service Pack
  • URL Brand Portal-gebruiker
  • Een gebruiker met systeembeheerdersbevoegdheden op de IMS-organisatie van de Brand Portal-tenant

Download en installeer AEM 6.5

Download en installeer de nieuwste AEM Service Pack

Download en installeer AEM 6.5

Het wordt aanbevolen om AEM 6.5 te hebben om een AEM instantie van de auteur in te stellen. Als u niet AEM, download het van de volgende plaatsen:

Nadat u AEM hebt gedownload, vindt u instructies voor het instellen van een AEM instantie van de auteur implementeren en onderhouden.

Download en installeer AEM nieuwste Service Pack

Zie voor gedetailleerde instructies

Contact opnemen met ondersteuning als u het nieuwste AEM pakket of Service Pack niet kunt vinden.

Configuratie maken

Voor het configureren van AEM Assets met Brand Portal zijn configuraties vereist in zowel de AEM Assets-auteurinstantie als de Adobe Developer Console.

  1. In AEM Assets maakt u een IMS-account en genereert u een openbaar certificaat (openbare sleutel).
  2. Maak in Adobe Developer Console een project voor uw Brand Portal-huurder (organisatie).
  3. Onder het project, vorm API gebruikend de openbare sleutel om een verbinding van de de dienstrekening (JWT) tot stand te brengen.
  4. Krijg de geloofsbrieven van de de dienstrekening en JWT payload informatie.
  5. In AEM Assets configureert u de IMS-account met de gegevens van de serviceaccount en de JWT-payload.
  6. In AEM Assets configureert u de Brand Portal-cloudservice met behulp van het IMS-account en het Brand Portal-eindpunt (organisatie-URL).
  7. Test uw configuratie door middelen van AEM Assets aan Brand Portal te publiceren.
OPMERKING

Een AEM Assets-auteur-instantie mag slechts met één Brand Portal-huurder worden geconfigureerd.

Voer de volgende stappen in de vermelde reeks uit als u AEM Assets voor het eerst met Brand Portal configureert:

  1. Openbaar certificaat verkrijgen
  2. Verbinding voor serviceaccount (JWT) maken
  3. IMS-account configureren
  4. Cloudservice configureren
  5. Configuratie testen

IMS-configuratie maken

De configuratie IMS verifieert uw AEM Assets auteurinstantie met de huurder van Brand Portal.

De IMS-configuratie omvat twee stappen:

Openbaar certificaat verkrijgen

Met de openbare sleutel (certificaat) wordt uw profiel geverifieerd op Adobe Developer Console.

  1. Meld u aan bij de AEM Assets-auteur. De standaard-URL is http://localhost:4502/aem/start.html.

  2. Van de Gereedschappen Gereedschappen deelvenster, navigeren naar Security > Adobe IMS Configurations.

  3. Klik op de pagina Adobe IMS Configurations op Create. Het zal worden omgeleid naar de Adobe IMS Technical Account Configuration pagina. Standaard worden de Certificaat wordt geopend.

  4. Selecteren Adobe Brand Portal in de Cloud Solution vervolgkeuzelijst.

  5. Selecteer Create new certificate selectievakje en geef een alias voor de openbare sleutel. De alias fungeert als naam voor de openbare sleutel.

  6. Klik op Create certificate. Klik vervolgens op OK om de openbare sleutel te produceren.

    Create Certificate

  7. Klik op de knop Download Public Key en sla het bestand met de openbare sleutel (.crt) op uw computer op.

    De openbare sleutel zal later worden gebruikt om API voor uw Brand Portal huurder te vormen en de geloofsbrieven van de de dienstrekening in de Console van Adobe Developer te produceren.

    Download Certificate

  8. Klik op Next.

    In de Account wordt een Adobe IMS-account gemaakt waarvoor de referenties van de serviceaccount zijn vereist die in Adobe Developer Console worden gegenereerd. Laat deze pagina voorlopig open.

    Open een nieuw tabblad en een JWT-verbinding (Service Account) maken in Adobe Developer Console om de referenties en JWT-lading op te halen voor het configureren van de IMS-account.

Verbinding voor serviceaccount (JWT) maken

In de Console van Adobe Developer, worden de projecten en APIs gevormd op het niveau van de huurder van Brand Portal (organisatie). Als u een API configureert, wordt een JWT-verbinding (Service Account) gemaakt. Er zijn twee methodes om API te vormen, door een zeer belangrijk paar (privé en openbare sleutels) te produceren of door een openbare sleutel te uploaden. Als u AEM Assets wilt configureren met Brand Portal, moet u een openbare sleutel (certificaat) genereren in AEM Assets en referenties maken in Adobe Developer Console door de openbare sleutel te uploaden. Deze gegevens zijn vereist om de IMS-account in AEM Assets te configureren. Zodra de IMS-account is geconfigureerd, kunt u de Brand Portal-cloudservice in AEM Assets configureren.

Voer de volgende stappen uit om de geloofsbrieven van de de dienstrekening en lading van JWT te produceren:

  1. Meld u aan bij Adobe Developer Console met systeembeheerdersrechten voor de IMS-organisatie (Brand Portal-huurder). De standaard-URL is https://www.adobe.com/go/devs_console_ui.

    OPMERKING

    Zorg ervoor dat u de juiste IMS-organisatie (Brand Portal-huurder) hebt geselecteerd in de vervolgkeuzelijst (organisatie) in de rechterbovenhoek.

  2. Klik op Create new project. Er wordt een leeg project met een door het systeem gegenereerde naam gemaakt voor uw organisatie.

    Klikken Edit project om de Project Title en Description en klik op Save.

  3. In de Project overview tabblad, klikt u op Add API.

  4. In de Add an API window, selecteert u AEM Brand Portal en klik op Next.

    Zorg ervoor dat u toegang hebt tot de AEM Brand Portal-service.

  5. In de Configure API venster, klikt u op Upload your public key. Klik vervolgens op Select a File en uploadt u de openbare sleutel (.crt-bestand) die u in het dialoogvenster openbare verklaring verkrijgen sectie.

    Klik op Next.

    Openbare sleutel uploaden

  6. De openbare sleutel controleren en klikken Next.

  7. Selecteren Assets Brand Portal als het standaardproductprofiel en klik op Save configured API.

    Productprofiel selecteren

  8. Nadat de API is geconfigureerd, wordt u omgeleid naar de API-overzichtspagina. Vanaf de linkernavigatie onder Credentials, klikt u op de knop Service Account (JWT) optie.

    OPMERKING

    U kunt de geloofsbrieven bekijken en acties uitvoeren zoals produceren JWT tokens, exemplaar credentiedetails, terugwinnen cliëntgeheim, etc.

  9. Van de Client Credentials kopiëren client ID.

    Klikken Retrieve Client Secret en kopieert u de client secret.

    Servicerekeningen

  10. Ga naar de Generate JWT en kopieer de JWT Payload informatie.

U kunt nu de client-id (API-sleutel), het clientgeheim en de JWT-payload gebruiken naar IMS-account configureren in AEM Assets.

IMS-account configureren

Controleer of u de volgende stappen hebt uitgevoerd:

Voer de volgende stappen uit om de IMS-account te configureren.

  1. Open de IMS-configuratie en navigeer naar de Account tab. U hebt de pagina geopend gehouden terwijl verkrijgen van het openbare certificaat.

  2. Geef een Title op voor het IMS-account.

    In de Authorization Server -veld, geeft u de URL op: https://ims-na1.adobelogin.com/.

    Client-id opgeven in het dialoogvenster API key veld, Client Secret, en Payload (JWT-lading) die u hebt gekopieerd terwijl maken van de verbinding van de serviceaccount (JWT).

    Klik op Create.

    De IMS-account is geconfigureerd.

    IMS Account configuration

  3. Selecteer de IMS-accountconfiguratie en klik op Check Health.

    Klikken Check in het dialoogvenster. Bij een geslaagde configuratie verschijnt het bericht dat de Token is opgehaald.

LET OP

U kunt slechts één IMS-configuratie hebben.

Zorg ervoor dat de IMS-configuratie slaagt voor de statuscontrole. Als de configuratie niet slaagt voor de statuscontrole, is deze ongeldig. U moet deze dan verwijderen en een nieuwe, geldige configuratie maken.

Cloudservice configureren

Voer de volgende stappen uit om de Brand Portal-cloudservice te configureren:

  1. Meld u aan bij de AEM Assets-auteur.

  2. Van de Gereedschappen Gereedschappen deelvenster, navigeren naar Cloud Services > AEM Brand Portal.

  3. Klik op de pagina Brand Portal Configurations op Create.

  4. Geef een Title op voor de configuratie.

    Selecteer de IMS-configuratie die u hebt gemaakt terwijl u configureren van IMS-account.

    In de Service URL -veld, geeft u de URL van uw Brand Portal-huurder (organisatie) op.

  5. Klik op Save & Close. De cloudconfiguratie wordt gemaakt.

    Uw AEM Assets-auteurinstantie is nu geconfigureerd met de Brand Portal-huurder.

Configuratie testen

Voer de volgende stappen uit om de configuratie te valideren:

  1. Meld u aan bij uw AEM Assets-cloudinstantie.

  2. Van de Gereedschappen Gereedschappen deelvenster, navigeren naar Deployment > Replication.

  3. Klik op de pagina Replicatie op Agents on author.

    U kunt de vier replicatieagenten zien die voor uw huurder van Brand Portal worden gecreeerd.

    Bepaal de plaats van de replicatieagenten van uw Brand Portal huurder en klik op de replicatieagent URL.

    OPMERKING

    De replicatieagenten werken parallel en delen de baandistributie gelijk, daardoor verhogend de het publiceren snelheid met vier keer de originele snelheid. Nadat de wolkendienst wordt gevormd, wordt de extra configuratie niet vereist om de replicatieagenten toe te laten die door gebrek worden geactiveerd om parallelle publicatie van veelvoudige activa toe te laten.

  4. Als u de verbinding tussen AEM Assets en Brand Portal wilt controleren, klikt u op de knop Test Connection pictogram.

    Er verschijnt een bericht dat uw testpakket is afgeleverd.

  5. Verifieer de testresultaten op alle vier replicatieagenten.

    OPMERKING

    Vermijd onbruikbaar makend om het even welke replicatieagenten, aangezien het de replicatie van de activa (in werking stellen-in-rij) kan veroorzaken om te ontbreken.

    Zorg ervoor dat alle vier replicatieagenten worden gevormd om onderbrekingsfout te vermijden. Zie Problemen met parallelle publicatie naar Brand Portal oplossen.

    Wijzig geen automatisch gegenereerde instellingen.

U kunt nu het volgende doen:

Zie Brand Portal-documentatie voor meer informatie .

Upgradeconfiguratie

Voer de volgende stappen in de vermelde reeks uit om uw bestaande configuraties bij te werken naar Adobe Developer Console:

  1. Werken met taken controleren
  2. Bestaande configuraties verwijderen
  3. Configuratie maken

Werken met taken controleren

Zorg ervoor dat er geen publicatietaak wordt uitgevoerd op de AEM Assets-ontwerpinstantie voordat u wijzigingen aanbrengt. Voor dat, kunt u het statuut van actieve banen op alle vier replicatieagenten verifiëren en ervoor zorgen dat de rijen nutteloos zijn.

  1. Meld u aan bij de AEM Assets-auteur.

  2. Van de Gereedschappen Gereedschappen deelvenster, navigeren naar Deployment > Deployment Replication.

  3. Klik op de pagina Replicatie op Agents on author.

  4. Bepaal de plaats van de replicatieagenten van uw huurder van Brand Portal.

    Zorg ervoor dat de Wachtrij is inactief voor alle replicatieagenten, is geen het publiceren baan actief.

Bestaande configuraties verwijderen

U moet de volgende controlelijst in werking stellen terwijl het schrappen van de bestaande configuraties:

  • Alle vier replicatieagents verwijderen
  • Brand Portal-cloudservice verwijderen
  • MAC-gebruiker verwijderen
  1. Meld u aan bij de AEM Assets-auteur en open CRX Lite als beheerder. De standaard-URL is http://localhost:4502/crx/de/index.jsp.

  2. Navigeren naar /etc/replications/agents.author en schrapt alle vier replicatieagenten van uw Brand Portal huurder.

  3. Navigeren naar /etc/cloudservices/mediaportal en verwijder de configuratie van de Brand Portal-cloudservice.

  4. Navigeren naar /home/users/mac en de Mac-gebruiker van je Brand Portal-huurder.

U kunt nu configuratie maken via Adobe Developer Console op uw AEM 6.5-auteurexemplaar.

Op deze pagina