MS OneDrive Integration Development Guide

Creating Test/Developer account

An Azure account that has an active subscription.

• Create an account for free
• The Azure account must have permission to manage applications in Microsoft Entra ID. Any of the following Microsoft Entra roles include the required permissions:
  • Application administrator
  • Application developer
  • Cloud application administrator
• Completion of the Set up a tenant quickstart

Registering OAuth Application

Full article: Register an application with the Microsoft identity platform . First of all you will need to have an MS Azure account. (See more...) Quick step-by-step guide:

1. Sign in to the Microsoft Entra admin center.
2. Expand the Identity menu > expand Applications > select App registrations > New registration.
3. Enter a display Name for your application.
4. Specify who can use the application, e.g "Accounts in any organizational directory".
5. Add the following Redirect URI: https://api.integration.app/oauth-callback with the Type "Web"
6. Select Register to complete the initial app registration.

When registration finishes, the Microsoft Entra admin center displays the app registration's Overview pane. You'll see the Application (client) ID there - save it somewhere.

7. Add credentials:

• Under Manage, select Certificates & secrets > Client secrets > New client secret.
• Select an expiration for the secret or specify a custom lifetime. Click Add.
• Save the secret's VALUE (not a Secret ID!) somewhere safe. This secret value will NEVER be displayed again once you've left this page.

8. Configure API permission:

• Under Manage, select API permissions > select Add API permissions.
• Select Microsoft Graph > Delegated.
• Add the following permissions: offline_access, openid, User.Read, User.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All. You can add more permissions if you need to use API requests that require them.

Configure the app parameters in the integration.app platform

• Add the Microsoft Outlook app from store in the Integration.app console
• Click Configure & Test
• In the Parameters section, select a Use custom parameters toggle / Edit Parameters
• Put the the Application (client) ID into Client Id and the app secret into the Client Secret

Troubleshooting

• If you're getting unauthorized_client error, high chances are you've provided either incorrec client ID or client Secret
• If you're getting a 403 error when trying to create a connection to the onedrive-connector, make sure the API Permissions you've selected contain the scopes mentioned in this documentation. Also, you may want to check the API Permissions tab and grant Admin consent to the requested scopes too