OneDrive Integration

OneDrive Integration

Are you sure you want to remove this component?

IMPORTANT: This feature works specifically and only with OneDrive for Business using Azure AD.

1. Navigate to the Admin area

2. Select Settings > 3rd Party Services

There are 3 required and 1 optional configuration settings to set up your connection of Office 365/OneDrive for Business.

NOTE: To locate these settings, you will need to add Schoolbox as an application into your Office 365/OneDrive.

NOTE: If your Tenant Name is myschool.onmicrosoft.com do not include the ".onmicrosoft.com" portion in the Tenant Name field in Schoolbox. Do not use your school's actual domain, even if it is the default domain. The Tenant Name can be found by going to admin.microsoft.com, then searching for 'Domains'. 

image.php?hash=f9c4aa0e7c4d590ad81555816a20df93c44e702a

Register for Azure AD

Are you sure you want to remove this component?

During the "Register a new application using the Azure portal" process you will be asked for the following:

1. Enter the App Name - For example: Schoolbox

2. Enter the Redirect URI (Web) - For example: https://schoolbox.school.edu/ajax/oauth/microsoft

NOTE: The ‘Redirect URL’ should be your website URL.

image.php?hash=8e6180e95f2c2d4b14aceb05ba23516bcdf48a6b

NOTE: You can add multiple Redirect URIs to the application. This allows you to set up one application to support both your Production and Staging service.

3. Copy the "Application Id" into Schoolbox: Admin > Settings > 3rd Party Services > Microsoft Office 365 App ClientID

For further information, please review the Microsoft information on how to ‘Register a new application using the Azure portal’.

 Secrets

Once your app is registered you will need to create a secret.

1. Select "Certificates & secrets"

2. Select "New client secret"

image.php?hash=fd5b2b4f711fd0b11a3a5e21e67796552782c5ef

3. Add a description and select an expiry length - please note Microsoft requires these are renewed every 24 months. 

image.png

4. Click Add

5. Copy the secret value and save it into Schoolbox > Admin > Settings > 3rd Party Services > Microsoft Office 365 App Secret

 

Permissions

1. Select "API permissions"

image.php?hash=90a2757f8fa1b90bfff64f00609cbd903d8b3a1b

2. Select "Add a permission"

image.php?hash=6b37e51b8279d79678749c9414e7ef332f67a8b7

3. Select "SharePoint"

image.png

4. Select "Delegated permissions", then Tick "MyFiles.Read", then "Add permissions"

 image.png

5. Click "Grant admin consent for [Your School Name]" - both User.Read and MyFiles.Read should then have a green tick as shown below

image.png

If the above permission steps have not been entered correctly, you will not be able to access files from OneDrive within Schoolbox. 

 

Testing it out

You should now be ready to try out connecting to OneDrive from within a Schoolbox file picker.