Box Authenticator

This node authenticates against Box. The resulting credential can then be used with the Box Connector node. The following authentication methods are supported:

We recommend to use User authentication for interactive workflow building and Server authentication for deployed workflows (e.g. schedules or data apps). For further details on which authentication method to select see the Box documentation.

To use User authentication, you can either use the Default App or create and use a Custom App. The Default App is provided by KNIME via the Box Marketplace. To use the Default App simply select Default as client/app and, when asked, grant the KNIME Analytics Platform access to Box. To use a Custom App you need to first create and approve a Custom App in Box. The steps are as follows:

  • Create a Custom App in Box. While creating the app choose OAuth 2.0 as the authentication method.
  • Configure the app as follows: Set OAuth 2.0 Redirect URI = http://localhost, and Application Scopes = Write all files and folders stored in Box.
  • Request approval of your app as described here.
  • As soon as a Box admin has approved your app it can be used in KNIME.

To use Server authentication, you need to first create and approve a Custom App in Box. The steps are as follows:

  • Create a Custom App in Box. While creating the app choose Client Credentials Grant as the authentication method.
  • Configure the app as follows: Set Access Level = App + Enterprise Access (to be able to access files/folders of your Box enterprise), and Application Scopes = Write all files and folders stored in Box.
  • Request approval of your app as described here.
  • As soon as a Box admin has approved your app it can be used in KNIME.

Note: If User authentication is selected, the node can currently only be executed in KNIME Analytics Platform, i.e. execution on KNIME Hub, KNIME Server, or via Remote Workflow Editor will fail. Authentication via Server authentication works in all cases. If you have a KNIME Hub account you can centrally manage and share your Box secrets. For further details see the KNIME Secrets User Guide.

Options

Authentication type
Authentication type to use. The following types are supported:
Which client/app to use
Whether to use the KNIME default app, or enter a custom one. The KNIME default app is called "KNIME Analytics Platform".
Client/App configuration
The app/client ID and secret of the custom Box app. These fields can be found in the configuration settings of your custom Box app.
Redirect URL (should be http://localhost:XXXXX)
The redirect URL to be used at the end of the interactive login. Should be chosen as http://localhost:XXXXX where XXXXX is a random number in the 10000 - 65000 range to avoid conflicts. The redirect URL is part of the App configuration in Box.
Enterprise ID
The Box Enterprise ID when authenticating as a service account.
Login
Clicking on login opens a new browser window/tab which allows to interactively log into Box.

Input Ports

This node has no input ports

Output Ports

Icon
Box credential (access token).

Popular Predecessors

  • No recommendations found

Popular Successors

  • No recommendations found

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.