If you are having trouble with the OneNote for Business or OneDrive for Business integration, we encourage you to see the Troubleshooting section at the bottom of this article, contact your organization’s Microsoft administrator, and/or share this article with them.
Please note that we do not fully support Microsoft Sharepoint accounts at the moment.
How Will My Tenants Connect to OneNote and OneDrive?
Users will connect by doing three main actions:
- Choosing the folder to store their scans
- Uploading scans to their selected folder
Each step is detailed below:
- Authentication: Users will sign in with their Microsoft credentials.
- Rocketbook will not store any of their credentials and will pass those credentials to Microsoft's API to authenticate the user.
- The received token will be stored only locally on the device to keep the user authenticated. No authentication data is ever stored in Rocketbook servers.
- Folder selection: Users will select the folder they want to use to receive their scans.
- The Rocketbook app will display the list of folders the user has access to.
- The user will select the folder he wishes to connect to.
- The selected folder’s identifier will be stored locally on the device. The Rocketbook app will use this identifier when uploading scans.
- Uploading: Users will scan their documents, and choose the symbol connected with OneNote or OneDrive to send their documents.
- The user will scan one or multiple pages.
- When they are done scanning, they will select the symbol(s) connected to OneNote or OneDrive and tap "Next."
- The user will review their documents and tap "Send."
- The Rocketbook app will upload the documents to OneNote or OneDrive.
- A copy of the scans will be stored locally on the device in order for the user to review it in the Rocketbook app.
Which Delegated Permissions Does Rocketbook Require?
A delegated permission means that this application may act on behalf of a user for the particular permission. Here is the list of the permissions required by Rocketbook:
- User.Read: Allows users to sign-in to OneNote or OneDrive using the Rocketbook app.
- Files.ReadWrite: Allows the Rocketbook app to send files to your folder or notebook.
- Notes.ReadWrite: Allows the Rocketbook app to create and retrieve notebooks or folders that the user owns. With this, the Rocketbook app can allow users to choose any notebook or folder when configuring a destination.
- Notes.ReadWrite.All: Allows the Rocketbook app to retrieve all the notebooks shared with the user. That way, users can choose a notebook that they do not own, but is shared with them when configuring a destination.
- Offline_access: Allows the app to see and update the data users gave it access to, even when they are not currently using the app. This does not give the app any additional permissions.
What is Required by the Administrators?
Administrators will have to make sure that the Rocketbook app has the right access to do these actions on behalf of the users. They can do this by granting consent to the Rocketbook app. As an admin, you can grant the consent by clicking here.
After granting consent you should see the Rocketbook app in your Azure Portal > Enterprise Applications.
When clicking on the Rocketbook app and then the "Permissions" tab, you will see the following permissions that were granted.
You can read more about Microsoft’s delegated permissions here.
If you are a Rocketbook user and cannot find or connect to a folder or notebook, please try the following steps:
- Ensure that you have permission to access the desired folder or notebook.
- Contact your Microsoft administrator to see if there are any specific security or permission configurations preventing you from accessing the desired folder or notebook. You may want to share this article with them so they understand how the Rocketbook app integrates with OneNote and OneDrive.
Each organization has its own unique rules and configurations for Microsoft and the permissions granted for their users. Your Microsoft administrator is the best person to contact when you are having issues connecting or sending files to OneNote or OneDrive. They know all configurations needed for an external app to access your Microsoft environment.
For additional questions or assistance, please email us at firstname.lastname@example.org