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. Il se peut que vous ne puissiez utiliser que les API qui vous sont attribuées.
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.
-
Vous devez disposer d’un projet sur Adobe Developer Console qui inclut l’API à laquelle vous souhaiter connecter le module. Vous pouvez :
-
Créez un projet avec l’API.
Ou
-
Ajoutez l’API à un projet existant.
Pour plus d’informations sur la création ou l’ajout d’une API à un projet dans Adobe Developer Console, voir Créer un projet dans la documentation Adobe.
-
Créer une connexion
Une connexion Adobe Authenticator se connecte à un seul projet dans Adobe Developer Console. Pour utiliser la même connexion pour plusieurs API 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, procédez comme suit :
-
Dans un module Adobe Authenticator, cliquez sur Ajouter en regard du champ Connexion.
-
Remplissez 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 Saisissez un nom pour 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. Scopes Si vous avez sélectionné une connexion OAuth, saisissez les portées nécessaires pour cette connexion. Technical account ID Saisissez l’ID de votre compte technique Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console. Organization ID 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. Meta Scopes Si vous avez sélectionné une connexion JWT, saisissez les métaportées nécessaires pour cette connexion. Private key 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 l’Adobe Developer Console.
Pour extraire votre clé privée ou votre certificat privé, procédez comme suit :
-
Cliquez sur Extract.
-
Sélectionnez le type de fichier que vous extrayez.
-
Sélectionnez le fichier contenant la clé privée ou le certificat privé.
-
Saisissez le mot de passe du fichier.
-
Cliquez sur Save 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 Indiquez si vous vous connectez à un compte de service ou à un compte personnel. -
-
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Modules
Effectuer un appel API personnalisé.
Ce module d’action vous permet d’effectuer un appel à n’importe quelle API Adobe. Il prend en charge les fichiers volumineux, au lieu des corps de texte uniquement.
Ce module a été mis à disposition le 14 novembre 2024. Toute Adobe Authenticator > Effectuer un appel API personnalisé configuré avant cette date ne prend pas en charge les fichiers volumineux et est désormais considéré comme le module Créer un appel API personnalisé (hérité) .
Effectuer un appel API personnalisé (hérité)
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.
Note :
Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez des guillemets à l’extérieur de l’instruction conditionnelle.
