This article provides instructions for connecting Box to your Akooda account. This connection essentially provides Akooda with access to documents that are shared explicitly with Akooda.
For more information about how Akooda helps your organization evolve and the inherent privacy and security protections in place, see Akooda Integration Principles.
Before We Begin
Before connecting your organization’s Box account, check that:
You’re an Admin in Akooda.
You’re an Admin for your Box account with the "Admin console" on the left bottom.
If you don’t have the right permissions as mentioned above, please send this guide to the right individual in your organization (usually this is IT or Info Security personnel). If you require further assistance getting the right permissions, please don’t hesitate to contact our support team at [email protected].
NOTE: At any point, if the Box integration account is deleted or admin access permissions are revoked, your Akooda sync will stop working and will require re-connecting by following this guide’s steps.
How to Connect
Step 1: Create an Akooda Box Integration Account
Head over to your Box Admin console (app.box.com/master)
Add a new account by going to “Users & Groups”, “Add users” and “Add users Manually” such that their account information is as follows:
Full name: Akooda App
Email: akooda@[YOUR_EMAIL_DOMAIN]
Lastly, click “Save” to finish adding the new user, and then refresh the following screen to make sure the last action is updated.
NOTE: The integration account will be visible in the Admin console and to all organization’s contacts and will be used to select Drive folders/documents.
Step 2: Link the Box Integration Account with Akooda
Sign into Akooda (app.akooda.co) with your personal Akooda admin user (not the integration account).
Navigate to the “Apps” page under the Account Settings (app.akooda.co/settings/apps)
Click on the “Connect” button for Box app, which will open a user selection page.
Sign in with the newly created Akooda integration account (called “Akooda App”, with akooda@[YOUR_EMAIL_DOMAIN] email).
Click "Grant Access to Box" to provide consent for Akooda to view the information needed to connect Box.
NOTE: The permissions granted include seeing Box files, domain’s groups and user information. These permissions are required for Akooda to be able to analyze the users’ interactions with selected files.
Important to know: Following Box permissions policy, in order to download files and read comments, the permissions “Read and write all files and folders stored in Box” is necessary.
Akooda will never write or modify any of your files and data.
Step 3: Invite the Akooda Integration Account to Private Folders and Documents
Many organizations use Box to create private drives, folders, and documents that are shared with specific teams (aka Groups) or individuals. In such cases, members with invite permissions must opt-in to share this content with Akooda, by adding the user created in the previous step.
Head to the private drive / folder / doc in Box
Right-click “Share”
Add akooda@[YOUR_EMAIL_DOMAIN] as a viewer / editor
Click “Send”
NOTE: The integration account will be shown as a member with access to all drives / folders / docs participants, much like any other member, and can be removed by the owner at any time.
This is key to allowing everyone participating to maintain their right for privacy.
Once removed, the processed data history will also be purged from Akooda. Moreover, private interactions will be descriptively shown only to members with view permissions or higher within the Akooda app.
Next Up
Processing your organization's data post initial integration may take up to 24 hours. Once completed, you will be able to view tagged Box interaction data in your Akooda account (according to each individual user’s access permission).
If you run into any problems, we’re here to help. Reach out to [email protected] for assistance.
Any Feedback?
Was this page helpful? Provide feedback on this article and ways we can improve to [email protected].