Gérer les clés API

IMPORTANT
Workfront ne recommande plus d’utiliser les clés API pour les nouvelles intégrations. Utilisez plutôt l’une des méthodes d’authentification suivantes via Adobe Developer Console :
  • Authentification serveur à serveur
  • Authentification de l’utilisateur
Les clés API continuent à fonctionner pour le moment, mais Adobe recommande de planifier de nouvelles intégrations autour de l’authentification Adobe Developer Console.
Le service OAuth2 personnalisé hérité de Workfront est également mis hors service. Les nouvelles applications OAuth2 personnalisées ne pourront plus être créées après le 1er novembre 2026 et les applications OAuth2 personnalisées existantes cesseront de fonctionner le 1er février 2027.
Pour obtenir des conseils sur l'authentification, consultez Présentation de l'authentification Adobe Developer Console 🔗.
Pour plus d’informations sur la migration, voir Migration de Workfront OAuth2 vers Adobe Developer Console.

Afin de minimiser les vulnérabilités en matière de sécurité des API, les administrateurs et administratrices Adobe Workfront peuvent gérer les clés API utilisées afin de permettre aux applications d’accéder à Workfront pour le compte d’un utilisateur ou d’une utilisatrice.

Vous pouvez réinitialiser ou supprimer votre clé API d’administrateur ou d’administratrice actuelle, configurer l’expiration des clés API et supprimer les clés API de toutes les personnes.

Voici quelques exemples d’applications qui exploitent l’API Workfront :

  • Intégrations de documents, tels que Dropbox, Google Drive et Workfront DAM
  • Applications mobiles Workfront
IMPORTANT
Lors de la réinitialisation ou de la suppression d’une clé API, toute application utilisant l’API Workfront et s’authentifiant auprès de Workfront via cette clé API doit être reconfigurée afin de pouvoir accéder à nouveau à Workfront.

Conditions d’accès

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Package Adobe Workfront Tous
Licence Adobe Workfront

Standard

Plan

Configurations des niveaux d’accès Vous devez être un administrateur ou une administratrice Workfront.

Pour plus d’informations, voir Conditions d’accès requises dans la documentation Workfront.

Clés API de Workfront

Chaque personne utilisant Workfront dispose d’une clé API unique. Cette clé est générée pour chaque personne au moment où celle-ci accède à une intégration exploitant l’API Workfront (telle que l’application mobile Workfront ou une intégration de documents).

NOTE
Les clés API que vous générez dans l’environnement de production sont copiées dans votre environnement de prévisualisation lors de l’actualisation hebdomadaire. Toutes les clés API générées dans l’environnement de prévisualisation seront remplacées par vos clés API de production lors de l’actualisation hebdomadaire.

Les administrateurs et administratrices Workfront disposent également d’une clé API unique. Lorsqu’une application utilise une clé API d’administration pour accéder à Workfront, elle dispose d’un accès d’administration à Workfront.

Gérer une clé API d’administration

Vous pouvez générer, réinitialiser ou supprimer la clé API pour votre compte d’administrateur ou d’administratrice.

  1. Cliquez sur l’icône Menu principal Menu principal dans le coin supérieur gauche d’Adobe Workfront, puis cliquez sur Configuration Icône Configuration .

  2. Cliquez sur Système > Infos client.

  3. (Le cas échéant) Effectuez l’une des actions suivantes :

    Pour générer une clé API : dans la section Paramètres de la clé API, cliquez sur Générer la clé API.

    Ou
    Pour réinitialiser une clé API : dans la section Paramètres de la clé API, cliquez sur Réinitialiser, puis sur Réinitialiser.

    Ou

    Pour supprimer la clé API : dans la section Paramètres de la clé API, cliquez sur Supprimer, puis sur Supprimer.

Configurer l’expiration des clés API

Vous pouvez configurer l’expiration des clés API pour toutes les personnes de votre système. Lorsque la clé API d’une personne expire, cette personne doit s’authentifier à nouveau auprès de toute application qui utilise l’API Workfront pour accéder à Workfront. Vous pouvez modifier la fréquence d’expiration des clés API. Vous pouvez également déterminer si les clés API expirent lorsque le mot de passe d’une personne expire.

  1. Cliquez sur l’icône Menu principal Menu principal dans le coin supérieur gauche d’Adobe Workfront, puis cliquez sur Configuration Icône Configuration .

  2. Cliquez sur Système > Infos client.

  3. Dans la zone Paramètres de la clé API, dans la liste déroulante Après leur création, les clés API expirent dans, sélectionnez le délai d’expiration des clés API.

    Lorsque vous modifiez cette option, le nouveau délai entre en vigueur au moment où vous effectuez la modification. Par exemple, si vous modifiez cette option de 1 mois à 6 mois, les clés API expirent 6 mois après la modification.

    Par défaut, les clés API expirent chaque mois.

  4. Pour configurer les clés d’API qui expirent au moment où les mots de passe des utilisateurs expirent, activez Supprimer la clé d’API à l’expiration d’un mot de passe utilisateur.

    Par défaut, cette option n’est pas activée.

    Pour plus d’informations sur la configuration de l’expiration des mots de passe des personnes, voir Configurer les préférences de sécurité du système.

  5. Cliquer sur Enregistrer.

Supprimer les clés API pour toutes les personnes

Si une faille de sécurité particulière vous préoccupe concernant votre système Workfront, vous pouvez supprimer les clés API simultanément pour toutes les personnes.

IMPORTANT
La suppression des clés API pour toutes les personnes invalide TOUTES les clés API pour tous les utilisateurs et utilisatrices du système. Cette action entraînera l’échec de toutes vos intégrations dans Workfront jusqu’à ce que vous génériez une nouvelle clé API dans Workfront et que vous mettiez à jour toutes vos intégrations.
  1. Cliquez sur l’icône Menu principal Menu principal dans le coin supérieur gauche d’Adobe Workfront, puis cliquez sur Configuration Icône Configuration .

  2. Développez Système, puis cliquez sur Infos client.

  3. Dans la zone Paramètres de la clé API, cliquez sur Supprimer toutes les clés API, puis sur Supprimer tout.

recommendation-more-help
workfront-help-quicksilver