Guide d’identification

Adobe Experience Platform Query Service vous permet de vous connecter à des clients externes. Vous pouvez vous connecter à ces clients externes à l’aide d’informations d’identification arrivant à expiration ou d’informations d’identification non arrivant à expiration.

Expiration des informations d’identification

Vous pouvez utiliser des informations d’identification arrivant à expiration pour configurer rapidement une connexion à un client externe.

La section Informations d’identification arrivant à expiration fournit les informations suivantes :

  • Hôte : Nom de l’hôte auquel vous vous connectez. Pour la connexion à Query Service, cela inclut le nom de l’organisation IMS que vous utilisez actuellement.
  • Port : Numéro de port de l’hôte auquel vous vous connectez.
  • Base de données : Nom de la base de données à laquelle vous vous connectez.
  • Nom d’utilisateur : Nom d’utilisateur que vous utiliserez pour vous connecter à Query Service.
  • Mot de passe : mot de passe que vous utiliserez pour vous connecter à Query Service.
  • Commande PSQL : Une commande qui a automatiquement inséré toutes les informations pertinentes pour vous connecter à Query Service à l’aide de PSQL sur la ligne de commande.
  • Expire : Date d’expiration des informations d’identification arrivant à expiration. Les informations d’identification expirent 24 heures après leur génération.

Informations d’identification non arrivant à expiration

Vous pouvez utiliser des informations d’identification non arrivant à expiration pour configurer une connexion plus permanente à un client externe.

Conditions préalables

Avant de pouvoir générer des informations d’identification non arrivant à expiration, vous devez effectuer les étapes suivantes dans Adobe Admin Console :

  1. Connectez-vous à Adobe Admin Console et sélectionnez l’organisation appropriée dans la barre de navigation supérieure.
  2. Sélection dʼun profil de produit.
  3. Configurez les ​environnements de test et les autorisations d’ intégration de Query Service pour le profil de produit.
  4. Ajoutez un nouvel utilisateur à un profil de produit afin qu’il se voit attribuer les autorisations configurées.
  5. Ajoutez l’utilisateur en tant qu’ administrateur de profil de produit pour permettre la création d’un compte pour n’importe quel profil de produit principal.
  6. Ajoutez l’utilisateur en tant que développeur de profil de produit afin de créer une intégration.

Pour en savoir plus sur l’affectation d’autorisations, consultez la documentation sur le contrôle d’accès.

Toutes les autorisations requises sont désormais configurées dans Adobe Developer Console pour que l’utilisateur puisse utiliser la fonction des informations d’identification arrivant à expiration.

Génération des informations d’identification

Pour créer un ensemble d’informations d’identification non arrivant à expiration, revenez à l’interface utilisateur de Platform et sélectionnez Requêtes dans le volet de navigation de gauche pour accéder à l’espace de travail Requêtes . Sélectionnez ensuite l’onglet Credentials suivi de Generate credentials.

Une boîte de dialogue s’affiche, vous permettant de générer des informations d’identification. Pour créer des informations d’identification non expirantes, vous devez fournir les détails suivants :

  • Nom : Nom des informations d’identification que vous générez.
  • Description : (Facultatif) Description des informations d’identification que vous générez.
  • Affecté à : L’utilisateur auquel les informations d’identification seront attribuées. Cette valeur doit correspondre à l’adresse électronique de l’utilisateur qui crée les informations d’identification.
  • Mot de passe (facultatif) Mot de passe facultatif pour vos informations d’identification. Si le mot de passe n’est pas défini, Adobe génère automatiquement un mot de passe.

Une fois que vous avez fourni tous les détails requis, sélectionnez Générer les informations d’identification pour générer vos informations d’identification.

IMPORTANT

Une fois le bouton Générer les informations d’identification sélectionné, un fichier de configuration JSON est téléchargé sur votre ordinateur local. Étant donné que Adobe n’enregistre pas les informations d’identification générées, vous devez stocker le fichier téléchargé en toute sécurité et conserver un enregistrement des informations d’identification.

De plus, si les informations d’identification ne sont pas utilisées pendant 90 jours, elles seront expurgées.

Le fichier de configuration JSON contient des informations telles que le nom du compte technique, l’identifiant de compte technique et les informations d’identification. Il est fourni au format suivant.

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

Après avoir enregistré vos informations d’identification générées, sélectionnez Fermer. Vous pouvez maintenant voir une liste de toutes vos informations d’identification qui ne expirent pas.

Vous pouvez modifier ou supprimer vos informations d’identification non arrivant à expiration. Pour modifier des informations d’identification non expirantes, sélectionnez l’icône représentant un crayon (). Pour supprimer des informations d’identification non arrivant à expiration, sélectionnez l’icône de suppression ().

Lors de la modification d’informations d’identification non expirantes, un modal s’affiche. Vous pouvez fournir les détails suivants à mettre à jour :

  • Nom : Nom des informations d’identification que vous générez.
  • Description : (Facultatif) Description des informations d’identification que vous générez.
  • Affecté à : L’utilisateur auquel les informations d’identification seront attribuées. Cette valeur doit correspondre à l’adresse électronique de l’utilisateur qui crée les informations d’identification.

Une fois que vous avez fourni tous les détails requis, sélectionnez Mettre à jour le compte pour terminer la mise à jour de vos informations d’identification.

Utilisation des informations d’identification pour se connecter à des clients externes

Vous pouvez utiliser les informations d’identification arrivant à expiration ou non pour vous connecter à des clients externes, tels qu’Aqua Data Studio, Looker ou Power BI. La méthode de saisie de ces informations d’identification varie en fonction du client externe. Reportez-vous à la documentation du client externe pour obtenir des instructions spécifiques sur l’utilisation de ces informations d’identification.

L’image indique l’emplacement de chaque paramètre trouvé dans l’interface utilisateur, à l’exception du mot de passe des informations d’identification non arrivant à expiration. Bien que les informations d’identification non expirantes soient fournies par leurs fichiers de configuration JSON, vous pouvez afficher vos informations d’identification arrivant à expiration sous l’onglet Informations d’identification de l’interface utilisateur.

Le tableau ci-dessous décrit les paramètres généralement requis pour se connecter à des clients externes.

REMARQUE

Lors de la connexion à un hôte à l’aide d’informations d’identification non arrivant à expiration, il est toujours nécessaire d’utiliser tous les paramètres répertoriés dans la section EXPIRING CREDENTIALS , à l’exception du mot de passe et du nom d’utilisateur.

Paramètre Description
Serveur/Hôte Nom du serveur/hôte auquel vous vous connectez.
  • Cette valeur est utilisée pour les informations d’identification arrivant à expiration et non arrivant à expiration et prend la forme server.adobe.io. La valeur se trouve sous Host dans la section EXPIRING CREDENTIALS .
Port port du serveur/hôte auquel vous vous connectez.
  • Cette valeur est utilisée pour les informations d’identification arrivant à expiration et non arrivant à expiration. Elle se trouve sous Port dans la section EXPIRING CREDENTIALS . Un exemple de valeur pour le port serait 80.
Base de données La base de données à laquelle vous vous connectez.
  • Cette valeur est utilisée pour les informations d’identification arrivant à expiration et non arrivant à expiration. Elle se trouve sous Base de données dans la section EXPIRING CREDENTIALS . Un exemple de valeur pour la base de données serait prod:all.
Nom d’utilisateur Nom d’utilisateur de l’utilisateur qui se connecte au client externe.
  • Si vous utilisez des informations d’identification arrivant à expiration, cette chaîne prend la forme d’une chaîne alphanumérique précédant @AdobeOrg. Cette valeur se trouve sous Nom d’utilisateur.
  • Si vous utilisez des informations d’identification non arrivant à expiration, il s’agit d’une chaîne de votre choix, bien que ne puisse pas être identique à la valeur technicalAccountID du fichier JSON de configuration.
Mot de passe Mot de passe de l’utilisateur qui se connecte au client externe.
  • Si vous utilisez des informations d’identification arrivant à expiration, vous pouvez le trouver sous Mot de passe dans la section EXPIRING CREDENTIALS .
  • Si vous utilisez des informations d’identification qui ne expirent pas, cette valeur correspond aux arguments concaténés de l’ID de compte technique et aux informations d’identification extraites du fichier JSON de configuration. La valeur du mot de passe se présente comme suit : {technicalAccountId}:{credential}.

Étapes suivantes

Maintenant que vous comprenez le fonctionnement des informations d’identification arrivant à expiration et non arrivant à expiration, vous pouvez utiliser ces informations d’identification pour vous connecter à des clients externes. Pour plus d’informations sur les clients externes, consultez le guide de connexion des clients à Query Service.

Sur cette page