Microsoft OneDrive User Account

In this article

Overview

Use this account type to connect Microsoft OneDrive Snaps with data sources that use Microsoft OneDrive User accounts.

Prerequisites

A registered application in the Microsoft Azure Portal with appropriate permissions. Learn more about how to configure a registered application and for information needed to define settings for the OAuth2 account: Application Configuration in Azure Portal for OAuth2 Account.

Limitations and Known Issues

None.

Account Settings


ParameterData TypeDescriptionDefault ValueExample 

Label

String

Required. Enter a unique label for the account.

N/A

OneDrive_Docs_User_Account

Client ID

String

RequiredEnter the client ID associated with your Azure application. You can create the client ID as advised by your application provider.

N/A

9ee09921-7b72-432d-b552-a21e8a1ab143

Client secret

String

Enter the client secret associated with your account. You can create the client secret as advised by your application provider.

N/A

bec1f9242f9nsh67f2276b9ws4cadd14

Access token

String

Auto-generated after authorization. The access token associated with the Azure portal application is used to make API requests on behalf of the user associated with the client ID.

N/AN/A
Refresh tokenStringThe refresh token retrieval for the application is specified when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting refresh token can be stored in this property. If the refresh token is stored, then the access token can be refreshed automatically before it expires.N/AN/A

Access token expiration

IntegerThe access token expiration value.N/AN/A

OAuth2 Endpoint

String

Required. Authorization endpoint to authorize the application.

https://login.microsoftonline.com/
<tenant_id>/oauth2/v2.0/authorize
https://login.microsoftonline.com/9ee09921-7b72-432d-b552-a21e8a1ab143/oauth2/v2.0/authorize

OAuth2 Token

String

Required. Token endpoint to get the access token.

https://login.microsoftonline.com/
<tenant_id>/oauth2/v2.0/token
https://login.microsoftonline.com/9ee09921-7b72-432d-b552-a21e8a1ab143/oauth2/v2.0/token

Token endpoint config

Use this field set to configure token endpoint parameters as necessary for the account. This field set comprises the following fields:

  • Token endpoint parameter
  • Token endpoint parameter value

Token endpoint parameters

Provide the value scope to the Token endpoint parameter in this field set.

Learn more about OAuth2.0 authorization code flow.

Token endpoint parameter

StringProvide the name for the token endpoint parameter.N/Ascope

Token endpoint parameter value

String

Provide the value for the parameter, typically the default scope.

Specify the User.Read.All scope in this field to allow the OneDrive Snaps to suggest users in the User suggestion field.

N/Aoffline_access Files.ReadWrite.All Sites.ReadWrite.All
Auth endpoint config

Use this field set to assign scopes for the OAuth2 Authentication endpoint for the App account. It is recommended to define at least one scope entry in this field set. This field set comprises the following fields: 

  • Authentication parameter
  • Authentication parameter value

Authentication parameter

String

Provide additional parameters as required for authentication.N/Ascope

Authentication parameter value

String

Provide value for the parameters specified above.

N/Aoffline_access Files.ReadWrite.All Sites.ReadWrite.All
Auto-refresh tokenCheck boxSelect this checkbox to refresh the token automatically, using the refresh token, when the token is due for expiry. The token refresh does not happen automatically if this check box is not selected.SelectedNot selected
AuthorizeButton

Click this button to acquire the required permissions for this account from the Azure portal app, when creating an account.

You can click this button for existing accounts to re-acquire the permissions to ensure that the account works as expected. This action does not require or result in any changes to the Access Token that is already generated.

N/AN/A
RefreshButtonClick to button to initiate a token refresh action manually. N/AN/A

Scopes and Permissions required for OneDrive API

OneDrive and SharePoint expose a few granular permissions that control apps' access to resources. When a user signs in to your app, they, or, in some cases, an administrator, must provide consent to these permissions. Learn more about the available scopes: Microsoft Graph Permissions.


Snap Pack History

 Click here to expand...

Release

Snap Pack Version 

Date

Type

Updates

November 2024main29029 StableUpdated and certified against the current SnapLogic Platform release.
August 2024438patches28439 Latest

Updated the Kotlin library for Microsoft OneDrive Snap Pack with the okhttp library Platform version to avoid Kotlin library dependency conflict.

August 2024

main27765

 

Stable

Updated and certified against the current SnapLogic Platform release.

May 2024

main26341

 

Stable

Updated and certified against the current SnapLogic Platform release.

February 2024436patches25789 Latest

Fixed a performance issue in the Copy Item Snap, which previously resulted in a nameAlreadyExists error when the Snap retried because of a connection reset.

February 2024

main25112

 

Stable

Updated and certified against the current SnapLogic Platform release.

November 2023main23721 StableUpdated and certified against the current SnapLogic Platform release.
August 2023434patches22736 Latest
  • Fixed an issue with the Mircosoft OneDrive Snap Pack where the Snaps displayed Duplicate key OneDrive error. The Snaps now hide the drive details stored in the PreservationHoldLibrary folder when displaying suggestions. You can use the Drive ID to access the PreservationHoldLibrary folder.

  • Fixed an issue with the Mircosoft OneDrive Snaps that displayed a JsonNull error when the shared library list was empty. Now, it displays the message No Suggestions available.

August 2023main22460 StableUpdated and certified against the current SnapLogic Platform release.

May 2023

main21015 

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023432patches20510 Latest

Fixed the following issues with OneDrive Snaps:

  • The Snaps erroneously displayed the permission error when the actual cause was an empty display name in the API.

  • The Snaps failed with a 403 error when selecting a user (in the User field) from the Suggestions list without the User.Read.All permission. Now you can enter the value manually in the User field and proceed with the specific operation you want to perform in OneDrive, even if the Suggestions list is not available.

February 2023main19844 StableUpgraded with the latest SnapLogic Platform release.
November 2022main18944 StableUpgraded with the latest SnapLogic Platform release.
August 2022main17386 StableUpgraded with the latest SnapLogic Platform release.
4.29main15993 StableUpgraded with the latest SnapLogic Platform release.
4.28main14627 StableUpgraded with the latest SnapLogic Platform release.
4.27main12833 StableUpgraded with the latest SnapLogic Platform release.
4.26main11181 

Stable

Upgraded with the latest SnapLogic Platform release.
4.25 Patch425patches10571
Latest

Updated the error output view of the OneDrive - Upload File Snap from a Binary view to a Document view.

4.25main9554 StableEnhanced the Update Share Permissions Snap with the Share Type and Expires fields that enable you to update the share permissions on your OneDrive items shared using the Invite or Link option. If the Share type is link, you can specify the expiry date and time for the URL that is used to share permissions.
4.24main8556 
StableNo updates made.

4.23

main73

 

Stable

Initial release of the Snap Pack with the following Snaps and Accounts:


Related Content