Dokumentation AEM Guides Dokumentation om AEM Guides

Konfigurera mikrotjänstbaserad publicering med JWT-autentisering

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Microservice i AEM Guides

Skapat för:

Användare
Administratör

[Cloud Service]{class="badge informative"}

NOTE

JWT-autentiseringsuppgifterna (Service Account) har ersatts med autentiseringsuppgifterna för OAuth Server-till-Server. Dina program som använder JWT-inloggningsuppgifterna (Service Account) slutar fungera efter 1 januari 2025. Du måste migrera till de nya autentiseringsuppgifterna senast 1 januari 2025 för att programmet ska fortsätta fungera. Läs mer om migrering från JWT-autentiseringsuppgifter (Service Account) till autentiseringsuppgifter för OAuth Server-till-Server.

Microservice-baserad publicering i för Adobe Experience Manager Guides as a Cloud Service har stöd för PDF (både Native- och DITA-OT-baserade), HTML5, JSON och CUSTOM-baserade utdatapresentationer.

Eftersom JWT-autentiseringsuppgifterna (Service Account) har tagits bort rekommenderar vi att du använder OAuth-baserad autentisering med Adobe IMS. Lär dig hur du konfigurerar mikrotjänstbaserad publicering med OAuth-autentisering.

För molnpubliceringstjänsten som skyddas av Adobe IMS JWT-baserad autentisering ska kunderna följa stegen nedan för att integrera sina miljöer med Adobe säkra tokenbaserade autentiseringsarbetsflöden och börja använda den nya molnbaserade skalbara publiceringslösningen.

Skapa IMS-konfigurationer i Adobe Developer Console

Roll som krävs för att skapa konversationer: Systemadministratör

Så här skapar du IMS-konfigurationer i Adobe Developer Console:

Öppna Developer Console: https://developer.adobe.com/console.
Växla till fliken Projekt uppifrån.

{width="500"}
Om du vill skapa ett nytt tomt projekt väljer du Tomt projekt i listrutan Skapa nytt projekt .

{width="500"}
Välj API i listrutan Lägg till i projekt om du vill lägga till API för IO-hantering i projektet.

{width="300"} {width="500"}
Skapa ett nytt nyckelpar för privat/offentlig nyckel när du lägger till API:t. Då hämtas den privata nyckeln automatiskt till ditt system.

{width="500"}
Spara det konfigurerade API:t.

{width="600"}
Gå tillbaka till fliken Projekt och klicka på Projektöversikt till vänster.

{width="500"}
Klicka på knappen Hämta överst för att hämta JSON-tjänsten.

{width="500"}

Du har nu konfigurerat informationen om JWT-autentisering och har även hämtat den privata nyckeln och tjänstinformationen JSON. Ha dessa två filer till hands eftersom de behövs i nästa avsnitt.

Lägg till IMS-konfiguration i miljön

Utför följande steg för att lägga till IMS-konfiguration i miljön:

Öppna Experience Manager och välj sedan det program som innehåller den miljö som du vill konfigurera.
Växla till fliken Miljö.
Klicka på det miljönamn som du vill konfigurera. Du bör navigera till sidan Miljöinformation.
Växla till fliken Konfiguration.
Ladda upp den privata nyckeln och projekt-JSON så som visas på skärmbilden nedan. Se till att du använder samma namn och konfiguration som markeras nedan.

{width="500"}

NOTE

Du måste öppna, kopiera och klistra in innehållet i JSON-filen för den privata nyckeln och tjänstinformation i värdekolumnen på konfigurationspanelen enligt skärmbilden ovan.

När du har lagt till IMS-konfigurationen i miljön utför du följande steg för att länka dessa egenskaper till Experience Manager Guides med OSGi:

I Git-projektkoden för din molnhanterare lägger du till följande två filer (för filinnehåll, se Bilaga).
- com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
- com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
Se till att de nyligen tillagda filerna täcks av din filter.xml.
Verkställ och skicka Git-ändringarna.
Kör pipeline för att tillämpa ändringarna på miljön.

När detta är klart bör du kunna använda den nya mikrotjänstbaserade molnpubliceringen.

Vanliga frågor

Kan en enskild nyckel användas i flera molnmiljöer?
- Ja, du kan generera en privat nyckel och använda den för alla miljöer, men du måste konfigurera miljövariabler för alla miljöer och använda samma nyckel.
Om OSGi-konfigurationer som ska använda mikrotjänsten är aktiverade, kommer publiceringsprocessen att fungera på den lokala AEM servern med samma kodbas?
- Nej, om flaggan dxml.use.publish.microservice är inställd på true söker den alltid efter mikrotjänstkonfigurationer. Ange dxml.use.publish.microservice till false för att publiceringen ska fungera på din lokala dator.
Hur mycket minne tilldelas DITA-processen vid användning av mikrotjänstbaserad publicering? Drivs detta via parametrar för DITA-profilant?
- Med mikrotjänstbaserad publicering styrs minnesallokeringen inte av DITA-profilens ant-parametrar. Det totala tillgängliga minnet för tjänstbehållaren är 8 GB, varav 6 GB tilldelas till DITA-OT-processen.

Bilaga appendix

Fil:
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

Innehåll:

{
  "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
  "private.key": "$[secret:PRIVATE_KEY]"
}

Fil: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

Innehåll:

dxml.use.publish.microservice: Växla för att aktivera mikrotjänstbaserad publicering med DITA-OT
dxml.use.publish.microservice.native.pdf: Växla för att aktivera mikrotjänstbaserad Native PDF-publicering

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
          jcr:primaryType="sling:OsgiConfig"
          dxml.publish.microservice.url="https://adobeioruntime.net/api/v1/web/543112-guidespublisher/default/publishercaller.json"
          dxml.use.publish.microservice="{Boolean}true"
          dxml.use.publish.microservice.native.pdf="{Boolean}true"
/>

recommendation-more-help

11125c99-e1a1-4369-b5d7-fb3098b9b178