OAuth Log-in Editor

Provides a user interface for OAuth client authentication, enabling users to log in and out of cloud services using OAuth 2.0.

Remarks

The OAuth Log-in Editor control allows users to authenticate with external cloud platforms (such as Microsoft 365, Azure, or Google) using OAuth 2.0. It is used in the Property Grid for properties that require secure delegated access, such as CMIS Connection or Custom Binding objects configured for OAuth authentication. The editor displays the current login status and provides login/logout buttons, guiding users through the OAuth flow.

UI Components

• Login Status Display:
  • Shows whether the user is currently logged in to the external service.
  • Displays the connected account or a prompt to log in.
• Login Button:
  • Initiates the OAuth login flow by opening the provider's login page in a secure browser dialog.
  • Guides the user through authentication and authorization steps.
  • Stores the resulting refresh token for future access.
• Logout Button:
  • Logs the user out of the external service and clears stored credentials.
  • Updates the login status display accordingly.
• Connection Information:
  • Displays the connection ID and relevant details for the current binding or connection.
  • Provides links to the login and logout URLs for troubleshooting or manual access.

Interactive Features

• OAuth Flow Integration:
  • Handles the full OAuth 2.0 authentication flow, including login, token acquisition, refresh, and logout.
  • Automatically updates the UI based on authentication state.
• Status Feedback:
  • Visual indicators show whether the user is authenticated or needs to log in.
  • Error messages and prompts guide users through re-authentication if needed.
• Keyboard and Mouse Support:
  • Enter: Activate the login or logout button.
  • Tab: Move between controls.
  • Click buttons to initiate login/logout actions.

Usage Guidance

Use the OAuth Log-in Editor to securely authenticate with cloud services required for Grooper integrations. Click the login button to begin the OAuth flow, follow the provider's prompts, and grant access as needed. The editor will store credentials and maintain authentication for future sessions. Use the logout button to disconnect and clear credentials when access is no longer required.

• For first-time setup, follow the login prompts and grant access to the required resources.
• If credentials expire or are revoked, use the login button to re-authenticate.
• Review connection details and URLs for troubleshooting or manual access.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for status display, buttons, and connection information.
• Visual cues for authentication state and error feedback.

Example

┌───────────── OAuth Log-in Editor ────────────┐
│ Status: Logged in as user@domain.com         │
│ {Logout}                                     │
└──────────────────────────────────────────────┘