Configure microservice-based publishing with JWT authentication

Last update: April 22, 2024

CREATED FOR:

  • User
  • Admin

Cloud Service

NOTE
The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jan 1, 2025. You must migrate to the new credential by Jan 1, 2025, to ensure your application continues functioning. Learn more about migrating from Service Account (JWT) credential to OAuth Server-to-Server credential.

Microservice-based publishing in for Adobe Experience Manager Guides as a Cloud Service supports PDF (both Native and DITA-OT based), HTML5, JSON, and CUSTOM types of output presets.

As the Service Account (JWT) credentials have been deprecated, so it is recommended to use Adobe IMS OAuth-based authentication. Learn how to configure microservice-based publishing with OAuth authentication.

For the cloud publishing service secured by Adobe IMS JWT based authentication, customers should follow the below given steps to integrate their environments with Adobe’s secure token-based authentication workflows and start using the new cloud based scalable publishing solution.

Create IMS configurations in Adobe Developer Console

Role required to create the confugrations: System Administrator

Perform the following steps to create IMS configurations in Adobe Developer Console:

  1. Open Developer Console: https://developer.adobe.com/console.

  2. Switch to Projects tab from top.

    projects tab

  3. To create a new empty project, select Empty project from the Create new project dropdown.

    create new project

  4. Select API from the Add to Project dropdown to add IO Management API to your project.

    add project

    io management

  5. Create a new private/public key pair while adding the API. This will automatically download the private key on your system.

    generate key pair

  6. Save the configured API.

    save api

  7. Go back to Projects tab and click Project overview on the left.

    project overview

  8. Click Download button on the top to download the service JSON.

    download json

You have now configured the JWT authentication details and have also downloaded the private key and the service details JSON. Keep these two files handy as these files are required in the next section.

Add IMS configuration to the environment

Perform the following steps to add IMS configuration to the environment:

  1. Open experience manager and then select your program which contains the environment you want to configure.

  2. Switch to Environments tab.

  3. Click on the environment name which you want to configure. This should navigate you to the Environment Information page.

  4. Switch to Configuration tab.

  5. Upload the private key and project JSON as shown in the screenshot below. Make sure you are using the same names and configuration as highlighted below.

    ims configurations

NOTE
You need to open, copy, and paste the contents of private key and service details JSON file to the value column of the Configuration panel as shown in the above screenshot.

Once you have added the IMS configuration to the environment, perform the following steps to link these properties with Experience Manager Guides using OSGi:

  1. In you cloud manager Git project code, add the below given two files (For file contents, see Appendix).

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

  2. Ensure that the newly added files are getting covered by your filter.xml.

  3. Commit and push your Git changes.

  4. Run the pipeline to apply the changes on the environment.

Once this is done, you should be able to use the new microservice-based cloud publishing.