Multi-User Connectors
Multi-User connectors enable you to integrate multiple users' cloud storage accounts as data sources in your RAG pipelines. This approach allows you to collect documents from various team members while maintaining proper authentication and access controls.
Available on Starter plan and above
Overview
The Vectorize Connect SDK provides two approaches for implementing multi-user OAuth connectors:
Vectorize-Managed OAuth
Use Vectorize's pre-configured OAuth applications for quick setup without managing your own OAuth credentials. This approach is ideal for:
- Rapid prototyping and development
- Teams that want to focus on application logic rather than OAuth setup
- Applications that don't require custom branding in the authentication flow
Available on Starter plan and above
White-Labeled OAuth
Use your own OAuth applications for complete control over the authentication experience. This approach is ideal for:
- Production applications requiring custom branding
- Organizations with specific security or compliance requirements
- Applications that need full control over the OAuth flow
Available on Pro plan and above
Comparison: Vectorize-Managed vs White-Labeled
| Feature | Vectorize-Managed | White-Labeled |
|---|---|---|
| OAuth Setup | Pre-configured by Vectorize | Requires your own OAuth app |
| Branding | Vectorize branding | Your custom branding |
| Setup Time | Immediate | Requires OAuth app configuration |
| Plan Requirement | Starter+ | Pro+ |
| Control Level | Standard | Full control |
Getting Started
The Vectorize Connect SDK handles the complex OAuth flows and provides simple functions for:
- Creating connectors programmatically
- Adding and managing users through OAuth flows
- Selecting files from connected accounts
- Managing user permissions and access
Prerequisites
Before implementing Multi-User connectors, ensure you have:
- A Vectorize account
- Node.js development environment
- Your Vectorize API credentials
Installation
npm install @vectorize-io/vectorize-connect
Implementation Guides
Choose the approach that best fits your needs:
- Vectorize-Managed OAuth - Quick setup using Vectorize's managed OAuth
- White-Labeled OAuth - Full control with your own OAuth applications
Supported Platforms
Both connector types support various cloud storage and productivity platforms. The specific platforms available may vary over time as new integrations are added or existing ones are updated.
User Management
Unlike single-user connectors, Multi-User connectors require special handling for user operations:
- Adding users: Done through the vectorize-connect-sdk OAuth flows
- Editing user selections: Managed via SDK functions like
manageUser - Removing users: Can be done through the Vectorize UI or SDK
The Vectorize platform UI only supports user deletion - all add/edit operations must be performed through the SDK to maintain proper OAuth token management.
Next Steps
- Choose your connector approach (Vectorize-managed vs White-labeled)
- Follow the implementation guide for your chosen approach
- Set up your development environment with the required credentials
- Implement the OAuth flows in your application
- Test user management and file selection workflows