Configurer un projet Adobe Developer Console configure-adc-project

Pour appeler l’API de services d’IA dédiée au contenu 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 à Adobe Developer Console pour votre organisation afin de commencer.

Prérequis prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

  • Vous avez accès à Adobe Developer Console pour votre organisation.
  • Vous avez le rôle de développeur ou développeuse sur le profil de produit de services d’IA dédiée au contenu d’AEM dans Adobe Admin Console. Sans ce rôle, la carte de l’API Services d’IA dédiée au contenu d’AEM 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 produit que vous souhaitez sélectionner (par exemple, AEM User - publish - Program 12345 - Environment 67890).
  • Vous détenez le rôle Administrateur ou administratrice système dans Admin Console pour le programme. Ce rôle vous permet de gérer les profils de produit et d’affecter des utilisateurs et utilisatrices à l’environnement.

Choisir une méthode d’authentification choose-auth

Les services d’IA dédiée au contenu d’AEM prennent en charge deux méthodes d’authentification. Sélectionnez celle qui correspond à votre intégration :

Méthode
Idéal pour
Serveur à serveur
Services backend qui appellent l’API sans intervention de l’utilisateur ou utilisatrices. 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é à longue durée de vie limitée aux domaines autorisés.

Authentification de serveur à serveur s2s-auth

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

    Developer Console affichant les API et les services

  2. Filtrez par Services d’IA dédiée au contenu d’AEM, 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 de l’API est désactivée avec un message « Licence requise », il se peut que votre environnement AEM as a Cloud Service n’ait pas été modernisé. Consultez Moderniser 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 d’authentification de serveur à serveur n’est pas disponible, 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.
  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 et utilisatrice AEM – publication – Programme XXX – Environnement XXX et/ou Utilisateur et utilisatrice AEM – création – Programme XXX – Environnement XXX et cliquez sur Enregistrer.

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

  6. Vérifier l’API et la configuration de l’authentification

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

    Détails de l’écran Vérifier 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 évidence

  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
    Conservez le jeton en toute sécurité. Il expire et doit être régénéré régulièrement.

Authentification par clé API api-key-auth

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

    Sélectionner le type d’authentification par clé API

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

    Ajouter des informations d’identification de clé API

  3. Pour limiter les sources 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 Copier.

    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 désormais prêt. Utilisez la clé avec chaque requête à Services d’IA dédiée au contenu d’AEM.

Étapes suivantes next-steps

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