Authorization Property
OAuth 2.0 Authorization Token.
Syntax
onedrivecontrol.Authorization[=string]
Default Value
""
Remarks
This control supports authentication via OAuth 2.0. First, perform OAuth authentication using the OAuth control or a separate process. Once complete you should have an authorization string which looks like:
Bearer ya29.AHES6ZSZEJzATdZYjeihDn5W-VrXSsxEZu5p0pclxGdKKQAssign this value to the Authorization property before attempting any operations.
Authorization Notes
Microsoft's OAuth system is heavily integrated into Azure Active Directory, which has undergone a number of restructurings in recent years. The task of registering an application for use with Microsoft Graph (or any other Microsoft service that supports OAuth authentication) is a common point of confusion, especially given the continued availability of old documentation about Azure AD.At this time, the most straightforward instructions available for registering an application for use with Microsoft Graph can be found on Register your app page of the Microsoft Graph API documentation. One of the steps on that page is selecting the application's supported account types. In most cases, the "Accounts in any organizational directory and personal Microsoft accounts" option is the most appropriate.
Once the application is registered, refer to the instructions on the Get access on behalf of a user page of the Microsoft Graph API documentation for information about what endpoints to use with the OAuth control for authentication. Pay special attention to the description of the possible value for the {tenent} segment of the OAuth endpoints.
The relevant OAuth scopes vary based on whether the application will use OneDrive (Personal), or OneDrive for Business and/or SharePoint Online.
- OneDrive (Personal): The Files.* scopes.
- OneDrive for Business / SharePoint Online: The Files.* and Sites.* scopes (to use the UsersGroups configuration setting, the Group.Read.All and/or Directory.Read.All scopes are also relevant).
Refer to the Microsoft Graph API's permissions documentation for more information about the OAuth scopes that Microsoft Graph supports.
Data Type
String