Workivaでは、アクセストークン(特にOAuth2ベアラートークン)を生成するプロセスは2ステップです。まずAPI Grantを作成して認証情報を取得し、その認証情報を使用して実際のトークンを依頼します。
1.API グラントの作成
重要: この手順を実行するには、ワークスペースの所有者である必要があります 。
クライアント ID とシークレットを取得するには:
- Workiva ページの右上にある ID アイコンをクリックし、「ワークスペース設定」を選択してください。
- [セキュリティ] タブを選択し、[API グラントの作成] をクリックします。
- 「助成金の更新」ページで 、以下の項目を入力してください:
- クライアント名と、この権限付与の対象となるWorkivaのユーザー名を入力してください。
- クライアントタイプとして「OAuth2 クライアント認証情報」を選択してください。
- 使用する予定のAPIエンドポイントに対して、必要なスコープ( 権限)を選択してください。
- 有効期限を設定してください。
- 所属組織から特に指示がない限り、「Ip Allowlist」フィールドは無視して構いません。
- [助成金の追加] をクリックします。
重要:クライアントIDとクライアントシークレットは、シークレットは二度と表示されないため、直ちにコピーしてください。
2.ベアラートークンの取得
認証情報を取得したら、Workiva IAM サービスに対してPOSTリクエストを送信し、それらを短期間有効なアクセストークンと交換する必要があります。
- エンドポイント:
https://api.app.wdesk.com(これは米国向けのデフォルト設定です。その他の地域では異なるエンドポイントが使用されます)。 - コンテンツタイプ:
Content-Typeをapplication/jsonに設定してください 。 - ヘッダー:
X-Version:2026-01-01を追加 - フォームの値:
-
grant_type:client_credentials -
client_id:[Your Client ID] -
client_secret:[Your Client Secret] -
対象範囲:チェーン
-
- 有効期限:Workivaの無記名トークンの有効期間は、通常10分間です。長時間実行するプロセスでは、定期的に更新する必要があります。
SEC EDGAR化トークン
SECへの提出(EDGAR Next)専用にトークンを生成する場合、これらは標準のAPIトークンとは異なります:
- これらのトークン(Filer API トークンおよびユーザートークン)は、SECのEDGAR Filer Managementダッシュボード上で作成されます。
- 取得後は、Workiva の SEC Reporting > Manage EDGAR Next Tokens で管理できます。