Library/OneDrive integration


About this feature 

Orgs using Microsoft OneDrive have the option to integrate it with their intranet's Library. Integrating with OneDrive switches the storage of all your Library content from Jostle to OneDrive, while still making it accessible from Library.

After integrating, users will be able to create and edit OneDrive/O365 items (Word, Excel, or PowerPoint) directly from their Library as well. 

Editing will be supported for the newer versions of OneDrive/O365 items (.docx, .xlsx, .pptx). Older version items (.doc, .xls, .ppt) will be "read only" (TIP: to make an older item editable, try saving it in the new version format before uploading it. For example, open an .xls file in Excel, save it as an .xlsx file, and then upload the .xlsx version).

Integration information

  • OneDrive integration works very similar to our Google Drive integration, detailed here.
  • The few differences between the OneDrive and Google Drive integrations are listed here.
  • For information regarding OneDrive delays when updating Volume permissions, jump here.

OneDrive integration can only be initiated if:

  • In Jostle, you are a System Administrator
  • In Active Directory, you are the Global Administrator for the directory being authorized.
  • Your Library is empty (all content has been downloaded and removed)


You will also need to create a "jostle_librarian" Azure user to complete your integration. See the details in Step 2 below if you wish to create this beforehand.

If you have multiple Azure accounts, make sure you are signed in as the Global Administrator user, otherwise you will run into a Need Admin Approval permission screen that will not let you continue setting up the integration.



To change storage to OneDrive 

Step 1

Go to Library settings (Library > Gear icon on the left side of the Action Bar)

In the OneDrive section, click on Change storage to OneDrive (if your Library has not been emptied, an error message will appear).


Step 2

On the Create Azure user screen, follow the details provided and create a "jostle_librarian" user.

NOTE—this user must have an O365 license (for example, Office 365 Business, Office 365 Business Essentials, etc) and must be logged in at least once through your UI before continuing with the setup. (If you receive an error trying to log in, it is most likely due to a missing permission. To resolve this, follow the "Solution" steps here).

Once this has been done, return to this screen and enter the user's email address in the field provided and click Continue.


Next, on the Permissions screen, grant access to Microsoft data by clicking Accept.


Step 3

Refresh your Library and click on the Gear icon to confirm that Library settings is showing OneDrive as Installed.


Now, if you click on the "+" from the action bar, you can upload your content (NOTEcontent cannot be dragged and dropped from OneDrive into Library at this time).

From the + (Add New) menu you can also access a OneDrive sub-menu to create new Word, Excel, and PowerPoint items.



NOTE—Volume permission delays. Currently, it takes OneDrive up to 30 minutes to update any new or edited permissions on Volumes in Library. During this time, files within such Volumes may be inaccessible.

To bypass these delays, you can log out of your Microsoft account and then log back in again. Doing this will automatically update your account with the latest Volume permissions.


To change storage back to Jostle

  1. Empty your Library.
  2. Go back to Library settings. In the Jostle section, click Change storage back to Jostle.
  3. Continue past the Warning screen. od4.PNG
  4. Manually delete Jostle from your org’s Azure instance at Azure Portal > Enterprise Apps


NOTE—after disconnecting Jostle from O365, or changing your storage back to Jostle, the “Jostle Library” folder will remain on OneDrive. If you integrate Jostle with OneDrive again, we’ll have to change the name of the old Jostle Library folder to “Jostle Library Archive {{Timestamp when disconnected}}” so that the fresh integration can happen at “Jostle Library” again.


OneDrive/Google Drive: Integration differences

OneDrive integration works very similar to our Google Drive integration (detailed here), however there are some minor differences:

Content from OneDrive cannot be uploaded to Library via drag and drop.

Library option "Block downloading from Volume" not supported with OneDrive.

Volume Librarians DO NOT need to have a OneDrive license in order to edit documents, but they DO need to have an Azure account.

Volume Librarians can delete files on the OneDrive side.

  • This is due to difference in permissions: OneDrive allows anyone who can edit a file to be able to delete it, Google Drive only lets users delete a file if they have Write access to the folder it’s in.

Volume Librarians cannot rename a file on the OneDrive side (even though they can edit or delete the file).

  • This is also a OneDrive permission-based difference. 

Groups Jostle creates for access control are always stored in an org’s own Azure Active Directory.

  • Google orgs have the choice of keeping their groups in Jostle’s domain or their own.

Library content cannot be embedded in Jostle content (e.g. News articles)

  • For security reasons (re: clickjacking), Microsoft blocks OneDrive content from being rendered in iFrames. (Jostle developers are currently exploring possible workarounds)


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Please sign in to leave a comment.