Workiva Support Center

In Workiva erfolgt die Erstellung eines Zugriffstokens (insbesondere eines OAuth2-Tokens) in zwei Schritten: Sie erstellen zunächst eine API-Grant, um Anmeldedaten zu erhalten, und verwenden diese dann, um das eigentliche Token anzufordern.

1. Erstellen Sie eine API-Berechtigung

Wichtig: Sie müssen Workspace-Besitzer sein, um diesen Schritt ausführen zu können.

Um eine Client ID & Secret zu erhalten:

1. Klicken Sie auf Ihr Profil-Symbol in der oberen rechten Ecke der Workiva-Seite und wählen Sie anschließend „Arbeitsbereichseinstellungen“ aus.
   
2. Wählen Sie die Registerkarte „Sicherheit “ aus und klicken Sie anschließend auf „API-Berechtigung erstellen “.
   
3. Füllen Sie auf der Seite „Zuschuss aktualisieren “ die folgenden Felder aus:
   
   1. Geben Sie einen Kundennamen und den Workiva-Benutzernamen ein, in dessen Namen die Berechtigung erteilt werden soll.
   2. Wählen Sie als Client-Typ „OAuth2-Client-Anmeldedaten“ aus.
   3. Wählen Sie die erforderlichen Berechtigungsbereiche (Scopes ) für die API-Endpunkte aus, die Sie nutzen möchten.
   4. Legen Sie das Ablauf datum fest.
   5. Sofern dies nicht ausdrücklich von Ihrer Organisation vorgeschrieben ist, können Sie das Feld „IP-Zulassungsliste“ ignorieren.
   6. Klicken Sie auf „Zuschuss hinzufügen “.

Wichtig: Kopieren Sie die Client-ID und den Client-Secret sofort, da der Secret nicht erneut angezeigt wird.

2. Abrufen des Bearer Token

Sobald Sie Ihre Anmeldedaten erhalten haben, müssen Sie diese gegen ein kurzlebiges Zugriffstoken eintauschen, indem Sie eine POST- Anfrage an den Workiva-IAM-Dienst senden.

• Endpunkt: https://api.app.wdesk.com (dies ist der Standard für die USA; für andere Regionen gelten andere Endpunkte ).
• Inhaltstyp: Setzen Sie „Content-Type “ auf „application/json “.

• 

• Header: X-Version hinzufügen : 01 . 01.2026

• 

• Formularwerte:
  • grant_type : client_credentials
  • client_id :[Your Client ID]
  • client_secret :[Your Client Secret]
  • Geltungsbereich : Ketten

• 

• Gültigkeitsdauer: Workiva-Inhabertoken sind in der Regel 10 Minuten lang gültig. Bei lang laufenden Prozessen müssen Sie diese regelmäßig aktualisieren.

SEC EDGAR Next-Tokens

Wenn Sie Token speziell für die Einreichung bei der SEC (EDGAR Next) generieren, unterscheiden sich diese von den Standard-API-Token:

• Diese Token (Filer-API-Token und Benutzer-Token) werden im EDGAR-Filer-Management-Dashboard der SEC erstellt.
• Sobald Sie diese erhalten haben, können Sie sie in Workiva unter SEC Reporting > Manage EDGAR Next Tokens verwalten.