Gérer les clés API

IMPORTANT
Workfront ne recommande plus l’utilisation du point d’entrée /login ou des clés API. Utilisez plutôt l’une des méthodes d’authentification suivantes :
  • Authentification du serveur avec JWT
  • Authentification des utilisateurs et utilisatrices avec OAuth2
Pour obtenir des instructions sur la configuration de ces méthodes d’authentification, voir Créer des applications OAuth2 pour les intégrations Workfront.
Pour obtenir des instructions sur l’utilisation de l’authentification du serveur dans Workfront, voir Configurer et utiliser les applications OAuth 2 personnalisées de votre organisation à l’aide du flux JWT.
Pour obtenir des instructions sur l’utilisation de l’authentification des utilisateurs et utilisatrices dans Workfront, voir Configurer et utiliser les applications OAuth 2 personnalisées de votre organisation à l’aide du flux de code d’autorisation.

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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43