Data Connectors | Kamiwaza Docs
Documentation for Kamiwaza 1.0.1
This document provides information regarding data connectors in Kamiwaza, which allow administrators to configure external data sources. Users can connect their accounts to access data from services like Microsoft 365, Google Workspace, and others.
Overview
External data connectors enable users to access their data from cloud services like Microsoft 365 and Google Workspace. Administrators configure the connector settings (such as Azure AD application registration for Microsoft 365), allowing users to connect their personal or work accounts.
Connector Configuration Includes:
- Service configuration: Application credentials and settings required to connect to the external service
- Access controls: Permissions and scopes that determine what data users can access
- Status tracking: Indicates whether the connector is configured and ready for user connections
Connectors are managed through the Kamiwaza web UI at Settings → Data Connectors.
Configuring a Connector
Prerequisites
- Administrative access to the Kamiwaza platform
- Application credentials for the external service (e.g., Azure AD app registration for Microsoft 365)
- Knowledge of the service's authentication and API requirements
Using the Web UI
- Navigate to Settings → Data Connectors
- You'll see available connector types:
- Microsoft 365 - Connect to SharePoint, OneDrive, Outlook, and Calendar
- Google Workspace - Connect to Drive, Gmail, and Calendar (read-only)
- Dropbox - Connect to Dropbox storage
- Click Configure on the connector you want to set up.
- Fill in the required configuration details:
- For Microsoft 365: Azure AD application credentials (Client ID, Client Secret, Tenant ID)
- For Google Workspace: Google Cloud OAuth credentials (Client ID, Client Secret, Redirect URI) plus read-only capabilities (Gmail, Drive, Calendar).
- Service-specific settings and permissions
- Click Save to complete the configuration.
Once configured, the connector status will show as "Configured," allowing users to connect their accounts.
Managing Connectors
Viewing Connectors
In the Settings → Data Connectors page, you can view all available connector types. Each connector card shows:
- Connector name and logo
- Associated services (e.g., "SharePoint, OneDrive, Outlook, Calendar" for Microsoft 365)
- Configuration status ("Configured" or "Not configured")
- Availability status (some connectors may show "Coming Soon")
Updating a Connector
To update a connector's configuration:
- Navigate to Settings → Data Connectors
- Click Configure on the connector you want to update
- Modify the configuration fields as needed:
- Application credentials (Client ID, Client Secret, etc.)
- Service-specific settings
- Permissions and scopes
- Click Save to apply changes
Note: Updating connector configuration may require users to reconnect their accounts if authentication settings change.
Removing a Connector Configuration
To remove a connector configuration:
- Navigate to Settings → Data Connectors
- Click Configure on the connector
- Click Delete to remove the configuration
Warning: Removing a connector configuration will disconnect all users who have connected their accounts. Users will need to reconnect after the connector is reconfigured.
User Connection Flow
Once an administrator has configured a connector, users can connect their accounts:
- Users navigate to their profile or data sources section
- They see available connectors that have been configured by administrators
- Users click to connect their account (e.g., "Connect Microsoft 365")
- They are redirected to authenticate with the external service (OAuth flow)
- After successful authentication, their account is connected and they can access data from that service.
Security and Access Control
Application Credentials
- Secure Storage: Application credentials (Client IDs, Client Secrets) are encrypted at rest
- Credential Rotation: Update the connector configuration in the UI to rotate application credentials when needed
- Least Privilege: Configure application permissions to request only the minimum scopes needed
User Access
- OAuth Authentication: Users authenticate directly with the external service (Microsoft, Google, etc.) using OAuth
- User-Level Permissions: Each user's access is limited to their own account and the permissions they grant during the OAuth flow
- Admin Control: Administrators control which connectors are available to users, but users control which accounts they connect
Data Access
- Scoped Access: Users can only access data from accounts they have connected
- Permission Boundaries: The connector configuration determines what permissions are requested from users during the OAuth flow
- Data Isolation: Each user's connected accounts and data are isolated from other users
Connector Status
Each connector displays its configuration status:
- Not configured: The connector has not been set up yet.
- Configured: The connector is ready for users to connect their accounts. Users will see this connector as available in their data sources.
Supported Connector Types
| Connector | Services | Status |
|---|---|---|
| Microsoft 365 | SharePoint, OneDrive, Outlook, Calendar | Available |
| Google Workspace | Drive, Gmail, Calendar (read-only) | Available |
| Dropbox | Dropbox storage | Coming Soon |
Microsoft 365 Connector
The Microsoft 365 connector allows users to connect to access:
- SharePoint: Document libraries and sites
- OneDrive: Personal file storage
- Outlook: Email messages
- Calendar: Calendar events and meetings
Configuration Requirements:
- Azure AD application registration
- Client ID and Client Secret
- Tenant ID (for single-tenant apps)
- Required API permissions configured in Azure AD
Google Workspace Connector
The Google Workspace connector lets users connect to access, read-only:
- Google Drive: files and folders
- Gmail: email messages
- Google Calendar: calendar events
Configuration Requirements:
- A Google Cloud project
- An OAuth 2.0 Client ID of type Web application
- The required Google APIs enabled in that project: Gmail API, Google Drive API, Google Calendar API
- An Authorized redirect URI that exactly matches Kamiwaza's callback
Best Practices
- Application Registration: Create dedicated Azure AD applications for Kamiwaza connectors rather than reusing existing applications
- Principle of Least Privilege: Request only the minimum API permissions needed
- Credential Security: Store application credentials securely and rotate them regularly
- User Communication: Inform users about data and permissions before they connect accounts
- Testing: Test the connector configuration before making it available to all users
- Documentation: Document the required Azure AD permissions
- Monitoring: Regularly review connected accounts and ensure proper configuration