Workiva サポートセンター

Workivaでは、アクセストークン（特にOAuth2ベアラートークン）を生成するプロセスは2ステップです。まずAPI Grantを作成して認証情報を取得し、その認証情報を使用して実際のトークンを依頼します。

1.API グラントの作成

重要:このステップを実行するには、ワークスペース所有者である必要があります。

クライアント ID とシークレットを取得するには：

1. Workiva ページ右上の ID アイコンをクリックし、ワークスペース設定 を選択します。
   
2. Security タブを選択し、Create API Grant をクリックします。
   
3. 助成金の更新ページで、以下のフィールドに入力します：
   
   1. クライアント名称 およびWorkiva ユーザー名 を入力します。
   2. Client Type として "OAuth2 Client Credentials" を選択します。
   3. 使用する予定の API エンドポイントに必要なスコープ （権限）を選択します。
   4. Expires の日付を設定します。
   5. 組織から特に要求されない限り、Ip Allowlist フィールドは無視してかまいません。
   6. 付与を追加をクリックします。

重要: シークレットは二度と表示されないので、クライアント ID とクライアントシークレットを直ちにコピーしてください。

2.ベアラートークンの取得

認証情報を取得したら、Workiva IAM サービスにPOST リクエストを行うことで、短期間のアクセストークンと交換する必要があります。

• エンドポイント: https://api.app.wdesk.com (米国ではデフォルトです。その他の地域ではエンドポイントが異なります。)。
• ヘッダー： ヘッダ：Content-Type からapplication/x-www-form-urlencoded を設定します。
• 本文パラメータ：
  • grant_type:client_credentials
  • client_id ：[あなたのクライアントID]。
  • client_secret: [あなたのクライアントシークレット]。
• 有効期限： Workiva ベアラ・トークンは通常 10 分間有効です。長時間実行するプロセスでは、定期的に更新する必要があります。

SEC EDGAR化トークン

SEC ファイリング (EDGAR 次へ) 専用にトークンを生成する場合、これらは標準 API トークンとは異なります：

• これらのトークン (Filer API Token および User Token) は、SEC のEDGAR Filer Management ダッシュボード で作成されます。
• 取得後は、Workiva の SEC Reporting > Manage EDGAR Next Tokens で管理できます。