Connectors
Sharepoint Connector
Access files and notes from your Sharepoint Sites
How it works
The Sharepoint connector will go through all configured sites belonging to an organization and index all the documents attached to that site. Note, it currently does not parse the site page contents, only the attached files.
This includes:
- Word Doc, Excel, PDF, Powerpoints, and all plaintext files like .txt, .mdx, etc.
Setting up
Authorization
More detailed instructions can be found following the video below.
- Log in to azure portal for your organization.
- Navigate to “app registrations” using the search bar.
- Click
New Registration
. - Name it something like “Onyx Sharepoint Connector”, leave everything else as default, and click
Register
. - Under “Essentials” in the overview tab, you will find the Application (client) ID and Directory (tenant) ID. Save those for later.
- Navigate to the “Certificates & secrets” tab in Azure Portal and click
New client secret
. - Fill out he description, set the expiration to 24 months, and click
Add
. - Copy the secret value in the Value column for later.
- Navigate to the “Api Permissions” tab in the azure portal and click
add a permission
. - Click Microsoft Graph, then click on
Application permissions
. - Navigate to the “sites” permission group.
- Select the checkbox for Sites.Read.All.
- Advanced: If you want to limit the sites this app has access to, select Sites.Selected. However, if you do this, you will need add the App you are currently registering to each site you want to index.
- Click Add permissions.
- Finally, click Grant admin consent for <Organization name> (located next to Add a permission) and click Confirm.
Indexing
- Navigate to the Admin Dashboard and select the Sharepoint Connector Tile.
- Provide the Application (client) ID, Directory (tenant) ID and Client Secret Value from steps above.
- Select a list of sites to pull from or leave blank and click Connect to pull everything.
- Advanced: If you selected Sites.Selected in the scope selection step above, you will need to enter a list of sites you want to index as the App doesn’t have permission to list all sites.