Connecting to Box
Use the OAuth authentication standard to connect to Parquet. You can authenticate with a user account or a service account. The provider facilitates this as described below.
Using a User Account to Authenticate to Parquet
The user account flow requires the authenticating user to interact with Parquet via the browser.
Desktop ApplicationsSee Embedded Credentials to connect with the provider's embedded credentials and skip creating a custom OAuth app.
Headless MachinesSee Headless Machines to skip creating a custom OAuth app and authenticate an application running on a headless server or another machine where the provider is not authorized to open a browser.
Instead of connecting with the provider's embedded credentials, you can register an app to obtain the OAuthClientId and OAuthClientSecret.
When to Create a Custom OAuth App
You need to create a custom OAuth app in the web flow.
Creating a custom OAuth app is optional as the provider is already registered with Parquet and you can connect with its embedded credentials. You might want to create a custom OAuth app to change the information displayed when users log into the Parquet OAuth endpoint to grant permissions to the provider.
Creating a custom OAuth app is optional to authenticate a headless machine; the provider is already registered with Parquet and you can connect with its embedded credentials. In the headless OAuth flow, users need to authenticate via a browser on another machine. You might want to create a custom OAuth app to change the information displayed when users log into the Parquet OAuth endpoint to grant permissions to the provider.
Using a Service Account to Connect to Parquet
Service accounts have silent authentication, without user authentication in the browser. You can also use a service account to delegate enterprise-wide access scopes to the provider.
You need to create an OAuth application in this flow. You can then connect to Parquet data that the service account has permission to access. See Custom Credentials for an authentication guide.
Creating a Custom OAuth App
See Creating a Custom OAuth App for a procedure.