Show Menu
SUJETS×

Présentation de l’intégration et conditions préalables

Ces informations vous montrent comment créer une intégration d’E/S Adobe et d’un service Places.

Conditions préalables pour l’accès utilisateur

Vérifiez auprès de l’administrateur système de votre entreprise que les tâches suivantes ont été accomplies :
  • Place le service principal s’affiche dans la console d’administration de votre entreprise.
  • Vous avez été ajouté à l’organisation.
  • Vous avez été ajouté en tant qu’utilisateur au service principal Places de votre entreprise.
    Pour plus d’informations, voir Ajout d’un utilisateur ou d’un développeur à vos profils Places Service et Experience Platform Launch dans Accès au service Places.
  • Vous avez été ajouté en tant que développeur à Places Core Service dans votre entreprise.
    Pour plus d’informations sur l’ajout de développeurs, voir Ajout d’un utilisateur ou d’un développeur à vos profils Places Service et Experience Platform Launch dans Accès au service Places.
    Pour plus d’informations sur le rôle de développeur, voir Gestion des développeurs .

Demandes d’API REST

Chaque requête à l’API REST du service Places nécessite les éléments suivants :
  • Un ID d’organisation
  • Une clé API
  • Jeton porteur
Une intégration avec les E/S Adobe fournit ces éléments et un moyen de demander le jeton porteur à l’aide d’un JSON Web Token (JWT).
  • Pour plus d’informations sur les JWT, voir Présentation des jetons Web JSON.
  • Pour créer une intégration pour le service Places, voir la section Création d’une intégration de service Places ci-dessous.
  • Pour comprendre l’intégration des clés d’API, la génération d’un fichier JWT et de certificats de clé publique, voir Présentation de l’authentification des E/S Adobe.
Si vous ne pouvez pas vous connecter à la console d’E/S d’Adobe ou si le service Places n’est pas une option de la page Créer des intégrations , voir Conditions requises pour l’ organisation dans la présentation de l’API des services Web.

Création d’une intégration du service Places

Pour créer une intégration du service Places, procédez comme suit :

Générer une paire de clés publique et privée

Pour créer une intégration du service Places, vous avez besoin d’une paire de clés publique et privée. Vous pouvez acheter ces paires ou générer vos propres clés autosignées.
Pour générer vos propres clés autosignées :
  1. Dans une fenêtre de terminal, copiez et collez chacune des lignes suivantes et appuyez sur Enter ​après avoir collé chaque ligne :
       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    
    Nous vous recommandons de nommer vos clés pour une référence facile et de les stocker dans un dossier. Si vous créez plusieurs intégrations, vous pouvez facilement identifier et gérer les clés appartenant à l’intégration.
  2. Entrez les informations demandées par OpenSSL :
    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    
    
    Pour plus d’informations sur OpenSSL, voir OpenSSL .
    Les informations que vous fournissez sont intégrées aux clés.
  3. Accédez au répertoire contenant les fichiers .key et .crt .
    Par exemple, sous MacOS, sélectionnez Macintosh HD > users > (your user name) > Keys .
La vidéo suivante vous guide tout au long du processus de génération de la paire de clés :

Création d’une intégration du service Places dans la console d’E/S Adobe

Pour créer une intégration du service Places :
  1. Accédez à https://console.adobe.io et connectez-vous avec votre Adobe ID.
  2. Dans la section Démarrage rapide, cliquez sur Créer une intégration .
  3. Sélectionnez Access an API ​puis cliquez sur​ Continue .
    Access an API ​est l’emplacement par défaut.
  4. Si vous avez accès à plusieurs organisations Experience Cloud, sélectionnez l’organisation dans la liste déroulante en haut à droite.
  5. Under Experience Cloud , select​ Places Service as the Adobe service to which you want to integrate and click Continue .
  6. Sélectionnez New integration ​puis cliquez sur​ Continue .
  7. Dans l’écran Créer une intégration, saisissez un nom et une description.
  8. Faites glisser votre xxxx_public.crt fichier que vous avez créé ci-dessus vers la zone de Public keys certificates ​dépôt.
  9. Sélectionnez un profil de produit.
    Si vous ne savez pas quel profil sélectionner, contactez votre administrateur système.
  10. At the bottom of the page, click Create integration .
  11. Au bout de quelques secondes, dans l’écran Intégration créée , vérifiez que le message suivant s’affiche :
    Your integration has been created.
  12. La page des détails de l’intégration s’affiche avec le nom de l’intégration en haut.
    L’ Overview ​onglet s’affiche par défaut et affiche la clé d’API, l’ID de votre organisation, l’ID de compte technique et d’autres détails sur vos intégrations.

Enregistrer l’ID d’organisation et la clé d’API

  1. Dans la page des détails de l’intégration, cliquez sur l’ Services ​onglet et vérifiez que​ Places Service l’élément est affiché sous Configured Services .
  2. Dans l’ Overview ​onglet, recherchez et enregistrez la clé d’API (ID client) et l’ID d’organisation.
    Ces identifiants sont nécessaires pour chaque requête d’API REST du service Places.

Générer un jeton JWT

Dans la page des détails de l’intégration, cliquez sur l’ JWT ​onglet afin de pouvoir tester votre intégration en générant un fichier JWT et en fournissant l’URL d’échange.
Pour générer un jeton JWT :
  1. Dans un éditeur de texte, ouvrez le private.key fichier créé ci-dessus.
  2. On the JWT ​tab, copy the contents of the key and paste it in the​ Paste private key field.
  3. Cliquez sur Generate JWT (Exécuter des tests d’Auditor).
  4. In the Sample CURL command ​section, click​ Copy and paste the contents in your command prompt or terminal window.
  5. Exécutez la commande en appuyant Enter ​sur votre clavier.
  6. Recherchez la "token_type": "bearer" valeur et la "access_token" valeur.
    La valeur du jeton d’accès au porteur est ce que vous utiliserez dans vos demandes d’API du service Places.
Les jetons d’accès Adobe sont valides uniquement pendant 24 heures. Enregistrez donc l’exemple de commande CURL (étape 5). Si le jeton d’accès n’est plus valide, vous devez régénérer le jeton.