Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Integrate SharePoint with Josef Q

This article provides instructions on how to integrate SharePoint with Josef Q. 

Josef Q can connect to your SharePoint to allow Creators to build tools using content from approved SharePoint Sites. This integration uses a service principal registered in your Microsoft Entra ID to access SharePoint.

What the integration allows

  • Josef Q Creators can create tools using content from SharePoint folders.
  • Josef Q Creators can update tools using the latest content in SharePoint folders.

Permission scope

  • You can set the SharePoint sites Josef Q can access using the Microsoft Graph Sites.Selected (application) permission.
  • Josef Q requires read access for the sites selected.

Enable this integration

To enable this integration, please complete the following:

  1. Create a Microsoft Entra ID application for Josef Q to access SharePoint.
    1. Permissions: Sites.Selected
      1. Type: Application
    1. Configure Sites:
      1. Add SharePoint Sites you want Josef Q to be able to read to your Entra application with the Microsoft Graph API.
  2. Securely share the following details with your Josef Q account manager to configure for your organisation:
  • Tenant ID
  • Client ID
  • Client Secret Value
  • Site IDs (e.g. joseflegal.sharepoint.com,96079d6a-48bd-41d8-a279-c7ff73f06316,238086d1-6224-4c10-95e6-87c4101aa17c)
Please ensure your application is enabled so we can connect to it. 

Disable this integration

You can reach out to your Josef Q account manager to help you disable the integration for your organisation. If disabled, existing SharePoint-based tools will no longer be able to updated with new SharePoint content.

FAQs

Can I use the existing enterprise app used for Josef Q SSO, or do I need a new one?

Please create a new Entra ID app specifically for the SharePoint integration.

Your SSO app uses delegated user permissions, while the SharePoint integration needs application-level (app-only) Graph permissions. Keeping them separate avoids scope conflicts and makes rotation, auditing, and troubleshooting much easier.

Should we create separate Entra apps per business unit or one for everyone?

A single app is best in most cases. You can control which SharePoint sites it can access using the Sites.Selected permission and per-site grants. That gives each business unit precise access without multiplying app registrations.

If your organisation has strict ownership or compliance boundaries between units, you can register separate apps, but it’s not required.

 

If you have any other questions about setting up your SharePoint integration, you can contact us at support@joseflegal.com.