I Workiva er generering av et tilgangstoken (spesifikt et OAuth2-bærertoken) en totrinnsprosess: du oppretter først en API-grant for å få legitimasjon, og bruker deretter disse legitimasjonene til å be om selve tokenet.
1. Opprett et API-tilskudd
Viktig: Du må være arbeidsområdeeier for å utføre dette trinnet.
For å få en klient-ID og hemmelighet:
-
Klikk på ID-ikonet ditt øverst til høyre på Workiva-siden, og velg deretter Arbeidsområdeinnstillinger .
- Velg Sikkerhet- fanen, og klikk deretter på Opprett API-tildeling .
- På siden Oppdater tilskudd , fyll ut følgende felt:
- Skriv inn et klientnavn og Workiva-brukernavnet som tilskuddet skal handle på vegne av.
- Velg «OAuth2-klientlegitimasjon» som klienttype .
- Velg de nødvendige omfangene (tillatelsene) for API-endepunktene du planlegger å bruke.
- Angi utløpsdatoen .
- Med mindre organisasjonen din spesifikt krever det, kan du ignorere feltet for tillatelsesliste for IP-adresser .
- Klikk på Legg til tilskudd .
Viktig: Kopier klient-ID-en og klienthemmeligheten umiddelbart, da hemmeligheten ikke vil vises igjen.
2. Hent bærertokenet
Når du har fått legitimasjonen din, må du bytte den mot et kortvarig tilgangstoken ved å sende en POST- forespørsel til Workiva IAM-tjenesten.
- Endepunkt:
https://api.app.wdesk.com(er standard for USA; andre regioner har andre endepunkter ). -
Innholdstype:Sett innholdstypen til application/json . - Overskrifter: Legg til
X-versjon:2026-01-01 - Skjemaverdier:
-
: klientlegitimasjontilskuddstype -
klient_id :[Your Client ID] -
klient_hemmelighet :[Your Client Secret] -
Omfang: Kjeder
-
- Utløpsdato: Workiva-bærertokener er vanligvis gyldige i 10 minutter. Du må oppdatere dem med jevne mellomrom for langvarige prosesser.
SEC EDGAR Neste-tokens
Hvis du genererer tokener spesielt for SEC-innlevering (EDGAR Next) , er disse forskjellige fra standard API-tokener:
- Disse tokenene (Filer API Token og User Token) opprettes på SECs EDGAR Filer Management-dashbord .
- Når du har fått dem, kan du administrere dem i Workiva under SEC Reporting > Administrer EDGAR Next Tokens.