Skip to Content
GuidesSetup Social Auth

Setting Up Social Authentication

Social authentication allows users to register and log into your site using their accounts from popular social networks and services. This significantly simplifies the registration process and increases user conversion.

⚠️

To configure social authentication you need to have admin.system or admin.boss permissions.

Supported Services

Flute CMS supports authentication through the following services:

  • Discord — popular among gamers
  • Steam — for gaming communities
  • Google — universal solution
  • GitHub — for developer communities
  • VKontakte — popular in CIS countries
  • Yandex — popular in Russia and CIS

If you need authentication through a service not listed, you can request its addition in our Discord .

General Setup Principles

Creating application in service

For each social network you need to:

  1. Register application in the developer console of the service
  2. Get credentials — Client ID and Client Secret
  3. Configure redirect URLs — specify your site’s address
  4. Set up permissions — select what data the application can access

Configuring in Flute CMS

After getting credentials from the service:

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find the needed service and click “Configure”
  3. Enter the received Client ID and Client Secret
  4. Save settings

Setting Up Discord

Discord is one of the most popular services for gaming communities.

Create application on Discord

  1. Go to Discord Developer Portal 
  2. Click “New Application”
  3. Enter application name (your site name)
  4. Click “Create”

Get credentials

  1. In the application settings go to “OAuth2” section
  2. Copy Client ID
  3. Copy Client Secret (click “Reset Secret” if needed)

Configure redirects

  1. In “OAuth2” section find “Redirects”
  2. Click “Add Redirect”
  3. Enter URL: https://yoursite.com/auth/social/discord/callback
  4. Save changes

Configure in Flute CMS

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find Discord and click “Configure”
  3. Enter Client ID and Client Secret
  4. Save settings

Make sure to use HTTPS for redirect URLs. Most services require secure connections.

Setting Up Steam

Steam authentication is ideal for gaming sites.

Get Steam API key

  1. Go to Steam Web API Key 
  2. Enter your domain name
  3. Agree to terms and get API key

Configure in Flute CMS

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find Steam and click “Configure”
  3. Enter the received API key
  4. Save settings
⚠️

Steam uses OpenID protocol and doesn’t require creating a separate application, only an API key.

Setting Up Google

Google authentication provides access to a wide audience.

Create project in Google Cloud

  1. Go to Google Cloud Console 
  2. Create new project or select existing one
  3. Enable “Google+ API” in API library

Configure OAuth 2.0

  1. Go to “Credentials” section
  2. Click “Create Credentials” → “OAuth 2.0 Client IDs”
  3. Select application type “Web application”
  4. Add authorized redirect URI: https://yoursite.com/auth/social/google/callback

Get credentials

  1. Copy Client ID
  2. Copy Client Secret

Configure in Flute CMS

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find Google and click “Configure”
  3. Enter Client ID and Client Secret
  4. Save settings

Setting Up GitHub

GitHub authentication is suitable for developer communities.

Create OAuth App

  1. Go to GitHub Developer Settings 
  2. Click “New OAuth App”
  3. Fill in the form:

Get credentials

  1. Copy Client ID
  2. Generate and copy Client Secret

Configure in Flute CMS

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find GitHub and click “Configure”
  3. Enter Client ID and Client Secret
  4. Save settings

Setting Up VKontakte

VKontakte is popular in CIS countries.

Create application

  1. Go to VK Developers 
  2. Click “Create Application”
  3. Select “Website” type
  4. Enter site address

Configure application

  1. In application settings go to “Settings” section
  2. Add redirect URI: https://yoursite.com/auth/social/vkontakte/callback
  3. Set required permissions (email, basic info)

Get credentials

  1. Copy Application ID (Client ID)
  2. Copy Secure Key (Client Secret)

Configure in Flute CMS

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find VKontakte and click “Configure”
  3. Enter Application ID and Secure Key
  4. Save settings

Setting Up Yandex

Yandex is popular in Russia and CIS countries.

Create application

  1. Go to Yandex OAuth 
  2. Click “Register new client”
  3. Fill in application information
  4. Select required permissions

Configure redirects

  1. In “Callback URI” field enter: https://yoursite.com/auth/social/yandex/callback
  2. Save application

Get credentials

  1. Copy Client ID
  2. Copy Client Secret

Configure in Flute CMS

  1. Go to Admin Panel → General Settings → Social Networks
  2. Find Yandex and click “Configure”
  3. Enter Client ID and Client Secret
  4. Save settings

Testing Social Authentication

Checking configuration

After setting up each service:

  1. Log out from your site
  2. Go to login page
  3. Click social network button
  4. Check redirect to service
  5. Authorize and check return to site
  6. Verify that account is created/linked

Typical problems

Redirect error — check that callback URL is correctly specified in service settings.

Authorization error — verify that Client ID and Client Secret are entered correctly.

Permission error — make sure application has necessary permissions to access user data.

Additional Settings

Automatic role assignment

You can configure automatic role assignment for users registering through social networks:

  1. Go to Admin Panel → General Settings → Social Networks
  2. For each service select default role
  3. Save settings

Data synchronization

Configure which data to import from social networks:

  • Avatar
  • Username
  • Email address
  • Additional profile information

Social authentication significantly improves user experience and increases registration conversion on your site.

Setup Main TemplateOptimization