Box Integration

The App47 platform offers integration into your Box account for the deposit of daily, week or monthly reports.

There are two aspects to setup and configure:

• First the stack configuration to integrate with the App47 Box Application, as described https://box-content.readme.io/docs/box-platform.
• Second is the account integration to your specific box account.

This will allow App47 to have access to a folder of your choosing to upload and maintain reports from App47.

How to Integrate Box

This must be done to allow the App47 application access to your account. 

1. Log into your Box account as an adminstrator.
2. Go to the Admin Console.
3. Click on the wheel settings icon on the right.
4. Click on Enterprise Settings.
5. Click on the Apps tab.
6. In the Custom Applications area, click Authorize New App.
7. In the pop-up window, enter the api key: qvsodiq29u5f5wb5v360f890qllt24yd
8. Click on the Okay button to save your changes.

This adds the App47 application to your account, it does not add any users yet. This will occur at a latter step in the process.

This action is to be performed by an account administrator for each account that requires Box Integration.

1. Log into the Portal with account privileges.
2. Select Account and then select the BOX menu option.
3. Click on the Edit button.
   • Note: If you do not see an Edit button, you do not have the proper permission to configure the Box Integration.

4. Fill in the Enterprise ID. This can be found in YOUR box account by the box administrator.
   • If you do not know how to find it, then click on Admin Console, then The Settings/Wheel icon on the right, and, finally, select Enterprise Settings.
   • The Enterprise ID is located on the Account & Billing tab, under Account Information.
5. Next, provide the user name for this user. This is the username of the Box user created during completion of integration.
6. You will also need to provide the folder ID, which can be found by navigating to the folder that will be used for App47 reports, and finding the id in the browser url.
   • For example, in the URL https://app47.app.box.com/files/0/f/5843698621/Weekly_Export, the folder ID is 5843698621.
7. Provide the maximum number of days to keep reports in this folder. Files older than this number of days will automatically be removed.
8. Enabled will turn the use of the box integration On or Off.
9. Click Save.

After this, the user will be created in your box account, but they will not have access yet. You must grant permission for the user to have access to the specified folder; this is not achievable through the API:

10. Log into your Box account as a Box administrator.
11. Click Admin Console.
12. Click on the User icon to manage users.
13. Find and click on the User created by the username specified in the previous step. This will bring up a menu to edit the user.
14. Scroll down to the area for Select folders this user can access:.
15. Add the folder previously specified to the users list of allowed folders. Giving them Editor privileges so that they can both upload new files and delete old files.
16. Click on the Save button to save your changes.

This action is to be performed by an App47 Administrator.

1. Log into the Portal with admin privileges.
2. Select Profile and then select the Administrator menu option.
3. Select Configuration from the top level menu.
4. Select the Box Tab.

Update the form:

5. Provide the public key. The public key can be found by going to the Box App under the Public Key Management area.
6. Next, write in the API key, which can be found by going to the Box App under the Backend Parameters area.
7. You will also need to provide the Client Secret, which can be found by going to the Box App under the OAuth2 Parameters area.
8. Next, provide the private key. This is the private key used to generate the public key previously uploaded to the Box App.
9. Lastly, provide the private key password is the password associated with the private key. The private key MUST be created with a password for security reasons.
10. Click on the Save button to save your changes.

This will update the system to interact with the BOX API. Accounts that have the Box Integration feature turn on will now be able to configure their account to use Box for reports.