OneDrive OAuth

Implements OAuth 2.0 authentication for connecting Grooper to Microsoft OneDrive and SharePoint Online using a Microsoft account.

Remarks

OneDrive OAuth provides a pre-configured OAuth 2.0 authentication method for use with OneDrive and SharePoint Online repositories in Grooper. This class manages the authentication flow required by the Microsoft Graph API, enabling secure access to cloud-based document libraries and drives.

Overview

When OneDrive OAuth is selected as the authentication method (typically via the 'Login' property of OneDrive), Grooper will prompt the user to sign in with a Microsoft account. The authentication process requests the necessary permissions (scopes) to read and write files and sites, and to maintain access while offline.

After successful authentication, Grooper receives and stores a refresh token, which is used to obtain new access tokens automatically as needed. This allows seamless, ongoing access to OneDrive and SharePoint content without repeated user interaction.

Usage Notes

• OneDrive OAuth is used internally by OneDrive and does not require direct configuration in most cases.
• When prompted, sign in with a Microsoft account that has access to the desired OneDrive or SharePoint resources.
• The required OAuth scopes are pre-configured to support file and site operations (Files.ReadWrite.All Sites.ReadWrite.All offline_access).
• If access is revoked or the refresh token expires, you will be prompted to re-authenticate.

For more information on Microsoft account requirements and OAuth permissions, see the Grooper documentation and Microsoft's official documentation for OneDrive and Microsoft Graph API.

Properties

Name	Type		Description
Authentication	Refresh Token Info	►	Provide credentials by signing in with a Microsoft account. EditorLogin Editor ConverterLogin Converter Requiredtrue The 'Authentication' property allows administrators to manage OAuth credentials for the connection. When configuring OAuth Authentication, use this property to initiate the login process and store the resulting refresh token. Click the property editor to launch the OAuth login dialog and sign in with the required account. The refresh token is securely stored and used to obtain new access tokens as needed, reducing the need for repeated logins. If the refresh token expires or is revoked, you will be prompted to re-authenticate. A Microsoft account can be created here.

Used By

ExchangeOneDriveSharePointWeb Service Lookup