Configuration de la publication sur microservice avec authentification JWT
[Cloud Service]{class="badge informative"}
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 :
-
Ouvrez Developer Console :
https://developer.adobe.com/console
. -
Basculer vers Projets dans la partie supérieure.
-
Pour créer un projet vide, sélectionnez Projet vide de la Créer un projet menu déroulant.
-
Sélectionner API de la Ajouter au projet Liste déroulante pour ajouter l’API de gestion des entrées-sorties à votre projet.
-
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.
-
Enregistrez l’API configurée.
-
Revenir à Projets et cliquez sur Présentation du projet sur la gauche.
-
Cliquez sur Télécharger sur la partie supérieure pour télécharger le service JSON.
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 :
-
Ouvrez le gestionnaire d’expériences, puis sélectionnez le programme contenant l’environnement que vous souhaitez configurer.
-
Basculer vers Environnements .
-
Cliquez sur le nom de l’environnement que vous souhaitez configurer. Cela vous permet d’accéder à la page Informations sur l’environnement .
-
Basculer vers Configuration .
-
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.
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 :
-
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
-
Assurez-vous que les fichiers nouvellement ajoutés sont couverts par votre
filter.xml
. -
Validez et poussez vos modifications Git.
-
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
- 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é.
- 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 surtrue
puis il recherche toujours des configurations de microservice. Définirdxml.use.publish.microservice
tofalse
pour que la publication fonctionne sur votre site local.
- Non, si l’indicateur
- 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-OTdxml.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"
/>