OAuth Authentication

Implements OAuth 2.0 authentication for secure delegated access to external content platforms in Grooper.

Remarks

OAuth Authentication enables Grooper to connect to cloud-based repositories and services that require OAuth 2.0, a widely adopted protocol for secure delegated access. This class manages the full OAuth 2.0 flow, including user login, token acquisition, token refresh, and secure storage of credentials.

Overview

When OAuth Authentication is selected as the authentication method for a CMIS Binding or Custom Binding, Grooper redirects users to the provider's login page, obtains authorization codes, and exchanges them for access and refresh tokens. These tokens are then used to authenticate HTTP requests to the target service. The class handles token expiration and refresh automatically, minimizing the need for repeated user logins.

This method is ideal for connecting to Microsoft 365, Azure, Google, and other modern cloud platforms that require OAuth 2.0 authentication.

Usage Notes

• OAuth Authentication is typically selected as the authentication method for a CMIS Binding or Custom Binding when configuring a CMIS Connection to a cloud service.
• The first time a connection is made, users will be prompted to sign in and grant access. The resulting refresh token is securely stored and reused for subsequent connections.
• The authentication flow, including token refresh and expiration handling, is managed automatically. If the refresh token expires or is revoked, users will be prompted to re-authenticate.
• Use the 'Authentication' property in the property grid to manage credentials and initiate the login process as needed.

Example

// Pseudocode for configuring a binding with OAuth authentication var binding = new MyCustomBinding(); binding.AuthMethod = new MyOAuthAuthenticationImplementation();

After configuration, Grooper will handle all necessary authentication steps for accessing OAuth-protected resources.

For more information on OAuth 2.0 and integration with cloud services, see the Grooper documentation and your provider's official OAuth 2.0 documentation.

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.

Derived Types

There are 3 implementations of OAuth Authentication.

Exchange OAuth	Implements OAuth 2.0 authentication for connecting Grooper to Microsoft Exchange Online (Office 365) using Azure AD.
OneDrive OAuth	Implements OAuth 2.0 authentication for connecting Grooper to Microsoft OneDrive and SharePoint Online using a Microsoft account.
SharePoint OAuth	Implements OAuth 2.0 authentication for connecting Grooper to SharePoint Online (365) using Azure AD.

Used By

ExchangeSharePointWeb Service Lookup