Connectors overview
Managing connectors and data sources in Nexus
Availability depends on your school's enabled tools, provider setup, and account permissions. These settings are managed in the web workspace. A class policy may restrict a feature described here. Some options require a separately licensed feature. The presence of a guide does not unlock that feature.
Nexus's Connectors create a bridge between your school's data sources and generative AI features in Nexus. Nearly all connectors are persistent and regularly sync changes from your source.
Both the data that is retrieved from the source and the data that your users can access through Nexus can be customized to your needs!
To find specific instructions for each Connector, see the Supported Connectors section.
Adding a Connector#
To add a new connector, navigate to the Admin Panel and click Add Connector in the sidebar. This page shows all officially supported connectors.
You can see unofficial, community-supported connectors by setting
SHOW_EXTRA_CONNECTORS=truein your environment.
Click on any of the tiles to begin creating a new Connector.
Credentials#
Most Connectors require some form of authentication for Nexus to access your source. This authentication is called a Credential and differs by Connector.
Configuration#
Each connector must be given a Name. Additionally, each Connector has its own configuration options to specify the data that should be indexed.
Document Access Controls#
Connectors can be configured to be Private, Public, or Auto Sync Permissions.
Private: Only the user who created the Connector may see data from this Connector in Nexus. You may also assign specific Users and User Groups access to this Connector's data.
Public: All Nexus users may see data from this Connector.
If you configure the Connector to access private data in the source, all Nexus users will be able to see this data.
Permission-Syncing Connectors#
If you set your Connector's access type to Auto Sync Permissions, Nexus will maintain an access control list from the source and restrict users to only see data they have access to.
Permission-syncing is only available for the following Connectors:
Confluence
Jira
Google Drive (must use service account or Google Workspace Admin OAuth credentials)
Gmail (must use service account or Google Workspace Admin OAuth credentials)
Slack (see Federated Slack documentation)
Salesforce
GitHub
Box
Canvas
SharePoint (must use certificate-based authentication)
Permission-syncing connectors are an Enterprise Edition feature.
Advanced Configuration#
Clicking Advanced Configuration on the bottom left of the Connector configuration page will reveal additional, optional settings for indexing.
Prune Frequency: The frequency at which old data (that no longer exists in the source) should be removed from Nexus. This is set to 30 days by default.
Refresh Frequency: The frequency at which new data should be retrieved from the source. This is set to 30 minutes by default.
Indexing Start Date: The date and time from which data should be indexed (data created or updated before this date will not be indexed). This is set to the earliest possible date in the source by default.
Managing Existing Connectors#
To see your existing Connectors, navigate to the Admin Panel and click Existing Connectors in the sidebar. This page will show an overview of your Connectors, their status, and the amount of data they have indexed.
Connector Status#
The status of a Connector can be:
Active#
| Status | Description |
|---|---|
| Indexed | The Connector is fully functional and all data is synced as of the last indexing attempt. |
| Scheduled | Newly created Connectors or Connectors that have reached their refresh frequency but have not begun a new indexing attempt. |
| Indexing / Initial Indexing | The Connector is currently retrieving data from the source. |
Inactive or Semi-Active#
| Status | Description |
|---|---|
| Paused | The Connector has been paused and will not retrieve new data until un-paused. Users can still access the indexed data. |
| Error | The Connector has encountered an error during indexing. Any data indexed prior to the error will remain available. Nexus will attempt to index again. If too many errors occur, the Connector will be paused. |
Most Error statuses are temporary and will resolve themselves naturally within a few hours. If you see an Error status that persists, please reach out.
Connector Details#
Clicking on an existing Connector will show you details about its configuration, status, and indexing attempts.
In the Manage menu, you can pause, resume, delete, or initiate a complete re-indexing of the Connector.
Under the Advanced section, you can see the prune and refresh settings, as well as the history of indexing attempts.
Indexing Failures#
Rarely, you will see a Completed with errors indexing attempt. If this happens, you can click the Resolve all errors button to kickoff a complete re-indexing of the Connector.
Supported Connectors#
Can't find the connector you're looking for? Let us know via GitHub Discussions!
Knowledge Base & Wikis#
Confluence#
SharePoint#
Notion#
BookStack#
Canvas#
Document360#
Discourse#
GitBook#
Slab#
Outline#
Google Sites#
Guru#
Cloud Storage#
Google Drive#
Dropbox#
Box#
AWS S3#
Google Storage#
Egnyte#
Oracle Storage#
Cloudflare R2#
Ticketing & Task Management#
Jira#
Zendesk#
Airtable#
Linear#
Freshdesk#
Asana#
ClickUp#
ProductBoard#
Messaging#
Slack#
Microsoft Teams#
Gmail#
Discord#
XenForo#
Zulip#
Sales#
Salesforce#
HubSpot#
Gong#
Fireflies#
Highspot#
Code Repository#
GitHub#
GitLab#
Bitbucket#
Other#
Web Scraper#
File Upload#
Before using this source with students#
Start with approved course material. Check which documents the connector can retrieve and how it maps source permissions. Test with a student account and a teacher account before widening access. A successful sync does not prove that the intended class boundary is correct.
Use source troubleshooting when a document is missing or visible to the wrong audience.