Workiva-ondersteuningscentrum

In Workiva is het genereren van een toegangstoken (specifiek een OAuth2 token) een proces in twee stappen: u maakt eerst een API Grant aan om referenties te verkrijgen, en gebruikt die referenties vervolgens om het eigenlijke token aan te vragen.

1. Een API-subsidie aanmaken

Belangrijk: U moet Workspace Owner zijn om deze stap uit te voeren.

Om een Client ID & Secret te verkrijgen:

1. Klik op uw ID-pictogram in de rechterbovenhoek van de Workiva-pagina en selecteer vervolgens Werkruimte-instellingen.
   
2. Selecteer het tabblad Beveiliging en klik vervolgens op API-subsidie aanmaken.
   
3. Vul de volgende velden in op de pagina Subsidie bijwerken :
   
   1. Voer een Klantnaam en de Workiva Gebruikersnaam in waar de subsidie namens zal handelen.
   2. Selecteer "OAuth2 Client Credentials" als het Client Type.
   3. Selecteer de vereiste Scopes (machtigingen) voor de API endpoints die u van plan bent te gebruiken.
   4. Stel de datum Expires in.
   5. Tenzij dit specifiek vereist wordt door uw organisatie, kunt u het veld Ip Allowlist negeren.
   6. Klik op Subsidie toevoegen.

Belangrijk: Kopieer de Client ID en het Client Secret onmiddellijk, want het geheim wordt niet meer getoond.

2. Het draagtoken ophalen

Zodra u uw referenties hebt, moet u ze uitwisselen voor een kortstondig toegangstoken door een POST verzoek in te dienen bij de Workiva IAM dienst.

• Eindpunt: https://api.app.wdesk.com (dit is de standaard voor de VS; andere regio's hebben andere eindpunten).
• Kopteksten: Stel Content-Type in op application/x-www-form-urlencoded.
• Lichaamsparameters:
  • grant_type: client_credentials
  • client_id: [Uw klant-ID]
  • client_secret: [Uw klantgeheim]
• Vervaldatum: Workiva tokens aan toonder zijn meestal 10 minuten geldig. U moet ze periodiek verversen voor langlopende processen.

SEC EDGAR Volgende tokens

Als u tokens genereert specifiek voor SEC filing (EDGAR Next), zijn deze verschillend van standaard API tokens:

• Deze tokens (Filer API Token en User Token) worden aangemaakt op het SEC's EDGAR Filer Management dashboard.
• Eenmaal verkregen, kunt u ze in Workiva beheren onder SEC Reporting > Manage EDGAR Next Tokens.