Prérequis

Les éléments suivants sont requis afin de terminer ce tutoriel :

  • Environnement AEM as a Cloud Service modernisé avec les éléments suivants :

    • AEM version 2024.10.18459.20241031T210302Z ou version ultérieure.
    • Profils de produit avec un nouveau style (si l’environnement a été créé avant novembre 2024)

    Consultez l’article Configuration d’API AEM basées sur OpenAPI pour plus d’informations.

  • L’exemple de projet WKND Sites doit être déployé dessus.

  • Accédez à Adobe Developer Console.

  • Installez Node.js sur votre ordinateur local pour exécuter l’exemple d’application NodeJS.

Étapes de développement

Les étapes de développement générales sont les suivantes :

  1. Configurer le projet ADC

    1. Ajouter l’API de création Assets
    2. Configurer sa méthode d’authentification sur OAuth serveur à serveur
    3. Associer le profil de produit à la configuration d’authentification
  2. Configurer l’instance AEM pour activer la communication du projet ADC

  3. Développer un exemple d’application NodeJS

  4. Vérifier le flux de bout en bout

Configurer le projet ADC

L’étape Configurer le projet ADC est répétée à partir de Configurer les API AEM basées sur OpenAPI. Elle est répétée pour ajouter l’API de création Assets et configurer sa méthode d’authentification sur OAuth serveur à serveur.

CONSEIL
Assurez-vous d’avoir terminé l’étape Activer l’accès aux API AEM de l’article Configurer les API AEM basées sur OpenAPI. Sans cela, l’option d’authentification de serveur à serveur n’est pas disponible.
  1. Ouvrez le projet souhaité à partir d’Adobe Developer Console.

  2. Pour ajouter des API AEM, cliquez sur le bouton Ajouter une API.

    Ajouter une API

  3. Dans la boîte de dialogue Ajouter une API, filtrez par Experience Cloud et sélectionnez la vignette API de création AEM Assets puis cliquez sur Suivant.

    Ajout d’une API AEM

    CONSEIL
    Si la carte d’API AEM souhaitée est désactivée et les informations Pourquoi est-ce désactivé ? indiquent le message Licence requise, l’une des raisons peut être que vous n’avez PAS modernisé votre environnement AEM as a Cloud Service. Pour plus d’informations, consultez Modernisation de l’environnement AEM as a Cloud Service.
  4. Ensuite, dans la boîte de dialogue Configurer l’API, sélectionnez l’option d’authentification Serveur à serveur et cliquez sur Suivant. L’authentification de serveur à serveur est idéale pour les services principaux nécessitant un accès à l’API sans interaction avec l’utilisateur ou l’utilisatrice.

    Sélection de l’authentification

    CONSEIL
    Si vous ne voyez pas l’option d’authentification de serveur à serveur, cela signifie que la personne qui configure l’intégration n’est pas ajoutée en tant que développeur ou développeuse au profil de produit auquel le service est associé. Consultez Activer l’authentification de serveur à serveur pour plus d’informations.
  5. Renommez les informations d’identification pour une identification plus facile (si nécessaire), puis cliquez sur Suivant. À des fins de démonstration, le nom par défaut est utilisé.

    Renommage des informations d’identification

  6. Sélectionnez le profil de produit Utilisateurs et utilisatrices collaborateurs AEM Assets - Création - Programme XXX - Environnement XXX et cliquez sur Enregistrer. Comme vous pouvez le constater, seul le profil de produit associé au service Utilisateurs et utilisatrices de l’API AEM Assets peut être sélectionné.

    Sélectionner le profil de produit

  7. Examinez l’API AEM et la configuration de l’authentification.

    Configuration d’API AEM

    Configuration d’authentification