Authentication Methods

Google OAuth

yWorkflow App uses Google OAuth 2.0 for secure authentication. Users sign in with their Google account, providing a seamless and secure login experience.

How it works: Click the "Sign in with Google" button on the login page. You'll be redirected to Google's authentication service, and after successful authentication, you'll be redirected back to the application.

Authentication Flow

1

Visit Login Page

Navigate to the application URL and you'll be presented with the login page.

2

Click Authentication Button

Click the "Sign in with Google" button.

3

OAuth Provider Redirect

You'll be redirected to Google to authenticate.

4

Callback Processing

After successful authentication, you'll be redirected to /auth/callback where the backend validates your token.

5

Session Creation

The backend creates or updates your user session and returns a JWT token to the frontend.

6

Token Storage

The frontend stores the JWT token in localStorage and redirects you to the main dashboard.

Session Management

Session Expiration

When your session expires (401/403 responses), the application automatically detects this and prompts you to re-authenticate. A modal will appear asking you to log in again.

Note: If the backend is in maintenance mode (503 response), you'll see a maintenance message on the login page.

User Roles

Regular User

Regular users have access to standard features:

  • Create and manage API keys
  • Configure webhooks
  • View quotas (read-only)
  • Edit organization name
  • Switch between organizations

Organization Management

Users can belong to multiple organizations. Each organization has its own:

  • Unique ID and name
  • Owner (user who created it)
  • Quotas (limits for API keys, definitions, executions, rate limits)
  • API keys
  • Webhook configuration

Organization Selector: Use the organization dropdown in the header to switch between organizations you belong to. All operations are scoped to the selected organization.