Modules Adobe Authenticator
Le module Adobe Authenticator vous permet de vous connecter à n’importe quelle API Adobe à l’aide d’une connexion unique. Cela vous permet de vous connecter plus facilement à des produits Adobe qui n’ont pas encore de connecteur Fusion dédié.
L’avantage des modules HTTP est que vous pouvez créer une connexion, comme dans une application dédiée.
Pour obtenir la liste des API d’Adobe disponibles, voir API d’Adobe. Vous pouvez ne pouvoir utiliser que les API auxquelles vous êtes affecté.
Conditions d’accès
Conditions préalables
-
Vous devez avoir accès au produit Adobe auquel vous souhaitez que le module se connecte.
-
Vous devez avoir accès à Adobe Developer Console.
-
Sur Adobe Developer Console, vous devez disposer d’un projet incluant l’API à laquelle vous souhaitez que le module se connecte. Vous pouvez effectuer les opérations suivantes :
-
Créez un projet avec l’API .
Ou
-
Ajouter l’API à un projet existant.
Pour plus d’informations sur la création ou l’ajout d’une API à un projet sur Adobe Developer Console, voir Création d’un projet dans la documentation Adobe.
-
Création d’une connexion
Une connexion Adobe Authenticator se connecte à un seul projet sur Adobe Developer Console. Pour utiliser la même connexion pour plusieurs API d’Adobe, ajoutez les API au même projet, puis créez une connexion à ce projet.
Vous pouvez créer des connexions distinctes à des projets distincts, mais vous ne pouvez pas utiliser de connexion pour accéder à une API qui ne se trouve pas sur le projet spécifié dans cette connexion.
Pour créer une connexion :
-
Dans un module Adobe Authenticator, cliquez sur Ajouter en regard du champ Connexion.
-
Renseignez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 layout-auto html-authored no-header Connection type Indiquez si vous souhaitez créer une connexion OAuth serveur à serveur ou une connexion au compte de service (JWT). Connection name Nommez cette connexion. Client ID Saisissez votre ID client Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console. Client Secret Saisissez votre secret client Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console. Portées Si vous avez sélectionné une connexion OAuth, saisissez les portées nécessaires pour cette connexion. ID du compte technique Saisissez votre ID de compte technique Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console. ID d’organisation Si vous avez sélectionné une connexion JWT, saisissez votre ID d’organisation Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console. Portées des métadonnées Si vous avez sélectionné une connexion JWT, saisissez les méta-portées nécessaires pour cette connexion. Clé privée Si vous avez sélectionné une connexion JWT, saisissez la clé privée générée lors de la création de vos informations d’identification dans le Adobe Developer Console.
Pour extraire votre clé privée ou votre certificat :
-
Cliquez sur Extract.
-
Sélectionnez le type de fichier que vous extrayez.
-
Sélectionnez le fichier contenant la clé privée ou le certificat.
-
Saisissez le mot de passe du fichier.
-
Cliquez sur Enregistrer pour extraire le fichier et revenir à la configuration de la connexion.
URL de base Vous devez ajouter les URL de base que vous souhaitez que cet authentificateur autorise. Lors de l’utilisation ultérieure du scénario Créer un module d’appel API personnalisé , vous ajouterez un chemin relatif à l’URL choisie. En saisissant ici des URL, vous pouvez contrôler à quoi le module d’appel d’API personnalisé peut se connecter, ce qui renforce la sécurité.
Pour chaque URL de base à ajouter à l’authentificateur, cliquez sur Ajouter un élément et saisissez l’URL de base.
Authentication URL Laissez ce champ vide pour utiliser l’URL d’authentification Adobe IMS standard de https://ims-na1.adobelogin.com. Si vous n’utilisez pas Adobe IMS pour l’authentification, saisissez l’URL à utiliser pour l’authentification.Environment Indiquez si vous vous connectez à un environnement de production ou hors production. Type Choisissez si vous vous connectez à un compte de service ou à un compte personnel. -
-
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Module
Effectuer un appel API personnalisé
Ce module d’action vous permet d’effectuer un appel à n’importe quelle API Adobe.
Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.
Par exemple, {"Content-type":"application/json"}
Workfront Fusion ajoute automatiquement des en-têtes d’autorisation.
Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.
Remarque :
lors de l’utilisation d’instructions conditionnelles telles que if dans votre JSON, placez les guillemets en dehors de l’instruction conditionnelle.
