Généer des informations d’identification de service
La génération des informations d’identification de service est divisée en deux étapes :
- La création ponctuelle d’un compte technique par l’administration de l’organisation Adobe IMS.
- Le téléchargement et l’utilisation du JSON des informations d’identification de service du compte technique.
Créer un compte technique
Contrairement aux jetons d’accès au développement local, les informations d’identification de service requièrent la création d’un compte technique par l’administration de l’organisation Adobe IMS avant de pouvoir être téléchargées. Des comptes techniques distincts doivent être créés pour chaque client ou cliente qui nécessite un accès programmatique à AEM.
Les comptes techniques sont créés une seule fois, mais les clés privées utilisées pour gérer les informations d’identification de service associées au compte technique peuvent être gérées au fil du temps. Par exemple, les nouvelles informations d’identification de service ou de clé privée doivent être générées avant l’expiration de la clé privée actuelle, afin de permettre un accès ininterrompu à une personne utilisatrice des informations d’identification de service.
-
Vérifiez votre connexion en tant que :
- Personne de l’administration système de l’organisation Adobe IMS
- membre du profil de produit IMS de l’administration AEM sur l’instance de création AEM.
-
Connectez-vous à Adobe Cloud Manager.
-
Ouvrez le programme contenant l’environnement AEM as a Cloud Service pour intégrer la configuration des informations d’identification de service.
-
Appuyez sur les points de suspension en regard de l’environnement dans la section Environnements et sélectionnez Developer Console.
-
Appuyez sur l’onglet Intégrations.
-
Appuyez sur l’onglet Comptes techniques.
-
Appuyez sur le bouton Créer un compte technique.
-
Les informations d’identification du service de compte technique sont initialisées et affichées au format JSON.
Une fois les informations d’identification de service de l’environnement AEM as a Cloud Service initialisées, d’autres personnes développeuses d’AEM de votre organisation Adobe IMS peuvent les télécharger.
Télécharger les informations d’identification de service
Le téléchargement des informations d’identification de service suit des étapes similaires à l’initialisation.
-
Vérifiez votre connexion en tant que :
- personne de l’administration de l’organisation Adobe IMS ;
- membre du profil de produit IMS de l’administration AEM sur l’instance de création AEM.
-
Connectez-vous à Adobe Cloud Manager.
-
Ouvrez le programme contenant l’environnement AEM as a Cloud Service auquel s’intégrer.
-
Appuyez sur les points de suspension en regard de l’environnement dans la section Environnements et sélectionnez Developer Console.
-
Appuyez sur l’onglet Intégrations.
-
Appuyez sur l’onglet Comptes techniques.
-
Développez le Compte technique à utiliser.
-
Développez la Clé privée dont les informations d’identification de service seront téléchargées et vérifiez que le statut est Actif.
-
Appuyez sur … > Affichage pour accéder à l’affichage associé à la Clé privée, qui affiche le fchier JSON des informations d’identification de service.
-
Appuyez sur le bouton de téléchargement dans le coin supérieur gauche pour télécharger le fichier JSON contenant la valeur des informations d’identification de service, et enregistrez le fichier à un emplacement sécurisé.
Installer les informations d’identification de service
Les informations d’identification de service fournissent les détails nécessaires à la génération d’un jeton JWT, qui est échangé contre un jeton d’accès utilisé pour s’authentifier avec AEM as a Cloud Service. Les informations d’identification de service doivent être stockées dans un emplacement sécurisé accessible par les systèmes, services ou applications externes qui les utilisent pour accéder à AEM. Le mode et l’emplacement de gestion des informations d’identification du service sont uniques pour chaque personne cliente.
Pour plus de simplicité, ce tutoriel transmet les informations d’identification de service via la ligne de commande. Toutefois, travaillez avec votre équipe de sécurité informatique pour comprendre comment stocker ces informations d’identification et y accéder conformément aux directives de sécurité de votre organisation.
- Copiez le JSON d’informations d’identification de service téléchargé dans un fichier nommé
service_token.jsonà la racine du projet.- Souvenez-vous de ne jamais enregistrer d’informations d’identification sur Git.
Utiliser les informations d’identification de service
Les informations d’identification de service consistent en un objet JSON entièrement formé et diffèrent du jeton JWT et du jeton d’accès. Les informations d’identification de service (qui contiennent une clé privée) sont plutôt utilisées pour générer un jeton JWT qui est échangé avec les API d’Adobe IMS contre un jeton d’accès.
- Téléchargez les informations d’identification de service depuis la Developer Console d’AEM vers un emplacement sécurisé.
- L’application externe doit interagir par programmation avec l’environnement AEM as a Cloud Service.
- L’application externe lit les informations d’identification de service à partir d’un emplacement sécurisé.
- L’application externe utilise les informations d’identification de service pour créer un jeton JWT.
- Le jeton JWT est envoyé à Adobe IMS pour être échangé contre un jeton d’accès.
- Adobe IMS renvoie un jeton d’accès qui peut être utilisé pour accéder à AEM as a Cloud Service.
- Les jetons d’accès ne peuvent pas modifier un délai d’expiration.
- L’application externe effectue des requêtes HTTP à AEM as a Cloud Service, en ajoutant le jeton d’accès en tant que jeton porteur à l’en-tête d’autorisation des requêtes HTTP.
- AEM as a Cloud Service reçoit la requête HTTP, authentifie la requête et effectue le travail demandé par la requête HTTP, puis renvoie une réponse HTTP à l’application externe.
Mises à jour de l’application externe
Pour accéder à AEM as a Cloud Service à l’aide des informations d’identification de service, l’application externe doit être mise à jour de trois façons :
- Lecture dans les informations d’identification de service
- Pour plus de simplicité, les informations d’identification de service sont lues à partir du fichier JSON téléchargé. Toutefois, dans les scénarios d’utilisation réelle, les informations d’identification de service doivent être stockées en toute sécurité conformément aux directives de sécurité de votre organisation.
- Génération d’un jeton JWT à partir des informations d’identification de service
- Échange du jeton JWT contre un jeton d’accès
- Lorsque les informations d’identification de service sont présentes, l’application externe utilise ce jeton d’accès au lieu du jeton d’accès au développement local lors de l’accès à AEM as a Cloud Service.
Dans ce tutoriel, le module npm @adobe/jwt-auth d’Adobe est utilisé pour 1), générer le jeton JWT à partir des informations d’identification de service et 2), l’échanger contre un jeton d’accès, dans un seul appel de fonction. Si votre application n’est pas basée sur JavaScript, consultez l’exemple de code dans d’autres langages pour savoir comment créer un jeton JWT à partir des informations d’identification de service et l’échanger contre un jeton d’accès avec Adobe IMS.
