|
Klasyczne typy plików nie są już dostępne od stycznia 2021 r. Możesz przenieść swoje klasyczne pliki lub pobrać plik PDF. Dowiedz się więcej

Centrum wsparcia Workiva

CLP – Generowanie tokena dostępu

CLP – Generowanie tokena dostępu

  • Ostatnia aktualizacja

W systemie Workiva generowanie tokena dostępu (konkretnie tokena okaziciela OAuth2) to proces dwuetapowy: najpierw tworzysz API Grant, aby uzyskać dane uwierzytelniające, a następnie używasz tych danych uwierzytelniających, aby zażądać faktycznego tokena.

1. Utwórz grant API

Ważne: Aby wykonać ten krok, musisz być właścicielem obszaru roboczego.

Aby uzyskać identyfikator klienta i klucz tajny:

  1. Kliknij ikonę swojego identyfikatora w prawym górnym rogu strony Workiva, a następnie wybierz opcję Ustawienia obszaru roboczego .
  2. Wybierz kartę Bezpieczeństwo , a następnie kliknij opcję Utwórz przyznanie API .
  3. Na stronie Aktualizacja dotacji wypełnij następujące pola:
    1. Wprowadź nazwę klienta i nazwęużytkownika Workiva, w imieniu których będzie działać grant.
    2. Jako typ klienta wybierz „Dane uwierzytelniające klienta OAuth2”.
    3. Wybierz wymagane zakresy (uprawnienia) dla punktów końcowych interfejsu API, których planujesz używać.
    4. Ustaw datę wygaśnięcia .
    5. Jeśli Twoja organizacja nie wymaga inaczej, możesz zignorować pole Lista dozwolonych adresów IP .
    6. Kliknij Dodaj dotację .
Ważne: Natychmiast skopiuj identyfikator klienta i tajny klucz klienta, ponieważ tajny klucz nie będzie już wyświetlany.

 

2. Odzyskaj token okaziciela

Po uzyskaniu danych uwierzytelniających należy wymienić je na krótkotrwały token dostępu, wysyłając żądanie POST do usługi Workiva IAM.

  • Punkt końcowy: https://api.app.wdesk.com (domyślny dla USA, inne regiony mają inne punkty końcowe ).
  • Typ zawartości: Ustaw Content-Type na application/json .
  • Nagłówki: Dodaj wersję X : 2026-01-01
  • Wartości formularza:
    • grant_type : poświadczenia_klienta
    • identyfikator_klienta :[Your Client ID]
    • sekret_klienta :[Your Client Secret]
    • Zakres : Łańcuchy
  • Ważność: Tokeny okaziciela Workiva są zazwyczaj ważne przez 10 minut. W przypadku długotrwałych procesów należy je okresowo odświeżać.

Tokeny SEC EDGAR Next

Jeśli generujesz tokeny specjalnie na potrzeby zgłoszeń do SEC (EDGAR Next) , różnią się one od standardowych tokenów API:

  • Te tokeny (token API Filer i token użytkownika) są tworzone na pulpicie EDGAR Filer Management SEC.
  • Po uzyskaniu tokenów możesz nimi zarządzać w systemie Workiva, w obszarze Raportowanie SEC > Zarządzaj tokenami EDGAR Next.
W systemie Workiva generowanie tokena dostępu (konkretnie tokena okaziciela OAuth2) to proces dwuetapowy: najpierw tw...