DocumentatieAEM GuidesDocumentatie voor AEM Guides

Op microservice gebaseerde publicaties configureren met JWT-verificatie

Last update: Wed Apr 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • User
  • Admin

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

NOTE
De geloofsbrieven van de Rekening van de Dienst (JWT) zijn afgekeurd ten gunste van de geloofsbrieven van de Server-aan-Server OAuth. Uw toepassingen die gebruikmaken van de JWT-referenties (Service Account) werken niet meer na 1 januari 2025. U moet vóór 1 januari 2025 naar de nieuwe referentie migreren om ervoor te zorgen dat uw toepassing blijft werken. Meer informatie over migreren van de credentie van de Rekening van de Dienst (JWT) aan OAuth server-aan-Server referentie.

Op microservice gebaseerde publicaties in Adobe Experience Manager Guides as a Cloud Service ondersteunen de typen PDF (zowel op basis van Native als van DITA-OT), HTML5, JSON en CUSTOM van voorinstellingen voor uitvoer.

Aangezien de JWT-gegevens (Service Account) zijn afgekeurd, wordt het aanbevolen om op Adobe IMS gebaseerde verificatie te gebruiken. Leer hoe u op microservice gebaseerde publicaties configureren met OAuth-verificatie.

Voor de service voor publicatie in de cloud die wordt beveiligd door verificatie op basis van Adobe IMS JWT, moeten klanten onderstaande stappen volgen om hun omgevingen te integreren met beveiligde tokengebaseerde verificatieworkflows van de Adobe en de nieuwe, op de cloud gebaseerde schaalbare publicatieoplossing te gaan gebruiken.

IMS-configuraties maken in Adobe Developer Console

Rol vereist om de conflicten tot stand te brengen: Systeembeheerder

Voer de volgende stappen uit om IMS-configuraties te maken in Adobe Developer Console:

  1. Ontwikkelaarsconsole openen: https://developer.adobe.com/console.

  2. Overschakelen op Projecten van boven.

    tabblad Projecten {width="500"}

  3. Als u een nieuw, leeg project wilt maken, selecteert u Leeg project van de Nieuw project maken vervolgkeuzelijst.

    nieuw project maken {width="500"}

  4. Selecteren API van de Toevoegen aan project vervolgkeuzelijst om IO Management API aan uw project toe te voegen.

    project toevoegen {width="300"} io-beheer {width="500"}

  5. Maak een nieuw paar met een persoonlijke of openbare sleutel terwijl u de API toevoegt. De persoonlijke sleutel wordt dan automatisch naar uw systeem gedownload.

    sleutelpaar genereren {width="500"}

  6. Sla de geconfigureerde API op.

    api opslaan {width="600"}

  7. Ga terug naar Projecten en klik op Overzicht van project links.

    projectoverzicht {width="500"}

  8. Klikken Downloaden bovenaan om de service JSON te downloaden.

    download json {width="500"}

U hebt nu de JWT-verificatiegegevens geconfigureerd en ook de persoonlijke sleutel en de servicedetails JSON gedownload. Houd deze twee bestanden bij de hand, aangezien deze bestanden in de volgende sectie zijn vereist.

IMS-configuratie toevoegen aan de omgeving

Voer de volgende stappen uit om configuratie IMS aan het milieu toe te voegen:

  1. Open Experience Manager en selecteer vervolgens uw programma met de omgeving die u wilt configureren.

  2. Overschakelen op Omgevingen tab.

  3. Klik op de naam van de omgeving die u wilt configureren. Hiermee navigeert u naar de pagina Informatie over omgeving.

  4. Overschakelen op Configuratie tab.

  5. Upload de persoonlijke sleutel en het project JSON zoals hieronder in het schermafbeelding wordt getoond. Zorg ervoor u de zelfde namen en configuratie gebruikt zoals hieronder benadrukt.

    ims-configuraties {width="500"}

NOTE
U moet de inhoud van het JSON-bestand met persoonlijke sleutel en servicedetails openen, kopiëren en in de waardekolom van het deelvenster Configuratie plakken, zoals in de bovenstaande schermafbeelding wordt getoond.

Zodra u de configuratie IMS aan het milieu hebt toegevoegd, voer de volgende stappen uit om deze eigenschappen met de Gidsen van de Experience Manager te verbinden gebruikend OSGi:

  1. Voeg de onderstaande twee bestanden toe in uw Git-projectcode voor cloudbeheer (zie voor de bestandsinhoud) Bijlage).

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

  2. Zorg ervoor dat de toegevoegde bestanden worden gedekt door uw filter.xml.

  3. Leg de Git-wijzigingen vast en duw erop.

  4. Voer de pijpleiding in om de veranderingen op het milieu toe te passen.

Zodra dit wordt gedaan, zou u de nieuwe op microservice-gebaseerde wolkenpublicatie moeten kunnen gebruiken.

Veelgestelde vragen

  1. Kan één sleutel worden gebruikt op veelvoudige wolkenmilieu's?
    • Ja, u kunt één privé sleutel produceren en het voor alle milieu's gebruiken, maar u moet milieuvariabelen voor alle milieu's vormen en de zelfde sleutel gebruiken.
  2. Als de configuraties OSGi om microservice te gebruiken worden toegelaten, zal het het publiceren proces op lokale AEM server met de zelfde codebase werken?
    • Neen, indien de markering dxml.use.publish.microservice is ingesteld op true dan zoekt het altijd microservice configuraties. Set dxml.use.publish.microservice tot false zodat de uitgever op uw lokale computer kan werken.
  3. Hoeveel geheugen wordt toegewezen aan het proces DITA wanneer het gebruiken van op microservice-gebaseerde het publiceren? Wordt dit aangestuurd via parameters van het DITA-profiel?
    • Bij publicatie op basis van microservices wordt geheugentoewijzing niet aangestuurd door parameters van het type DITA-profiel. Het totale beschikbare geheugen op de de dienstcontainer is 8 GB, waarvan 6 GB aan het DITA-OT proces wordt toegewezen.

Bijlage appendix

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

Inhoud:

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

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

Inhoud:

  • dxml.use.publish.microservice: Schakel over om op microservice gebaseerde publicatie met DITA-OT in te schakelen
  • dxml.use.publish.microservice.native.pdf: Schakel over om op microservice gebaseerde Native PDF-publicatie in te schakelen
<?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