Box Developer Documentation

Authorization

Guides Authorization
Edit this page

Authorization

Some applications require explicit Admin authorization before use with an enterprise. The steps an Admin needs to take are dependent on the developer-selected authentication method and enabled enterprise settings.

Authentication methods

The following authentication methods always require explicit Admin authorization:

These authentication methods automatically generate a Service Account. With the right scopes enabled, a Service Account can perform many Admin actions, thus requiring Admin authorization before use.

OAuth 2.0 and App Token apps may also require explicit Admin authorization based on enabled enterprise settings.

Enterprise settings

Subsequent steps are required if any of the following enterprise settings are enabled:

  • Disable published Integrations by default
  • Disable unpublished Integrations by default
  • Require manual admin authorization for transactional access apps

These settings can be found by navigating to:

Admin Console > Apps > Platform Apps > click the ⚙ icon

Published integrations are any applications that can be found in our App Center.

Required actions

To see what steps an Admin must complete for a given app, review the following scenarios.

Disable Integrations by default:

Authentication MethodEnabledDisabled
OAuth 2.0Set to available in individual app controlsReady for use
Server Authentication (with JWT)N/AN/A
Server Authentication (client credentials)N/AN/A
App Token AuthenticationN/AN/A

Disable unpublished integrations by default:

Authentication MethodEnabledDisabled
OAuth 2.0Enable in Apps > Platform Apps Manager > User Authentication Apps > Platform AppReady for use
Server Authentication (with JWT)Authorize and enable in Integrations > Platform Apps Manager > Server Authentication Apps > Add Platform AppAuthorize in Integrations > Platform Apps Manager > Server Authentication Apps > Add Platform App
Server Authentication (client credentials)Authorize and enable in Apps > Platform Apps Manager > Server Authentication AppsAuthorize in Integrations > Platform Apps Manager > Server Authentication Apps > Add Platform App
App Token AuthenticationAuthorize and enable in Integrations > Platform Apps Manager > Server Authentication Apps > Server Authentication Apps > Add Platform AppReady for use

Require manual admin authorization for transactional access apps:

Authentication MethodEnabledDisabled
OAuth 2.0N/AN/A
Server Authentication (with JWT)N/AN/A
Server Authentication (client credentials)N/AN/A
App Token AuthenticationAuthorize in Integrations > Platform Apps Manager > Server Authentication AppsAutomatically authorized and enabled upon creation