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

Ces informations vous montrent comment créer une intégration Adobe I/O et un service Places.

Conditions préalables pour l’accès des utilisateurs

Vérifiez auprès de l'administrateur système de votre organisation que les tâches suivantes ont été effectuées :

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 Ajouter un utilisateur ou un développeur à votre service Places et à vos profils Experience Platform Launch dans Accès au service Places.
Vous avez été ajouté en tant que développeur pour Places Core Service dans votre entreprise.

Pour plus d'informations sur l'ajout de développeurs, voir Ajouter un utilisateur ou un développeur à votre service Places et à vos profils Experience Platform Launch dans Obtenir l'accès au service Places.

Pour plus d’informations sur le rôle de développeur, voir Gérer les 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é d'API
Jeton de porteur

Une intégration à Adobe I/O 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 Introduction to JSON Web Tokens.
Pour créer une intégration pour le service Places, voir la section Création d'une intégration du service Places ci-dessous.
Pour comprendre l’intégration des clés d’API, la génération d’un JWT et de certificats de clé publique, voir Aperçu de l’authentification Adobe I/O.

IMPORTANT

Si vous ne pouvez pas vous connecter à la console Adobe I/O ou si le service Places n'est pas une option dans la page Créer des intégrations, voir Exigences d'organisation dans 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, effectuez les tâches suivantes :

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. Ces paires peuvent être achetées ou vous pouvez générer vos propres clés autosignées.

Pour générer vos propres clés autosignées :

Dans une fenêtre de terminal, copiez et collez chacune des lignes suivantes, puis appuyez sur Entrée 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
```
IMPORTANT

Nous vous recommandons de nommer vos clés pour en faciliter la référence et de les stocker dans un dossier. Si vous créez plusieurs intégrations, vous pouvez facilement identifier et gérer les clés qui appartiennent à l’intégration.

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.

IMPORTANT

Les informations que vous fournissez sont intégrées aux clés.

Accédez au répertoire dans lequel se trouvent les fichiers .key et .crt.

Par exemple, sous MacOS, accédez à Macintosh HD > utilisateurs > (votre nom d’utilisateur) > Clés.

La vidéo suivante vous guide tout au long du processus de génération de la paire de clés :

vidéo d’intégration

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

Pour créer une intégration du service Places :

Accédez à https://console.adobe.io et connectez-vous avec votre Adobe ID.
Dans la section Début rapide, cliquez sur Créer l'intégration.
Sélectionnez Access an API (Accéder à une API), puis cliquez sur Continue (Continuer).

Accéder à une API est l’emplacement par défaut.
Si vous avez accès à plusieurs organisations Experience Cloud, sélectionnez l’organisation dans la liste déroulante située en haut à droite.
Sous Experience Cloud, sélectionnez Service des emplacements comme service d'Adobe à intégrer et cliquez sur Continuer.
Sélectionnez Nouvelle intégration et cliquez sur Continuer.
Dans l’écran Créer une intégration, saisissez un nom et une description.
Faites glisser votre fichier xxxx_public.crt que vous avez créé ci-dessus vers la zone de dépôt Certificats de clés publiques.
Sélectionnez un profil de produit.

Si vous ne savez pas quel profil sélectionner, contactez votre administrateur système.
Au bas de la page, cliquez sur Créer une intégration.
Après quelques secondes, dans l’écran Intégration créée, vérifiez que le message suivant s’affiche :

Your integration has been created.
La page des détails de l’intégration s’affiche avec le nom de l’intégration en haut.

L'onglet Aperçu s'affiche par défaut et affiche la clé d'API, l'ID de votre organisation, l'ID du compte technique et d'autres détails sur vos intégrations.

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

Dans la page des détails de l'intégration, cliquez sur l'onglet Services et vérifiez que Place Service s'affiche sous Configuré Services.
Dans l'onglet Aperçu, 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ération d’un jeton JWT

Dans la page des détails de l’intégration, cliquez sur l’onglet JWT afin de pouvoir tester votre intégration en générant un JWT et en fournissant l’URL d’échange.

Pour générer un jeton JWT :

Dans un éditeur de texte, ouvrez le fichier private.key créé ci-dessus.
Sous l’onglet JWT, copiez le contenu de la clé et collez-le dans le champ Coller la clé privée.
Cliquez sur Générer JWT.
Dans la section Exemple de commande CURL, cliquez sur Copier et collez le contenu dans votre invite de commande ou fenêtre de terminal.
Exécutez la commande en appuyant sur Entrée sur votre clavier.
Recherchez les valeurs "token_type": "bearer" et "access_token".

La valeur du jeton d'accès porteur est ce que vous utiliserez dans vos demandes d’API du service Lieux.

IMPORTANT

Les jetons d'accès d’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.