Product UpdatesStatus PageWorkato Academy
English
日本語
Get a trial
コネクター
アプリコネクター

Box ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Boxは、企業向けのクラウドコンテンツ管理およびファイル共有サービスです。 Boxプラットフォームにより、外出先でも安全かつ簡単にチームコラボレーションを行えます。

ユースケース ​

Boxコネクターをビジネスアプリケーションと統合して、コラボレーションとファイル管理を強化します。 ドキュメント共有を自動化し、承認ワークフローを改善し、プラットフォーム間でデータを安全に転送できます。 Boxワークフローを最適化する方法を確認するには、ユースケースをご覧ください:

APIバージョン ​

BoxコネクターはBox Rest API v2を使用します。

サポートされているエディションとバージョン ​

BoxコネクターはすべてのBoxプランで使用できます。

WorkatoでBoxに接続する方法 ​

Boxコネクターは、次の認証方法をサポートしています:

接続に必要なロールと権限 ​

Workatoの権限は、Boxで保持している権限と一致します。 つまり、Boxプラットフォームで保持しているファイルおよびフォルダの表示、共有、アップロード、ダウンロードの機能と同じ機能をWorkatoで使用できます。 詳細については、Boxの権限と許可を参照してください。

BOX更新トークン

Box更新トークンを使用すると、Boxの新しいアクセストークンを取得できます。 ただし、各Box更新トークンは60日間に1回のみ使用できます。 そのため、Boxへのアクティブなコネクションを維持していても、60日間Boxアクションを使用しない場合、Boxアクションを実行しようとするとエラーが発生します。

Box Refresh Tokensを使用してアクセスを管理する方法については、Boxドキュメントを参照してください。

認可コードグラント ​

認可コード付与認証を使用してBoxコネクションを設定するには、次の手順を実行します:

1

コネクション名フィールドに、Workatoが接続するBoxインスタンスを識別する名前を入力します。

Boxコネクション1コネクションを作成

2

Authentication typeドロップダウンメニューを使用して、Authorization code grantを選択します。

3

任意です。 Advanced settings（詳細設定）を展開して、Requested permissions (Oauth scopes)（要求された権限（OAuthスコープ））オプションを選択します。

次のスコープから選択できます:

  • ファイルとフォルダの読み取り
  • ファイルとフォルダの読み取りおよび書き込み
  • アプリユーザーの管理
  • 管理対象ユーザーの管理
  • グループの管理
  • Webhookの管理
  • エンタープライズプロパティの管理
  • 保持ポリシーの管理
  • グローバルコンテンツマネージャー
  • 管理者がユーザーに代わって呼び出しを実行可能
  • 署名リクエストの管理
  • Box Relayの管理
4

接続をクリックします。 これにより、Boxサインインダイアログが開きます。

5

Boxアカウントのメールアドレスとパスワードを入力します。

Boxコネクション2Boxにログイン

6

Authorizeをクリックします。

7

要求された権限を確認し、Boxへのアクセスを許可をクリックします。

Boxへのアクセスを許可Boxへのアクセスを許可

Client credentials ​

クライアント資格情報認証を使用してBoxコネクションを設定するには、次の手順を実行します:

1
カスタムアプリを作成します。
1

Boxアカウントにサインインします。

2

Dev Console > My Appsに移動します。

3

Create New Appをクリックします。

4

作成するアプリタイプとしてCustom Appを選択します。

5

App Nameフィールドにアプリ名を入力します。

6

Descriptionフィールドにアプリの説明を入力します。

7

PurposeドロップダウンメニューでAutomationを選択します。

8

次へをクリックします。

9

認証方法としてServer Authentication (Client Credentials Grant)（サーバー認証（クライアント資格情報付与））を選択します。

10

Create Appをクリックします。 これにより、Configurationタブが開きます。

2
必要な値を取得します。

管理者または管理対象ユーザーとして認証する場合は、Box Developer ConsoleでApp + Enterprise AccessとGenerate User Access Tokensを有効にする必要があります。

1

OAuth 2.0 Credentialsセクションまでスクロールし、Client IDをコピーします。 この値は、WorkatoでBoxコネクションを設定するために必要なため、安全に保管してください。

2

Fetch Client Secretをクリックします。 これにより、2-Step Verificationページが開きます。

3

認証アプリの6桁のコードをAuthentication Codeフィールドに入力します。 これにより、Client Secretフィールドが表示されます。

4

クライアントシークレットを取得するには、Copyをクリックします。 この値は、WorkatoでBoxコネクションを設定するために必要なため、安全に保管してください。

5

App Access Levelセクションまでスクロールし、App + Enterprise Accessを選択します。

6

Save Changesをクリックします。

7

General Settingsタブをクリックし、User IDまたはEnterprise IDのいずれかをコピーします。 認証のサブジェクトタイプが管理対象ユーザーの場合はUser IDを使用し、サービスアカウントの場合はEnterprise IDを使用します。 この値は、WorkatoでBoxコネクションを設定するために必要なため、安全に保管してください。

8

認証のサブジェクトタイプが管理対象ユーザーの場合は、Advanced Featuresに移動し、Generate user access tokensチェックボックスを選択して、Save changesをクリックします。

高度な機能の変更には再認可が必要

アプリの認可後にAdvanced Featuresで変更を行った場合は、Admin Consoleでアプリを再認可する必要があります。 Authorization > Review and Submit > Admin Console > Authorize Appに移動します。

3
認可のためにアプリを送信します。
1

Authorizationタブに移動し、Review and Submitをクリックします。

2

アプリ認可の送信内容を確認し、Submitをクリックします。

3

Back to My Accountをクリックします。

4
アプリを認可します。
1

Admin Console > Integrations > Platform Apps Managerに移動します。

2

認可のために送信したアプリにカーソルを合わせ、… Moreをクリックします。

3

Authorize Appを選択します。

4

情報を確認し、Authorizeをクリックします。

認可をスキップするとエラーが発生

このステップをスキップした場合、またはBox管理者による認可が承認されていない場合、コネクションは403 Forbiddenエラーを返します。 Workatoへの接続を試みる前に、Platform Apps ManagerでアプリのステータスがAuthorizedおよびEnabledと表示されていることを確認してください。

5

Workatoにサインインし、新しいBoxコネクションを作成します。

6

コネクション名フィールドに、Workatoが接続するBoxインスタンスを識別する名前を入力します。

Boxに接続クライアント資格情報認証を使用してBoxに接続

7

Locationドロップダウンメニューを使用して、コネクションを保存する予定のプロジェクトまたはフォルダを選択します。

8

認証タイプドロップダウンメニューで、クライアント認証情報を選択します。

9

Get required valuesステップで取得したクライアントIDをClient IDフィールドに入力します。

10

Get required valuesステップで取得したクライアントシークレットをClient secretフィールドに入力します。

11

Subject typeドロップダウンメニューでサブジェクトタイプを選択します。 使用可能なオプションには、Managed userとService accountがあります。

  • Managed user: Get required valuesステップで取得したユーザーIDをUser IDフィールドに入力します。
  • Service account: Get required valuesステップで取得したエンタープライズIDをEnterprise IDフィールドに入力します。
12

任意です。 このコネクションで使用する予定のCustom OAuth profilesをCustom OAuth profileフィールドで指定します。

13

接続をクリックします。

Boxでの添付ファイルの使用 ​

ファイルコンテンツのアップロード ​

このアクションを使用して、プレーンテキストファイルコンテンツをアップロードできます。

1

File Contentフィールドにファイルのテキストを入力します。

2

Boxにアップロードする予定のフォルダを選択します。

3

拡張子を含めて、ファイルの名前を入力します。

Box添付ファイル1ファイルコンテンツをアップロード

URLからファイルをアップロード ​

テキストコンテンツを入力する代わりに、URLから直接ファイルをアップロードできます。 これにより、画像などの非テキストファイルをアップロードできます。

1

アップロードする予定のファイルのURLをSource URLフィールドに入力します。 添付ファイルのURLは通常、ファイルの拡張子（.jpgなど）で終わります。

Box添付ファイル2URLからファイルをアップロード

2

ファイルをアップロードする予定のDestination folderを選択します。 デフォルトではWorkatoがURLからファイル名を取得するため、ファイル名の入力は任意です。

Create shared linkアクションを使用すると、Box内のファイルまたはフォルダへの直接リンクを作成できます。

1

共有リンクを作成する予定のファイル/フォルダのファイルID/フォルダIDを入力します。

2

共有リンクのアクセスレベル（Open、Company、コラボレーター、Default）を選択します。 詳細については、共有リンクの権限を参照してください。

  • これにより、共有リンクを使用してファイル/フォルダを表示できるユーザーに制限が設定されます。 Premium Boxサブスクリプションを利用している場合は、リンクユーザーがファイル/フォルダにアクセスする前に入力する必要があるパスワードも入力できます。

    Box添付ファイル3共有リンクを作成

3

任意です。 共有URLリンクを作成する際に、トリガーステップのIDStep 1データピルを使用して新しいファイルを識別し、次のスキーマでURLをSlack Workbotに投稿します。

Box共有リンク1Box共有リンク2Slack WorkbotにURLを投稿

Boxの権限と許可 ​

Boxロール権限 ​

Boxコネクターでは、Workatoへのコネクションに使用されるBoxアカウントで権限が付与されているアクションのみ実行できます。 次の表では、利用可能なBoxロール権限について説明します:

レベルアクセス
アップローダーコンテンツのアップロードと、フォルダ内の項目名の表示のみが可能です。 コンテンツを表示またはダウンロードできません。
プレビューアーフォルダ内の項目のプレビューのみが可能です。 コンテンツをアップロード、編集、削除、または共有できません。
ビューアーコンテンツのプレビュー/ダウンロード、コメントの作成、共有リンクの生成が可能です。 フォルダ内のアイテムに対して、タグの追加、新しいコラボレーターの招待、共有リンクの編集、アップロード、編集、または削除はできません。
プレビューアーアップローダーコンテンツのプレビュー、コメントの追加、タスクの追加、フォルダへのコンテンツのアップロードが可能です。 フォルダ内のアイテムに対して、タグの追加、共有リンクの生成、新しいコラボレーターの招待、または編集/削除はできません。
ビューアーアップローダーコンテンツのプレビュー、コンテンツのダウンロード、コメントの追加、共有リンクの生成、フォルダへのコンテンツのアップロードが可能です。 フォルダ内のアイテムに対して、タグの追加、新しいコラボレーターの招待、または削除はできません。 手動またはBox Editを使用して、同じ名前でファイルをダウンロード、編集、再アップロードすることは引き続き可能です。
エディターコンテンツの表示、ダウンロード、アップロード、編集、削除、コピー、移動、名前変更が可能です。 共有リンクの生成/編集、コメントの作成、タスクの割り当て、タグの作成、コラボレーターの招待/削除も可能です。 ルートレベルのフォルダを削除または移動できません。
共同所有者エディターのすべての権限を持ちます。 フォルダ内のユーザーの管理も可能です: 新しいコラボレーターの追加、コラボレーターのアクセスレベルの変更、コラボレーターの削除。
所有者フルアクセス。

Box内のファイルまたはフォルダの共有リンクを作成する際は、以下に示すように、アクセスレベルについて4つのオプションから選択できます。

レベルアクセス
オープンリンクを知っている全員がファイルまたはフォルダにアクセスできます。 Boxアカウントは不要です。
会社会社のドメインと一致する検証済みメールアドレスを持つBoxユーザーのみが、共有リンクを介してファイルまたはフォルダにアクセスできます。
コラボレーターフォルダまたはファイルに招待されたBoxユーザー（コラボレーター）のみが、共有リンクを介してファイルまたはフォルダにアクセスできます。
デフォルトこのオプションは、アカウントのデフォルト設定に従います。 これは、Boxアカウント設定のContent and Sharingで表示および変更できます。

Last updated: