Dropbox Multi-User (White Label)
The Dropbox Multi-User (White Label) connector allows you to integrate multiple users' Dropbox accounts as data sources using your own Dropbox App credentials while leveraging Vectorize's platform for user management.
Why This Connector
This connector is ideal for applications that need to:
- Maintain brand consistency by using your own Dropbox App for authentication
- Control the user experience throughout the authentication flow
- Integrate multiple users' Dropbox accounts into a single data source
- Leverage Vectorize's platform for user management and file processing
- Speed up development by utilizing Vectorize's authorization and file picker functionality
Configure the Connector
To configure a connector for multiple users' Dropbox instances using your own Dropbox App:
-
Click Source Connectors from the main menu.
-
Click New Source Connector from the Source Connectors page.
-
Select the Dropbox (Advanced) card.
-
Select on Dropbox Multi-User (White Label)
-
Enter a name for your connector.
-
Enter your Dropbox App credentials:
- App Key: Your Dropbox App key
- App Secret: Your Dropbox App secret
-
Click Create Dropbox Mutli-User (White Label) Integration.
Prerequisites
Before using this connector, you'll need to:
- Create a Dropbox App in the Dropbox Developer Console
- Configure your Dropbox App with the following settings:
- App type: Enable files.content.read access. This scope requires verification with Dropbox once more than 50 users have authorized with your app.
- Permission type: Full Dropbox
- OAuth 2 Redirect URIs: Add your application's callback URL
Adding New Users to Your Connector
Once your multi-user connector is set up, you can add users by integrating the Vectorize Connect SDK into your application. The SDK provides all the tools needed to authenticate users and manage their Dropbox accounts as data sources through Vectorize.
ℹ️ Note: For this connector, you'll want to follow the White-Label Integration Guide, which walks through how to connect and authorize users using your own Dropbox App credentials.
For broader implementation details, check out the full SDK documentation. You can also explore the test-vectorize-connect-sdk repo, which provides a working example and sandbox to help you get started quickly.
Managing Users
To manage users in your Dropbox Multi-User (White Label) connector, you'll primarily use the manageDropboxUser
function provided by the Vectorize Connect SDK. This function allows you to update user file selections or remove users from the connector.
ℹ️ Note: The SDK is required for managing user state beyond simple deletions.
To remove users manually:
-
Click Source Connectors from the main menu.
-
Click the Edit button on your existing Dropbox Multi-User (White Label) connector.
-
In the Manage Users section, click the Delete button next to the user you want to remove.
-
Click Update Dropbox Multi-User (White Label) Integration to save your changes.
ℹ️ Note: When a user is deleted, their files will only be removed from the pipeline if it is running at that time. If the pipeline is not running, the files will remain until the next time the pipeline runs.
Configuring the Dropbox Multi-User (White Label) Connector in a RAG Pipeline
The connector does not require any additional configuration beyond what you set up in the Vectorize Connect SDK. Once users are authenticated, their files will be available for ingestion into your pipeline.
Troubleshooting
If your Dropbox Multi-User (White Label) connector is not ingesting files properly, check the following:
-
Dropbox App credentials: Ensure your App Key and App Secret are correct and that your app has the necessary permissions.
-
User authorization status: Ensure that all users have successfully completed the authorization process.
-
Redirect URI configuration: Verify that the redirect URI in your Dropbox App settings matches the one used in your application.
-
File access changes: Users may have changed permissions or deleted files that were previously accessible.
-
SDK integration issues: If using the Vectorize Connect SDK, verify that your implementation is correct and that all required parameters are provided.
What's next?
-
If you haven't yet built a connector to your vector database, go to Configuring Vector Database Connectors and select the platform you prefer to use for storing output vectors.
OR
-
If you're ready to start producing vector embeddings from your input data, head to Pipeline Basics. Select your new connector as the data source to use it in your pipeline.