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