18. Connectors

Part 18

/admin/connectors · QuantaDrive scope. Enables the third-party import connectors. Until you enable Box here, every user sees Box is not available yet — Your administrator needs to enable Box in Admin → Connectors.

The admin Connectors page with the Box configuration fields.

Admin Connectors. Until Box is enabled here, users see Box is not available yet.

18.1. Setting up Box

The page offers Save config and Test for the connection, and separate Disable JWT and Disable OAuth controls for the two ways Box can authenticate — the server-to-server JWT app, and the per-user OAuth sign-in that backs My Box account.

  1. Create an app in the Box developer console

    You need it to obtain the client credentials below.

  2. Enter the Client ID

    Labelled Box app Client ID.

  3. Enter the client secret

    From the same Box app.

  4. Register the Redirect URI on the Box app

    The screen shows it read-only, e.g. https://drive.example.com/api/v1/connectors/box/callback — it comes from this deployment’s public address and cannot be edited. Copy it into the Box Developer Console under Configuration → OAuth 2.0 Redirect URIs. If it is missing there, users get Box’s “redirect_uri_mismatch” error when they connect.

  5. Set the Scopes

    e.g. root_readwrite. Grant the least that the import needs.

  6. Choose how files are read

    The Read files as setting determines whose permissions apply during import. Leave blank for service account uses the app’s own identity instead of an individual’s.

  7. Save and enable

    Then test with your own account before telling users it is available.