Portail de support Workiva

Dans Workiva, la génération d’un jeton d’accès (spécifiquement un jeton OAuth2) est un processus en deux étapes : vous créez d’abord une API Grant pour obtenir des informations d’identification, puis vous utilisez ces informations d’identification pour demander le jeton proprement dit.

1. Créez une API Grant

Important : vous devez être propriétaire de l'espace de travail pour effectuer cette étape.

Pour obtenir un ID et un secret client :

1. Cliquez sur l'icône de votre identifiant dans le coin supérieur droit de la page Workiva, puis sélectionnez « Paramètres de l'espace de travail ».
   
2. Sélectionnez l'onglet « Sécurité », puis cliquez sur « Créer une autorisation API ».
   
3. Sur la page « Mise à jour de la subvention », remplissez les champs suivants :
   
   1. Saisissez le nom d'un client et le nom d'utilisateur Workiva au nom duquel l'autorisation sera accordée.
   2. Sélectionnez « Identifiants client OAuth2 » comme type de client .
   3. Sélectionnez les champs d'application ( autorisations) requis pour les points de terminaison de l'API que vous prévoyez d'utiliser.
   4. Définissez la date d'expiration .
   5. À moins que votre organisation ne l'exige expressément, vous pouvez ignorer le champ « Liste blanche d'adresses IP ».
   6. Cliquez sur « Ajouter une subvention ».

Important : copiez immédiatement l'identifiant client et la clé secrète, car cette dernière ne s'affichera plus par la suite.

2. Récupérer le jeton du porteur

Une fois que vous disposez de vos identifiants, vous devez les échanger contre un jeton d'accès à durée de vie limitée en envoyant une requête POST au service IAM de Workiva.

• Point de terminaison : https://api.app.wdesk.com (il s'agit du point de terminaison par défaut pour les États-Unis ; les autres régions ont des points de terminaison différents ).
• Type de contenu : Définissez le paramètre Content-Type sur application/json .

• 

• En-têtes : Ajouter X-Version : 01/01/2026

• 

• Valeurs du formulaire :
  • grant_type : client_credentials
  • client_id :[Your Client ID]
  • client_secret :[Your Client Secret]
  • Champ d'application : chaînes

• 

• Durée de validité : les jetons au porteur Workiva sont généralement valables pendant 10 minutes. Vous devez les rafraîchir périodiquement pour les processus de longue durée.

Jetons SEC EDGAR Next

Si vous générez des jetons spécifiquement destinés aux déclarations auprès de la SEC (EDGAR Next) , ceux-ci diffèrent des jetons API standard :

• Ces jetons (jeton API Filer et jeton utilisateur) sont créés sur le tableau de bord « EDGAR Filer Management » de la SEC.
• Une fois obtenus, vous pouvez les gérer dans Workiva sous SEC Reporting &gt ; Manage EDGAR Next Tokens.