API キーの管理

最終更新日： 2025年2月7日
  • トピック：

作成対象：

  • 管理者

API セキュリティ脆弱性を最小限に抑えるために、Adobe Workfront 管理者は、アプリケーションがユーザーに代わって Workfront へのアクセスに使用される API キーを管理できます。

現在の管理者 API キーのリセットまたは削除、API キーを期限切れに設定、すべてのユーザーの API キーの削除を行うことができます。

Workfront API を活用するアプリケーションの例を次に示します。

  • Dropbox、Google Drive、Workfront DAM などのドキュメントの統合
  • Workfront モバイルアプリケーション
IMPORTANT
API キーをリセットまたは削除する場合、Workfront API を利用し、この API キーを介して Workfront に対して認証するアプリケーションは、Workfront へのアクセス権を取り戻すために再設定する必要があります。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事の手順を実行するには、次のアクセス権が必要です。

Adobe Workfront プラン任意
Adobe Workfront プランプラン
アクセスレベル設定

Workfront 管理者である必要があります。

メモ：まだアクセス権がない場合は、アクセスレベルに追加の制限が設定されていないかどうか Workfront 管理者にお問い合わせください。Workfront 管理者がアクセスレベルを変更する方法について詳しくは、カスタムアクセスレベルの作成または変更を参照してください。

Workfront API キー

Workfront のそれぞれのユーザーが、一意の API キーを持っています。このキーは、ユーザーが Workfront API（Workfront モバイルアプリやドキュメント統合など）を活用する統合にアクセスする際に、ユーザーごとに生成されます。

NOTE
実稼動環境で生成した API キーは、毎週の更新中にプレビュー環境にコピーされます。プレビュー環境で生成した API キーは、毎週の更新中に実稼動用 API キーで上書きされます。

Workfront 管理者には一意の API キーが割り当てられています。アプリケーションが管理者 API キーを使用して Workfront にアクセスすると、アプリケーションは Workfront への管理アクセス権を持つことになります。

管理者 API キーの管理

管理者ユーザーアカウントの API キーを生成、リセットまたは削除することができます。

NOTE
API を使用して API キーを生成することもできます。詳しくは、イベント登録 API にあるイベント登録 API の節を参照してください。

  1. Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、または（使用可能な場合）左上隅にある​ メインメニュー ​アイコン メインメニュー 、「設定」 設定アイコン の順にクリックします。

  2. システム／顧客情報 ​をクリックします。

  3. （条件付き）次のアクションのいずれかを実行します。

    API キーを生成するには、「API キーを設定」セクションで、「API キーを生成」をクリックします。

    または
    API キーをリセットするには：「API キーの設定」セクションで、「リセット」をクリックし、次に「リセット」をクリックします。

    または

    API キーを削除するには、「API キーの設定」セクションで、「削除 ​をクリックし、「削除」をクリックします。

管理者以外のユーザー向けの API キーの生成

Workfront 管理者以外の役割を持つユーザーの API キーを生成および管理できます。

NOTE
組織の Workfront インスタンスが Adobe IMS によって有効化されている場合は使用できません。詳細情報が必要な場合は、ネットワークまたは IT 管理者にお問い合わせください。

  1. （条件付き）組織がシングルサインオン（SSO）アクセス管理を使用している場合、SSO 認証を必要とするオプションを一時的に無効にします。

  2. Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、または（使用可能な場合）左上隅にある​ メインメニュー ​アイコン メインメニュー 、「設定」 設定アイコン の順にクリックします。

    1. システム ​を展開し、次に「シングルサインオン（SSO）」をクリックします。

    2. タイプ フィールドで、組織が使用する SSO のタイプを選択します。

    3. タイプを選択した状態で、下にスクロールして「有効」チェックボックスをオフにします。

      SSO を有効にする

    4. 保存 ​をクリックします。

  3. ブラウザーのアドレスバーに、次の API 呼び出しを入力します。

    <domain>.my.workfront.com/attask/api/v7.0/user?action=generateApiKey&username= ​username​ &password= ​password**&method=PUT

    <domain> を Workfront ドメイン名に置き換え、ユーザー名とパスワードをユーザーの Workfront 資格情報に置き換えます。

  4. （条件付き）手順 1 で SSO 認証を要求するオプションを無効にした場合は、これを有効にします。

  5. Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、または（使用可能な場合）左上隅にある​ メインメニュー ​アイコン メインメニュー 、「設定」 設定アイコン の順にクリックします。

    1. システム ​を展開し、次に「シングルサインオン（SSO）」をクリックします。

    2. タイプ ​ドロップダウンメニューで、「SSO メソッド」を選択します。。

    3. SSO 認証が必要なチェックボックスをオンにします。