Centro assistenza di Workiva

In Workiva, la generazione di un token di accesso (in particolare un token OAuth2 bearer) avviene in due fasi: prima crei un API Grant per ottenere le credenziali, poi le usi per richiedere il token vero e proprio.

1. Creare una sovvenzione API

Importante: per eseguire questa operazione è necessario essere il proprietario dello spazio di lavoro.

Per ottenere un ID e un segreto del cliente:

1. Fai clic sull'icona del tuo ID nell'angolo in alto a destra della pagina di Workiva, quindi seleziona " Impostazioni dell'area di lavoro ".
   
2. Seleziona la scheda " Sicurezza ", quindi fai clic su " Crea autorizzazione API ".
   
3. Nella pagina "Aggiorna sovvenzione ", compila i seguenti campi:
   
   1. Inserisci il nome del cliente e il nome utente Workiva per conto del quale verrà concessa l'autorizzazione.
   2. Selezionare "Credenziali client OAuth2" come tipo di client .
   3. Seleziona gli ambiti ( autorizzazioni) richiesti per gli endpoint API che intendi utilizzare.
   4. Imposta la data di scadenza .
   5. A meno che non sia espressamente richiesto dalla propria organizzazione, è possibile ignorare il campo " Ip Allowlist ".
   6. Fare clic su " Aggiungi sovvenzione ".

Importante: copia subito l'ID cliente e il segreto cliente, poiché il segreto non verrà più visualizzato.

2. Recupera il token del portatore

Una volta ottenute le credenziali, è necessario sostituirle con un token di accesso a breve durata inviando una richiesta POST al servizio IAM di Workiva.

• Endpoint: https://api.app.wdesk.com (questo è l'endpoint predefinito per gli Stati Uniti; altre regioni hanno endpoint diversi ).
• Tipo di contenuto: Impostare Content-Type su application/json .

• 

• Intestazioni: Aggiungi X-Version : 2026-01-01

• 

• Valori dei campi:
  • grant_type : credenziali_cliente
  • client_id :[Your Client ID]
  • client_secret :[Your Client Secret]
  • Ambito di applicazione : catene

• 

• Scadenza: i token al portatore di Workiva hanno in genere una validità di 10 minuti. Devi aggiornarli periodicamente per i processi di lunga durata.

Token SEC EDGAR Next

Se si generano token specificamente per la presentazione dei documenti alla SEC (EDGAR Next) , questi sono diversi dai token API standard:

• Questi token (token API del dichiarante e token utente) vengono creati nella dashboard "EDGAR Filer Management " della SEC.
• Una volta ottenuti, puoi gestirli in Workiva alla voce SEC Reporting > Manage EDGAR Next Tokens.