In this article
This account is used by the Snaps in the Box Snap Pack.
You can create an account from Designer or Manager. In Designer, when working on pipelines, every Snap that needs an account prompts you to create a new account or use an existing account. The accounts can be created in or used from:
In Manager, you can navigate to the required folder and create an account in it (see Accounts). To create an account for Box:
Avoid changing account credentials while pipelines using them are in progress. This may lead to unexpected results, including locking the account. |
You need to use a Box Enterprise account. |
Field | Field Type | Description | |
---|---|---|---|
Label* | String | Specify a unique name for the account instance. | |
Access token | String | The access token for the application. The retrieval of the access token is done when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting access token will be stored in this property. The access token might be refreshable, in that case an optional refresh token can be stored. The user must get a new access token if the access token has expired and no refresh token was defined or both the access and the refresh token have expired. | |
Refresh token | String | The refresh token for the application. The retrieval of the refresh token is done when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting refresh token can be stored in this property. If the refresh token is stored, then the access token can be refreshed automatically before it expires. | |
Access token expiration | String | The access token expiration value.
| |
OAuth2 Endpoint* | String | Authorization endpoint to authorize the application. Default Value: "https://app.box.com/api/oauth2/authorize" Recommended value as per Box: "https://account.box.com/api/oauth2/authorize" | |
OAuth2 Token* | String | Token endpoint to get the access token. Default Value: "https://app.box.com/api/oauth2/token" Recommended value as per Box: "https://api.box.com/oauth2/token" | |
Auth endpoint config | String | Provides custom properties for the OAuth2 auth endpoint. | |
Refresh | String | Refresh access token. Available after the account has been saved. | |
Auto-refresh token | Checkbox | Refreshes the token automatically using the refresh token if the property is enabled. Otherwise the token might expire and will not be automatically refreshed. | |
Authorize | Starts the OAuth authorization flow. Account will be saved before authorize. | ||
Connection timeout (seconds) | Integer | Specify connection timeout in seconds. A value of 0 indicates infinite timeout. Default Value: 60 | |
Read timeout (seconds) | Integer | Specify read timeout in seconds. A value of 0 indicates infinite timeout. Default Value: 900 | |
Write Timeout (seconds) | Integer | Set write timeout in seconds. A value of 0 indicates infinite timeout. Default Value: 900 |
A service account enables multiple users to use the same account for performing operations in Box. You can use this account type to connect to a Box application that has OAuth2 with JWT Token authentication.
Create a service account application in Box because all the parameters required to configure this account type are generated in the Box admin console. See JWT Application Setup for details. See the App Settings JSON file for the account parameters. Alternatively, perform the following steps to get the parameters from the Box developer console:
|
Field | Field Type | Description |
---|---|---|
Label* | String | User provided label for the account instance. Default Value: N/A |
Client ID* | String | The client ID of the application requesting authentication. Default value: N/A |
Client secret | String | The client secret of the application requesting authentication. Default Value: N/A |
Public key ID | String | The public key ID of the application. Default Value: N/A |
Private key | String | The encrypted private key. Default Value: N/A -----BEGIN ENCRYPTED PRIVATE KEY-----\n MkiG9RefG12qasOn\nMBQGCCqGSIb3DQMHBAj/xheVHRkNNgSC BMhL9TFI/pX0EVwkT44QyEOI9DuXIIlsg\nwqYR58DkP7ItCfZdFHq8 3pCwLjlvuRYsYGsb2F24OsLjCna0HsnpCbe4rvpedj7QE/aO\nN0xn8 p\nYnhxUWQzXy7ZnzYPn1wmtcaYwx+Ialn2tukqZCEpqrFf8guOjvBl aPHcMGwYJab0\n26k=\n -----END ENCRYPTED PRIVATE KEY-----\n |
Private key passphrase | String | The private key passphrase associated with the encrypted private key. Default Value: N/A |
Enterprise ID | String | The enterprise ID associated with the Box application. Default Value: N/A |
Connection timeout (seconds) | Integer/Expression | Specify connection timeout in seconds. A value of 0 indicates infinite timeout. Default Value: 60 |
Read timeout (seconds) | Integer/Expression | Specify read timeout in seconds. A value of 0 indicates infinite timeout. Default Value: 900 |
Write Timeout (seconds) | Integer/Expression | Set write timeout in seconds. A value of 0 indicates infinite timeout. Default Value: 900 |
Standard Encryption | If you are using Standard Encryption, the High sensitivity settings from the table under Enhanced Encryption are followed. | |
---|---|---|
Enhanced Encryption | If you have the Enhanced Account Encryption feature, the following describes which fields are encrypted for each sensitivity level selected per each account.
|