Setting up SharePoint integration for document management
The SharePoint integration lets Intuety pull documents, such as your company standards and SOPs, from a SharePoint site automatically, so you do not have to upload them by hand. Intuety then uses them to give High priority suggestions based on your own standards.
Who can use this?
Client Admins. If you use your own Azure app, someone with access to your organisation's Azure portal who can register applications and grant admin consent (usually your IT team) will also need to help.
How do I start?
- Select Organisation Settings in the left-hand menu. The left-hand menu now shows the Organisation Settings sections.
- Under Automation, select Integrations.
- Open the Azure / SharePoint card.
- Under Azure Enterprise app, choose Use Intuety's standard Azure app or Use my own Azure app.
Option 1: Intuety's standard Azure app (simplest)
You do not need to register anything in Azure. Provide, under SharePoint configuration: Azure tenant ID, SharePoint site name and Folder path.
Option 2: Your own custom Azure app
The app needs these application permissions:
- SharePoint: Sites.Read.All
- Microsoft Graph: Sites.Read.All
Provide, under Azure application: Azure application (client) ID and Client secret. Then, under SharePoint configuration: Azure tenant ID, SharePoint site name and Folder path.
Setting up your own Azure app
1. Register the app
- In the Azure portal, go to Microsoft Entra ID (formerly Azure Active Directory) > App registrations.
- Select New registration.
- Enter a name (for example Intuety Integration), choose Single tenant and select Register.
- Copy the Application (client) ID into the Azure application (client) ID field in Intuety.
- Copy the Directory (tenant) ID from the same Overview page into the Azure tenant ID field.
2. Grant SharePoint permissions
- In your app registration, open API permissions and select Add a permission.
- Choose Microsoft Graph > Application permissions > Sites.Read.All.
- Add a permission again, choose SharePoint > Application permissions > Sites.Read.All.
- Select Grant admin consent for your organisation.
3. Create a client secret
- Open Certificates & secrets and select New client secret.
- Add a description and expiry, then select Add.
- Copy the secret Value straight away (it is only shown once) into the Client secret field in Intuety.
4. Finish in Intuety
- Enter the SharePoint site name and the Folder path that holds your documents.
- Select Test connection. If it works, you see "Connection test successful" and a Files found list with the number of files.
- Select Enable ingestion. The card shows Enabled.
How do I check it worked?
Under Ingested Safety Standards, each document shows its Status: Uploaded, Pending or Error.
How do I change the settings?
The fields are locked while ingestion is on. Select Disable ingestion, make your changes, then select Test connection and Enable ingestion again.
Tips
- Point the integration at a folder containing only the accepted standards you want Intuety to use.
- Client secrets expire. Set a reminder to renew it before the expiry date you chose. To update it in Intuety, select Disable ingestion, enter the new Client secret, then select Test connection and Enable ingestion.
Common questions
- Documents are not coming through: check the site name and folder path, and that admin consent was granted.
- It stopped working: the client secret may have expired. Create a new one and update it in Intuety.
Related articles
Still need help?
Ask our live chat, email support@intuety.io or call 02922 710 527. Include the Job ID (shown in Job Quick View) if your question is about a specific job.
Interactive walkthrough
Prefer to be shown? Follow the step-by-step interactive walkthrough below.