Box Integration Administrator Setup | Axero Documentation

This guide explains how to configure Box integration with Axero. This setup enables two-way file synchronization between your community and Box, allowing seamless file management across platforms.

The integration can be completed in approximately 30 minutes by a system administrator with appropriate Box and Axero permissions.

Overview

• Prerequisites
• Step 1: Configure Box Application
• Step 2: Configure Axero Integration
• Step 3: Configure External Drive Connections
• Step 4: Configure File Access Settings
• Troubleshooting
• Security and Maintenance

Prerequisites

Before you start, ensure you have:

• Box Administrator or Co-Admin role in your Box organization
• Site Administrator access to your Axero platform
• Access to your organization's Box developer console

Step 1: Configure Box Application

1.1 Create the Box Application

1. Sign in to the Box Developer Console using an account with Box Administrator or Co-Admin permissions.
2. Select Create Platform App.
3. Choose Custom App as the application type.
4. Enter a descriptive name for your application (e.g., "Axero Box Integration").
   Note: This name will appear on the consent screen when users connect their Box accounts.
5. Under Purpose, select Integration.
6. Enter an appropriate category for your integration.
7. In the External System field, enter Axero.
8. Select Next to continue.
9. For Authentication Method, select User Authentication (OAuth 2.0).
10. Select Create App to create the application.

1.2 Configure OAuth Settings

11. In the OAuth 2.0 Redirect URIs section, enter your Axero site URL followed by /oauth2/boxcom/callback
    
    Example: https://yourcompany.axero.com/oauth2/boxcom/callback
    
    Note: The Redirect URI must use HTTPS and match exactly, including path and casing.
12. Select Add, then Save Changes.
13. In the OAuth 2.0 Credentials section, copy and securely store the Client ID and Client Secret for the next step.

Step 2: Configure Axero Integration

1. In your Axero community, navigate to Control Panel > System > Integrations.
2. Locate the Box section and select Add Connected Account.
3. Select Box from the available integration options.
4. Enter the following information from your Box application:
   • Client ID: The Client ID from Step 1
   • Client Secret: The Client Secret from Step 1
5. Choose where users can access Box integration:
   • Available in top-level communities: Users can connect to Box by navigating to Browse > Files
     Note: Files must be enabled in Control Panel > System > Application Settings
   • Available in spaces: Space administrators can add Box to any space's Files section
   • Available in Personal Connect: Users can connect to Box through their personal My Files area
6. Select Save Settings to complete the integration configuration.

Step 3: Configure External Drive Connections

Option 1: Community-Wide or Space-Specific Access

1. Navigate to Control Panel > System > External Drives (community-wide) or Manage Space > External Drives (space-specific).
2. Select Add External Drives.
3. Choose Box.com from the available integration options.
4. Enter a Display Name that users will see when accessing the external drive (e.g., "Company Box" or "Team Box Storage").
5. Under Connected Account, select the Box integration you configured in Step 2.
6. Select Connect to initiate the authentication process.
7. A new browser tab will open for Box authentication:
   • Sign in with an account that has appropriate permissions to the Box content
   • Review the requested permissions and select Grant Access to Box
   • You'll be automatically redirected back to Axero
8. Select Save Settings to complete the configuration.

Option 2: Personal My Files Access

To enable personal My Files access, configure the following system property:

1. Navigate to Control Panel > System > System Properties
2. Locate the ShowNewMyAccountFilesView property
3. Set the value to true
4. Save the configuration

Once enabled, users can connect to Box through My Content > My Files.

Step 4: Configure File Access Settings

File Indexing Configuration

Control which Box files are indexed for search by configuring the BoxIntegrationIndexFileSizeLimit system property:

1. Navigate to Control Panel > System > System Properties
2. Locate the BoxIntegrationIndexFileSizeLimit property
3. Set the value in bytes to define the maximum file size for content indexing
4. Save the configuration

Troubleshooting

Authentication Issues

• "Invalid redirect URI" error: Verify the redirect URI in Box exactly matches your Axero site URL with /oauth2/boxcom/callback path
• "Application not found" error: Verify the Client ID is correct and the Box application exists in your developer console
• "Access denied" error: Confirm the user has appropriate permissions to access Box content

Connection Issues

• Unable to connect to Box: Verify the connecting user has at least read access to the Box content
• Files not syncing: Check for file name restrictions and verify file sizes are within supported limits
• Integration not appearing in Axero: Verify the Box integration is properly configured in Control Panel > System > Integrations

Security and Maintenance

Security Best Practices

• Periodically review which users have connected Box accounts and their access levels
• Monitor Box API usage through your Box Admin Console to track integration activity
• Regularly audit file access permissions to ensure appropriate security controls

Performance Notes

• Files sync automatically every 3 hours; users can trigger manual sync when needed
• Only changed files are synchronized after initial setup
• Box API usage depends on the number of files and connected users - consult your Box license for potential additional fees

Additional Resource

• Box Developer Documentation

Support and Feedback

Need further assistance? Submit a support ticket to our technical support team for personalized help. To expedite the troubleshooting process, please include relevant error messages or screenshots from both Box and Axero.

We value your feedback! If you have suggestions for improving this documentation, please let us know when submitting a support case.