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 questo passaggio devi essere il proprietario di uno spazio di lavoro.

Per ottenere un ID e un segreto del cliente:

1. Clicca sull'icona del tuo ID nell'angolo in alto a destra della pagina di Workiva e poi seleziona Impostazioni dello spazio di lavoro.
   
2. Seleziona la scheda Security e poi clicca su Create API Grant.
   
3. Nella pagina Update Grant completa i seguenti campi:
   
   1. Inserisci un Nome Cliente e un Nome Utente Workiva per il quale la sovvenzione agirà.
   2. Seleziona "OAuth2 Client Credentials" come Tipo di cliente.
   3. Seleziona i Scopes (permessi) richiesti per gli endpoint API che intendi utilizzare.
   4. Imposta la data Expires.
   5. A meno che non sia specificamente richiesto dalla tua organizzazione, puoi ignorare il campo Ip Allowlist.
   6. Clicca su Aggiungi concessione.

Importante: Copia immediatamente l'ID del cliente e il Segreto del cliente, poiché il segreto non verrà più visualizzato.

2. Recupera il token del portatore

Una volta ottenute le credenziali, devi scambiarle con un token di accesso di breve durata effettuando una richiesta POST al servizio Workiva IAM.

• Endpoint: https://api.app.wdesk.com (il valore predefinito per gli Stati Uniti; altre regioni hanno endpoint diversi).
• Intestazioni: Imposta Content-Type a application/x-www-form-urlencoded.
• Parametri del corpo:
  • grant_type: client_credentials
  • client_id: [ID del cliente]
  • client_secret: [Segreto del cliente]
• Scadenza: I token bearer di Workiva hanno una validità tipica di 10 minuti. Devi aggiornarli periodicamente per i processi di lunga durata.

Token SEC EDGAR Next

Se stai generando token specifici per il deposito SEC (EDGAR Next), questi sono diversi dai token API standard:

• Questi token (Filer API Token e User Token) vengono creati sul cruscotto della SEC EDGAR Filer Management.
• Una volta ottenuti, puoi gestirli in Workiva alla voce SEC Reporting > Manage EDGAR Next Tokens.