Launching the Platform/Self hosted/Prerequisites

OAuth Provider

Setup and configure OAuth provider for your self-hosted platform

Overview

Purpose

  • User authentication
  • Access control
  • Single sign-on capabilities
  • Identity management

Key Features

  • OpenID Connect support
  • OAuth 2.0 compliance
  • User profile information
  • Email verification

Provider Options

Google OAuth Setup

Access Google Cloud Console

Create OAuth Client

  • Click + CREATE CREDENTIALS
  • Select OAuth client ID
  • Choose Web application type

Configure OAuth Client

  • Add Authorized JavaScript origins:
    https://your-domain.com
  • Add Authorized redirect URIs:
    https://your-domain.com/api/auth/callback/google

Make sure to replace your-domain.com with your actual platform domain.

JWT Configuration

Store this key securely - it's used to sign user sessions.

Information Collection

Required Values for Platform Installation

  • OAuth Client ID
  • OAuth Client Secret
  • JWT signing key
  • Configured redirect URI
auth:
  jwtSigningKey: "your-generated-key" # From openssl command
  providers:
    google:
      enabled: true
      clientID: "your-client-id" # From OAuth provider
      clientSecret: "your-secret" # From OAuth provider

Validation

Verify OAuth client is properly configured ### Confirm redirect URIs match

your domain ### Check JWT signing key is generated and saved ### Validate required scopes are enabled

Troubleshooting

Invalid Redirect URI

  • Verify exact URI match
  • Check for protocol (https) mismatch
  • Confirm domain spelling

Authentication Failures

  • Verify client credentials
  • Check scope configurations
  • Validate JWT signing key

Need help? Contact [email protected] if you encounter any issues.