Workiva-ondersteuningscentrum

In Workiva is het genereren van een toegangstoken (specifiek een OAuth2 bearer token) een proces in twee stappen: eerst maak je een API Grant aan om de benodigde referenties te verkrijgen, en vervolgens gebruik je die referenties om het daadwerkelijke token aan te vragen.

1. Maak een API-toekenning aan.

Belangrijk: U moet een werkruimte-eigenaar zijn om deze stap uit te voeren.

Om een ​​client-ID en -geheim te verkrijgen:

1. Klik op je ID-pictogram in de rechterbovenhoek van de Workiva-pagina en selecteer vervolgens Werkruimte-instellingen .
   
2. Selecteer het tabblad Beveiliging en klik vervolgens op API-toekenning maken .
   
3. Vul op de pagina 'Subsidie ​​bijwerken ' de volgende velden in:
   
   1. Voer een klantnaam en de Workiva-gebruikersnaam in namens wie de subsidie ​​zal worden verstrekt.
   2. Selecteer "OAuth2-clientreferenties" als clienttype .
   3. Selecteer de vereiste scopes (machtigingen) voor de API-eindpunten die u wilt gebruiken.
   4. Stel de vervaldatum in.
   5. Tenzij uw organisatie dit specifiek vereist, kunt u het veld 'IP-toegangslijst' negeren.
   6. Klik op Subsidie ​​toevoegen .

Belangrijk: Kopieer de Client ID en Client Secret direct, want de secret wordt niet meer getoond.

2. Haal het Bearer Token op

Zodra je je inloggegevens hebt, moet je deze inwisselen voor een kortstondig toegangstoken door een POST- verzoek naar de Workiva IAM-service te sturen.

• Eindpunt: https://api.app.wdesk.com (dit is het standaard eindpunt voor de VS; andere regio's hebben andere eindpunten ).
• Inhoudstype: Stel Content-Type in op application/json .

• 

• Kopteksten: X-versie toevoegen: 2026-01-01

• 

• Formulierwaarden:
  • grant_type : client_credentials
  • client_id :[Your Client ID]
  • client_secret :[Your Client Secret]
  • Bereik : Kettingen

• 

• Vervaldatum: Workiva bearer tokens zijn doorgaans 10 minuten geldig. Voor langlopende processen moet u ze periodiek vernieuwen.

SEC EDGAR Next-tokens

Als u tokens genereert specifiek voor SEC-aanmelding (EDGAR Next) , dan zijn deze anders dan standaard API-tokens:

• Deze tokens (Filer API Token en User Token) worden aangemaakt op het EDGAR Filer Management-dashboard van de SEC.
• Zodra je ze hebt verkregen, kun je ze beheren in Workiva onder SEC Reporting > Manage EDGAR Next Tokens.