Single Sign-On (SSO) allows your users to sign in using their existing accounts from popular providers like Google and GitHub. This makes registration and login faster and more convenient for your users.

Available SSO Providers

Gately supports multiple social login providers that you can enable through the dashboard:

Google OAuth

Let users sign in with their Google accounts.
  • Gmail and Google Workspace accounts
  • Automatic profile information sync
  • Trusted by billions of users
  • Works on all devices

GitHub OAuth

Perfect for developer-focused websites and applications.
  • GitHub personal and organization accounts
  • Developer profile information
  • Popular with technical audiences
  • Secure OAuth 2.0 implementation

Custom OAuth

Connect any OAuth 2.0 provider to your site.
  • Facebook, Twitter, LinkedIn
  • Microsoft Azure AD
  • Custom enterprise providers
  • SAML 2.0 support

Enterprise SSO

Enterprise-grade authentication for business users.
  • Active Directory integration
  • SAML 2.0 providers
  • Custom enterprise solutions
  • Role-based access control

How SSO Works

Once you enable SSO providers in your Gately dashboard, users will automatically see social login buttons on your authentication forms:

User Experience

  1. User clicks social login button (e.g., “Sign in with Google”)
  2. Redirected to provider - User goes to Google/GitHub to authenticate
  3. User authorizes your app - User grants permission to access their profile
  4. Automatic account creation - Gately creates an account if it’s their first time
  5. User returns to your site - Logged in and ready to use your application

Automatic Features

  • Profile sync - User’s name, email, and avatar are automatically imported
  • Account linking - If user already has an account, SSO gets linked to it
  • Session management - User stays logged in across visits
  • Security - All OAuth flows are handled securely by Gately

Dashboard Configuration

Set up SSO providers through the Gately dashboard without any coding:

Step 1: Enable SSO Providers

  1. Go to SettingsAuthenticationSocial Login
  2. Toggle on the providers you want to use (Google, GitHub, etc.)
  3. Configure each provider with your OAuth credentials

Step 2: Configure Provider Settings

  • Google OAuth - Add your Google Client ID and Secret
  • GitHub OAuth - Add your GitHub Client ID and Secret
  • Custom Providers - Configure any OAuth 2.0 provider
  • Enterprise SSO - Set up SAML or custom enterprise authentication

Step 3: Customize User Experience

  • Button styling - Match your brand colors and fonts
  • Button text - Customize button labels (“Sign in with Google”)
  • Redirect URLs - Set where users go after successful login
  • Error handling - Configure error messages and fallback options

Authentication Modes

Gately automatically handles different authentication modes based on your users’ devices and preferences:

Desktop Experience

  • Popup windows - Opens OAuth provider in a small popup window
  • User stays on your page - No page reload required
  • Automatic popup closing - Popup closes after successful authentication
  • Error handling - Graceful error messages if authentication fails

Mobile Experience

  • Full page redirect - Takes user to OAuth provider’s mobile-optimized page
  • Seamless return - User automatically returns to your site after authentication
  • Touch-friendly - Optimized for mobile touch interactions
  • No popup blockers - Works reliably on all mobile browsers

Platform Integration

SSO works seamlessly across all no-code platforms:

Framer Integration

  • Automatic button generation - SSO buttons appear automatically in your authentication forms
  • Brand matching - Buttons automatically match your Framer site’s design
  • Responsive design - Works perfectly on all screen sizes
  • Component integration - Integrates with Framer’s component system

Webflow Integration

  • Custom attributes - Use Webflow’s custom attributes to control SSO buttons
  • CMS compatibility - Works with Webflow CMS and dynamic content
  • Interaction support - Compatible with Webflow interactions and animations
  • Symbol management - Control SSO buttons through Webflow symbols

Universal Compatibility

  • Any HTML platform - Works with any website that supports custom HTML/JavaScript
  • CSS framework support - Compatible with Bootstrap, Tailwind, and other frameworks
  • Custom styling - Full control over button appearance and behavior

Provider Setup Guide

You’ll need to create OAuth applications with each provider before enabling them in Gately.

Google OAuth Setup

  1. Go to Google Cloud Console - Visit console.cloud.google.com
  2. Create or select project - Choose your project or create a new one
  3. Enable Google+ API - Enable the required APIs for authentication
  4. Create OAuth credentials - Generate Client ID and Client Secret
  5. Set redirect URI - Add https://sdk.usegately.com/api/sdk/auth/google
  6. Add to Gately dashboard - Copy credentials to your Gately settings

GitHub OAuth Setup

  1. Go to GitHub Settings - Navigate to Settings → Developer settings → OAuth Apps
  2. Create new OAuth App - Register your application with GitHub
  3. Set callback URL - Use https://sdk.usegately.com/api/sdk/auth/github
  4. Get credentials - Copy Client ID and Client Secret
  5. Configure in Gately - Add credentials to your dashboard settings

Custom Provider Setup

  1. Choose your provider - Facebook, Twitter, LinkedIn, Microsoft, etc.
  2. Create OAuth application - Register with your chosen provider
  3. Configure redirect URI - Use Gately’s callback URL for your provider
  4. Get credentials - Obtain Client ID and Client Secret
  5. Add to dashboard - Configure in Gately’s custom provider settings

Best Practices

Next Steps