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 d’un espace de travail pour effectuer cette étape.

Pour obtenir un ID et un secret client :

1. Cliquez sur votre icône ID dans le coin supérieur droit de la page Workiva, puis sélectionnez Workspace settings.
   
2. Sélectionnez l’onglet Security puis cliquez sur Create API Grant.
   
3. Sur la page Update Grant , remplissez les champs suivants :
   
   1. Saisissez un nom de client et le nom d’utilisateur Workiva au nom duquel la subvention agira.
   2. Sélectionnez « OAuth2 Client Credentials » en tant que Client Type.
   3. Sélectionnez les Scopes (permissions) requis pour les points de terminaison de l’API que vous prévoyez d’utiliser.
   4. Définissez la date d’expiration Expires.
   5. Sauf exigence spécifique de votre organisation, vous pouvez ignorer le champ Ip Allowlist.
   6. Cliquez sur Ajouter l’octroi.

Important : Copiez immédiatement l’ID et le secret du client, car le secret ne sera plus affiché.

2. Récupérer le jeton du porteur

Une fois que vous avez vos informations d’identification, vous devez les échanger contre un jeton d’accès de courte durée en faisant une demande POST au service Workiva IAM.

• Point de terminaison : https ://api.app.wdesk.com (par défaut pour les États-Unis ; d’autres régions ont des points de terminaison différents).
• En-têtes : Set Content-Type to application/x-www-form-urlencoded.
• Body Parameters :
  • grant_type : client_credentials
  • client_id : [Votre identifiant client]
  • client_secret : [Votre secret client]
• Expiration : Les jetons de porteur Workiva sont généralement valides 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 pour le dépôt auprès de la SEC (EDGAR Next), ces jetons sont différents des jetons API standard :

• Ces jetons (Filer API Token et User Token) 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.