Modules Adobe Authenticator

Dernière mise à jour : 12 mars 2025
  • Rubriques :

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

Adobe Workfront paquet

Nouveau : Tous

Ou

Actuelle : Pro ou licence supérieure

Adobe Workfront licence

Nouveau : Standard

Ou

Actuelle : Plan, Work

Adobe Workfront Fusion licence

Exigence de licence Fusion actuelle : aucune licence Workfront Fusion requise.

Ou

Exigence de licence Fusion héritée : Workfront Fusion for Work Automation and Integration

Produit

Nouvelle formule Workfront : si vous disposez de la formule Select ou PrimeAdobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Formule Workfront actuelle : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

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.

Informations sur l’API Adobe Authenticator

Le connecteur Adobe Authenticator utilise les éléments suivants :

Balise APIv1.1.4

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.

IMPORTANT
Avec le connecteur Adobe Authenticator, vous avez le choix entre établir une connexion OAuth serveur à serveur ou une connexion à un compte de service (JWT). Adobe a abandonné les informations d’identification JWT, qui cesseront de fonctionner après le 1er janvier 2025. Nous vous recommandons donc vivement de créer des connexions OAuth.
Pour plus d’informations sur ces types de connexions, voir Authentification serveur à serveur dans la documentation Adobe.

Pour créer une connexion, procédez comme suit :

  1. Dans un module Adobe Authenticator, cliquez sur Ajouter en regard du champ Connexion.

  2. Remplissez les champs suivants :

    Connection typeIndiquez si vous souhaitez créer une connexion OAuth serveur à serveur ou une connexion au compte de service (JWT).
    Connection nameSaisissez un nom pour cette connexion.
    Client IDSaisissez votre ID client Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    Client SecretSaisissez votre secret client Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    ScopesSi vous avez sélectionné une connexion OAuth, saisissez les portées nécessaires pour cette connexion.
    Technical account IDSaisissez l’ID de votre compte technique Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    Organization IDSi 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 ScopesSi 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 :

    1. Cliquez sur Extract.

    2. Sélectionnez le type de fichier que vous extrayez.

    3. Sélectionnez le fichier contenant la clé privée ou le certificat privé.

    4. Saisissez le mot de passe du fichier.

    5. Cliquez sur Save pour extraire le fichier et revenir à la configuration de la connexion.

    Base URLs

    Vous devez ajouter les URL de base que cet authentificateur doit autoriser. Lors de l’utilisation du module « Effectuer un appel API personnalisé » plus loin dans le scénario, vous ajouterez un chemin d’accès relatif à l’URL choisie. En saisissant des URL ici, vous pouvez contrôler à quoi le module Créer un appel API personnalisé peut se connecter, ce qui renforce la sécurité.

    Pour chaque URL de base que vous souhaitez ajouter à l’authentificateur, cliquez sur Ajouter un élément et saisissez l’URL de base.

    Authentication URLLaissez 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.
    EnvironmentIndiquez si vous vous connectez à un environnement de production ou hors production.
    TypeIndiquez si vous vous connectez à un compte de service ou à un compte personnel.

  3. 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 vers n’importe quelle API d’Adobe. Il prend en charge les fichiers volumineux, au lieu des corps de texte uniquement.

Ce module a été rendu disponible le 14 novembre 2024. Tout appel Adobe Authenticator > Effectuer un appel API personnalisé configuré avant cette date ne gère pas les fichiers volumineux. Il est désormais considéré comme le module Effectuer un appel API personnalisé (hérité) .

ConnectionPour obtenir des instructions sur la création d’une connexion au module Adobe Authenticator, voir Créer une connexion dans cet article.
Base URLSaisissez l’URL de base du point API auquel vous souhaitez vous connecter.
URLSaisissez le chemin d’accès relatif à l’URL de base.
MethodSélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP.
Headers

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.

Query StringSaisissez la chaîne de requête.
Body Type

Sélectionnez le type de corps de cette requête API :

  • Brut
  • application/x-www-form-urlencoded
  • multipart/form-data
Request contentSaisissez le contenu de la demande. Cette option est disponible si vous avez sélectionné le type de corps Raw
FieldsPour chaque fichier que vous souhaitez ajouter à la requête API, cliquez sur Ajouter un élément et saisissez le texte du fichier (pour les données brutes), ou saisissez le uploadedFile de clé et mappez les données du fichier. Cette option est disponible si vous avez sélectionné le type de corps application ou multipart.
Type de sortieSélectionnez le type de données que le module doit générer. Si vous ne sélectionnez pas de type, le module en sélectionne un automatiquement.