DocumentationAEM GuidesDocumentation d’AEM Guides

Configuration de la publication sur microservice avec authentification JWT

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

Créé pour :

  • User
  • Admin

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

NOTE
Les informations d’identification du compte de service (JWT), ont été rendues obsolètes au profit des informations d’identification OAuth serveur à serveur. Vos applications utilisant les informations d’identification du compte de service (JWT) cesseront de fonctionner après le 1er janvier 2025. Vous devez migrer vers les nouvelles informations d’identification d’ici le 1er janvier 2025, afin de vous assurer que votre application continue de fonctionner. En savoir plus sur migration des informations d’identification du compte de service (JWT) vers les informations d’identification OAuth serveur à serveur.

La publication basée sur les microservices dans pour Adobe Experience Manager Guides as a Cloud Service prend en charge les types de paramètres prédéfinis de sortie PDF (natif et basé sur DITA-OT), HTML5, JSON et PERSONNALISÉS.

Comme les informations d’identification du compte de service (JWT) ont été abandonnées, il est donc recommandé d’utiliser l’authentification basée sur OAuth d’Adobe IMS. Découvrez comment configuration de la publication sur microservice avec authentification OAuth.

Pour le service de publication cloud sécurisé par l’authentification basée sur JWT Adobe IMS, les clients doivent suivre les étapes ci-dessous pour intégrer leurs environnements aux workflows d’authentification par jeton sécurisés d’Adobe et commencer à utiliser la nouvelle solution de publication évolutive basée sur le cloud.

Création de configurations IMS dans la console Adobe Developer

Rôle requis pour créer les configurations: administrateur système

Effectuez les étapes suivantes pour créer des configurations IMS dans la console Adobe Developer :

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

  2. Basculer vers Projets dans la partie supérieure.

    onglet projets {width="500"}

  3. Pour créer un projet vide, sélectionnez Projet vide de la Créer un projet menu déroulant.

    créer un projet {width="500"}

  4. Sélectionner API de la Ajouter au projet Liste déroulante pour ajouter l’API de gestion des entrées-sorties à votre projet.

    ajouter un projet {width="300"} Gestion des io {width="500"}

  5. Créez une nouvelle paire de clés privée/publique lors de l’ajout de l’API. La clé privée sera alors automatiquement téléchargée sur votre système.

    générer une paire de clés {width="500"}

  6. Enregistrez l’API configurée.

    save api {width="600"}

  7. Revenir à Projets et cliquez sur Présentation du projet sur la gauche.

    présentation du projet {width="500"}

  8. Cliquez sur Télécharger sur la partie supérieure pour télécharger le service JSON.

    télécharger json {width="500"}

Vous avez maintenant configuré les détails de l’authentification JWT et téléchargé également la clé privée et les détails du service JSON. Conservez ces deux fichiers à portée de main, car ces fichiers sont requis dans la section suivante.

Ajout de la configuration IMS à l’environnement

Effectuez les étapes suivantes pour ajouter la configuration IMS à l’environnement :

  1. Ouvrez le gestionnaire d’expériences, puis sélectionnez le programme contenant l’environnement que vous souhaitez configurer.

  2. Basculer vers Environnements .

  3. Cliquez sur le nom de l’environnement que vous souhaitez configurer. Cela vous permet d’accéder à la page Informations sur l’environnement .

  4. Basculer vers Configuration .

  5. Téléchargez la clé privée et le fichier JSON du projet, comme illustré dans la capture d’écran ci-dessous. Veillez à utiliser les mêmes noms et configuration que ceux présentés ci-dessous.

    configurations ims {width="500"}

NOTE
Vous devez ouvrir, copier et coller le contenu du fichier JSON des détails de clé privée et de service dans la colonne des valeurs du panneau Configuration, comme illustré dans la capture d’écran ci-dessus.

Une fois que vous avez ajouté la configuration IMS à l’environnement, procédez comme suit pour lier ces propriétés à des guides du Experience Manager à l’aide d’OSGi :

  1. Dans le code de projet Git de Cloud Manager, ajoutez les deux fichiers ci-dessous (pour le contenu du fichier, voir Annexe).

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

  2. Assurez-vous que les fichiers nouvellement ajoutés sont couverts par votre filter.xml.

  3. Validez et poussez vos modifications Git.

  4. Exécutez le pipeline pour appliquer les modifications à l’environnement.

Une fois cela fait, vous devriez pouvoir utiliser la nouvelle publication cloud basée sur un microservice.

FAQ

  1. Une seule clé peut-elle être utilisée dans plusieurs environnements cloud ?
    • Oui, vous pouvez générer une clé privée et l’utiliser pour tous les environnements, mais vous devez configurer des variables d’environnement pour tous les environnements et utiliser la même clé.
  2. Si les configurations OSGi pour utiliser le microservice sont activées , le processus de publication fonctionnera-t-il sur le serveur d’AEM local avec la même base de code ?
    • Non, si l’indicateur dxml.use.publish.microservice est défini sur true puis il recherche toujours des configurations de microservice. Définir dxml.use.publish.microservice to false pour que la publication fonctionne sur votre site local.
  3. Quelle quantité de mémoire est allouée au processus DITA lors de l’utilisation de la publication basée sur un microservice ? Est-ce piloté par les paramètres de fourmi de profil DITA ?
    • Avec la publication basée sur un microservice, l’allocation de mémoire n’est pas pilotée par les paramètres de fourmi de profil DITA. La mémoire totale disponible sur le conteneur de services est de 8 Go, dont 6 Go sont affectés au processus DITA-OT.

Annexe appendix

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

Contenu:

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

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

Contenu:

  • dxml.use.publish.microservice: basculez pour activer la publication basée sur un microservice à l’aide de DITA-OT
  • dxml.use.publish.microservice.native.pdf: basculez pour activer la publication de PDF natifs en fonction du microservice.
<?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