Basic Guide

Creating a Box service account

Creating a Box service account

You must have a Box service account to use Box from BLOCKS.

A Box service account is created automatically when you make a Box app from the Box Dev Console.

The following steps explain how to create a Box app (steps 1–3) and register your Box service account into BLOCKS (step 4).

  1. Prepare a Box account
  2. Create a Box app from the Box Dev Console
  3. Authorize the Box app from the Box Admin Console
  4. Register the Box service account into BLOCKS

1. Prepare a Box account

You will need to have a Box account with two-factor verification enabled in order to use Box from BLOCKS.

If you don't have a Box account, create one by clicking Sign Up from https://www.box.com/home

Log into https://app.box.com . If your account does not have two-factor verification enabled, complete the following:

  1. Click your user icon in the upper-right and select Account Settings.

    Box profile menu

    (The user icon varies by user.)

  2. Scroll to the Authentication section and click Require 2-factor verification for unrecognized logins.

    Box 2-factor verification
  3. On the Enable Login Verification screen, select your Country, enter your Mobile Phone Number and click Continue.

    Box 2-step verification step 1
  4. Enter the Box verification code that is sent to your mobile phone number and click Continue.

    Box 2 段階認証設定ステップ 2
  5. Enter the second Box verification code sent to your mobile phone (different from the first code) on the Using a New Device? screen and click Submit.

    Box 2 段階認証設定ステップ 3

2. Create a Box app from the Box Dev Console

To create your Box app, do the following:

  1. Access https://account.box.com/developers/services and log in with your Box account.

  2. Click Create New App.

  3. On the screen to select the type of app, select Custom App and click Next.

    Box アプリの種類選択
  4. On the Authentication Method screen, select OAuth 2.0 with JWT (Server Authentication) and click Next.

    Box アプリの認証方法選択
  5. Enter a name for your app and click Create App.

    Box アプリの名前設定
  6. You will see a page for using a developer token to access your folder list. We won't use this token, so ignore the directions on the page and click View Your App.

    Box アプリの表示
  7. You will be taken to the Configuration page for your new app.

  8. Scroll to the OAuth 2.0 Credentials section and find your Client ID.

    Box Developers OAuth 2.0 情報

    You will use this Client ID to authorize your app on the Admin Console. Click COPY next to the Client ID to copy it to your clipboard.

  9. Scroll to the Application Access section and select Enterprise.

    Box Developer アプリケーションアクセス
  10. Scroll to the Advanced Features section and turn on Perform Actions as Users and Generate User Access Tokens.

    Box Developers 高度な機能
  11. Scroll to the Add and Manage Public Keys section, click Generate a Public/Private Keypair, and a file will begin to download.

    Box Developers 公開キー
    • You will use this file in BLOCKS. It will not be saved in Box, so save it someplace safe.
    • Click OK on the file download screen.
  12. Click Save Changes in the upper-right of the page.

3. Authorize the Box app from the Box Admin Console

Do the following to authorize your Box app:

  1. Access the Admin Console at https://app.box.com/master .

  2. Click the gear icon in the upper-right and select Business Settings.

    管理コンソールメニュー
  3. Click the Apps tab.

    管理コンソールの Business 設定画面
  4. Scroll to Custom Applications and click Authorize New App.

    Box 管理コンソールのカスタムアプリ設定
  5. On the App Authorization page, enter your app’s Client ID into the API Key field.

    Box 管理コンソールのアプリ認証

    If you copied your Client ID from the Dev Console, simply paste it here.

  6. Click Next.

    Box 管理コンソールのアプリの承認
  7. Confirm that the app you added is listed in Custom Applications. If your app’s Application Access is set to Enterprise, you should see All Users in the Access column.

    Box 管理コンソールのカスタムアプリのアクセス確認
    1. If you see Only App Users of this App in the Access column, go to the Dev Console and change the following settings:

      1. Set Application Access to Enterprise.
      2. Under Advanced Features, turn on Perform Actions as Users and Generate User Access Tokens.
    2. Click in the Actions column, and select Reauthorize App. Click Authorize on the App Authorization page.

      Box 管理コンソールのアプリの再承認
    3. Confirm that the Access column now shows All Users.

4. Register the Box service account into BLOCKS

Follow the steps below to register your Box service account into BLOCKS. The file you downloaded from the Box Dev Console contains information for your Box service account. You will register this file into BLOCKS.

  1. Open a Flow Designer.

  2. Click Settings.

  3. Select Box service accounts from the sidebar.

    Box service accounts list
  4. Click Add.

  5. Drop the file into the gray box or click Select File.

    Adding new Box service accounts
  6. Click Add.

You can now use Box from BLOCKS.