Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
maxLevel2
absoluteUrltrue

...

Info

You must have admin access to log into OneDrive Application account.


Prerequisites

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

...

ParameterData TypeDescriptionDefault ValueExample 

Label

String

Required. Specify a unique label for the account.

N/A

OneDrive_Docs_App_Account

Client ID

String

RequiredSpecify 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

Specify 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

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

Click the + or - icons to respectively add or remove configuration rows.

Info
titleToken endpoint parameters

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


Token endpoint parameter

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

Token endpoint parameter value

String

Enter the value for the parameter, typically the default scopeSee Scopes and permissions required for OneDrive API.

N/A.default
Auth endpoint config

Use this field set to assign specific Auth endpoint parameters for OAuth2 Authentication endpoint for the App account. Configuring values in the field set is optional.

  • Authentication parameter
  • Authentication parameter value

Click the + or - icons to respectively add or remove configuration rows.

Authentication parameter

String

Enter the name for an authentication parameter.N/AScope

Authentication parameter value

String

Enter  the value for the parameter.

N/AReadWrite.All
AuthorizeButton

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

For existing accounts, you can click this button 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

...


Scopes and Permissions required for OneDrive API

OneDrive and SharePoint expose a few granular permissions that control the access that apps have to resources. When a user signs in to your app they, or, in some cases, an administrator, are required to provide consent to these permissions. For more information on the available scopes, refer Microsoft Graph permissions.

Files

Delegated permissions

PermissionDisplay StringDescriptionAdmin Consent Required?Files.ReadRead user filesAllows the app to read the signed-in user's files.NoFiles.Read.AllRead all files that user can accessAllows the app to read all files the signed-in user can access.NoFiles.ReadWriteHave full access to user filesAllows the app to read, create, update, and delete the signed-in user's files.NoFiles.ReadWrite.AllHave full access to all files user can accessAllows the app to read, create, update, and delete all files the signed-in user can access.NoFiles.ReadWrite.AppFolderHave full access to the application's folder (preview)Allows the app to read, create, update, and delete files in the application's folder.NoFiles.Read.SelectedRead files that the user selectsAllows the app to read files that the user selects. The app has access for several hours after the user selects a file.NoFiles.ReadWrite.SelectedRead and write files that the user selectsAllows the app to read and write files that the user selects. The app has access for several hours after the user selects a file.No

Application permissions

PermissionDisplay StringDescriptionAdmin Consent Required?Files.Read.AllRead files in all site collectionsAllows the app to read all files in all site collections without a signed in user.YesFiles.ReadWrite.AllRead and write files in all site collectionsAllows the app to read, create, update, and delete all files in all site collections without a signed in user.Yes

Sites

Delegated permissions

PermissionDisplay StringDescriptionAdmin Consent Required?Sites.Read.AllRead items in all site collectionsAllows the app to read documents and list items in all site collections on behalf of the signed-in user.NoSites.ReadWrite.AllRead and write items in all site collectionsAllows the app to edit or delete documents and list items in all site collections on behalf of the signed-in user.NoSites.Manage.AllCreate, edit, and delete items and lists in all site collectionsAllows the app to manage and create lists, documents, and list items in all site collections on behalf of the signed-in user.NoSites.FullControl.AllHave full control of all site collectionsAllows the app to have full control to SharePoint sites in all site collections on behalf of the signed-in user.Yes

Users

Delegated permissions

PermissionDisplay StringDescriptionAdmin Consent Required?
Sign in and read user profileAllows users to sign-in to the app, and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users.NoUser.ReadWriteRead and write access to user profileAllows the app to read your profile. It also allows the app to update your profile information on your behalf.No

Application permissions

PermissionDisplay StringDescriptionAdmin Consent Required?
Read all users' full profilesAllows the app to read user profiles without a signed in user.Yes
Read and write all users' full profilesAllows the app to read and update user profiles without a signed in user.Yes

Permissions.

Insert excerpt
Microsoft OneDrive Snap Pack
Microsoft OneDrive Snap Pack
nopaneltrue

...