Configuration d’un projet Adobe Developer Console configure-adc-project

Pour appeler l’API Content AI Services d’AEM, vous avez besoin d’informations d’identification émises par un projet Adobe Developer Console (ADC). Cette page vous guide tout au long de la création du projet, de la sélection d’une méthode d’authentification et de la génération des informations d’identification que vous incluez dans chaque requête API.

Accédez à 🔗 pour lancer votre organisation.

Conditions préalables prerequisites

Avant de commencer, vérifiez les points suivants :

  • Vous avez accès à 🔗 pour votre organisation.
  • Vous êtes ajouté en tant que développeur sur le profil de produit AEM Content AI Services dans Adobe Admin Console. Sans ce rôle, la carte d’API AEM Content AI Services apparaît désactivée et l’option d’authentification serveur à serveur est masquée.
  • Vous connaissez les numéros de programme et d’environnement du profil de produits que vous souhaitez sélectionner (par exemple, AEM User - publish - Program 12345 - Environment 67890).

Choisir une méthode d’authentification choose-auth

AEM Content AI Services prend en charge deux méthodes d’authentification. Sélectionnez celui qui correspond à votre intégration :

Méthode
Idéal pour
Serveur à serveur
Services principaux qui appellent l’API sans interaction de l’utilisateur. Renvoie un jeton d’accès de courte durée.
​ Clé API ​
Intégrations côté client ou basées sur un navigateur qui appellent directement l’API . Renvoie une clé de longue durée étendue aux domaines autorisés.

Authentification de serveur à serveur s2s-auth

  1. Sélectionnez API et services, puis API.

    Developer Console présentant les API et les services

  2. Filtrez par AEM Content AI Services, puis sélectionnez Créer un projet pour démarrer un nouveau projet, ou Ajouter une API si vous ajoutez le service à un projet existant.

    note
    NOTE
    Si la carte d’API est désactivée avec un message « Licence requise », votre environnement AEM as a Cloud Service risque de ne pas être modernisé. Voir ​ Modernisation de l’environnement AEM as a Cloud Service.
  3. Dans la boîte de dialogue Configurer l’API, sélectionnez l’authentification Serveur à serveur.

    Boîte de dialogue Configurer l’API avec l’option Serveur à serveur sélectionnée

    note tip
    TIP
    Si l’option Serveur à serveur n’est pas disponible, l’utilisateur configurant l’intégration n’est pas ajouté en tant que développeur au profil de produit. Voir Activer l’authentification de serveur à serveur.
  4. Si nécessaire, renommez les informations d’identification. Sélectionnez Suivant.

    Étape Adobe Developer Console pour renommer les nouvelles informations d'identification de serveur à serveur avant de sélectionner Suivant

  5. Sélectionnez le profil de produit Utilisateur AEM - publication - Programme XXX - Environnement XXX et/ou Utilisateur AEM - auteur - Programme XXX - Environnement XXX, puis sélectionnez Enregistrer.

    Sélecteur de profil de produit affichant les profils de publication et de création de l’utilisateur AEM pour le programme et l’environnement cibles

  6. Examinez la configuration de l’API et de l’authentification.

    Écran de vérification résumant l’API sélectionnée, le type d’authentification et le nom des informations d’identification

    Consulter les détails de l’écran affichant les profils de produit affectés pour les informations d’identification

Générer un jeton d’accès generate-token

  1. Dans votre projet ADC, accédez à Informations d’identification et sélectionnez Générer un jeton d’accès.

    Page des informations d’identification avec le bouton Générer un jeton d’accès en surbrillance

  2. Incluez le jeton dans l’en-tête Authorization de chaque requête API :

    code language-http
    Authorization: Bearer YOUR_ACCESS_TOKEN
    
    note warning
    WARNING
    Stockez le jeton en toute sécurité. Il expire et doit être régénéré périodiquement.

Authentification par clé API api-key-auth

  1. Lors de l’ajout de l’API Content AI Services AEM à votre projet, sélectionnez Clé API dans la boîte de dialogue Sélectionner le type d’authentification.

    Sélectionnez le type d’authentification de la clé API

  2. Confirmez les informations d’identification de la clé API.

    Ajout d’informations d’identification de clé API

  3. Pour limiter les origines qui peuvent utiliser la clé, configurez les domaines autorisés.

    Configurer les domaines autorisés

  4. Votre clé API (ID client) s’affiche sous Informations d’identification connectées. Sélectionnez Copie.

    Copier la clé API à partir des informations d’identification connectées

  5. Incluez la clé dans chaque requête API :

    code language-http
    x-api-key: YOUR_API_KEY
    

    Votre projet est maintenant prêt. Utilisez la clé avec chaque requête à AEM Content AI Services.

Étapes suivantes next-steps

recommendation-more-help
experience-manager-content-ai-help-content-ai