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

Adobe Workfront plan

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 API
v1.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 :

    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 :

    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.

    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.
  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 à 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é) .

Connection
Pour obtenir des instructions sur la création d’une connexion au module Adobe Authenticator, voir Créer une connexion dans cet article.
Base URL
Saisissez l’URL de base du point API auquel vous souhaitez vous connecter.
URL
Saisissez le chemin d’accès relatif à l’URL de base.
Method
Sé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 dans Adobe Workfront Fusion.
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 String
Saisissez la chaîne de requête.
Body Type

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

  • application/x-www-form-urlencoded
  • Brut
  • multipart/form-data
Fields
Pour chaque fichier que vous souhaitez ajouter à la requête APU, cliquez sur Ajouter un élément et saisissez le texte du fichier (pour les données brutes), ou saisissez la clé uploadedFile et mappez les données du fichier.

Effectuer un appel API personnalisé (hérité)

Ce module d’action vous permet d’effectuer un appel à n’importe quelle API Adobe.

Connection
Pour obtenir des instructions sur la création d’une connexion au module Adobe Authenticator, voir Créer une connexion dans cet article.
Base URL
Saisissez l’URL de base du point API auquel vous souhaitez vous connecter.
URL
Saisissez le chemin d’accès relatif à l’URL de base.
Method
Sé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 dans Adobe Workfront Fusion.
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 String
Saisissez la chaîne de requête.
Body

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.

Limit
Saisissez le nombre maximal de résultats que le module doit renvoyer dans un cycle d’exécution.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43