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:
- Register application in the developer console of the service
- Get credentials — Client ID and Client Secret
- Configure redirect URLs — specify your site’s address
- Set up permissions — select what data the application can access
Configuring in Flute CMS
After getting credentials from the service:
- Go to
Admin Panel
→General Settings
→Social Networks
- Find the needed service and click “Configure”
- Enter the received Client ID and Client Secret
- Save settings
Setting Up Discord
Discord is one of the most popular services for gaming communities.
Create application on Discord
- Go to Discord Developer Portal
- Click “New Application”
- Enter application name (your site name)
- Click “Create”
Get credentials
- In the application settings go to “OAuth2” section
- Copy Client ID
- Copy Client Secret (click “Reset Secret” if needed)
Configure redirects
- In “OAuth2” section find “Redirects”
- Click “Add Redirect”
- Enter URL:
https://yoursite.com/auth/social/discord/callback
- Save changes
Configure in Flute CMS
- Go to
Admin Panel
→General Settings
→Social Networks
- Find Discord and click “Configure”
- Enter Client ID and Client Secret
- 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
- Go to Steam Web API Key
- Enter your domain name
- Agree to terms and get API key
Configure in Flute CMS
- Go to
Admin Panel
→General Settings
→Social Networks
- Find Steam and click “Configure”
- Enter the received API key
- 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
- Go to Google Cloud Console
- Create new project or select existing one
- Enable “Google+ API” in API library
Configure OAuth 2.0
- Go to “Credentials” section
- Click “Create Credentials” → “OAuth 2.0 Client IDs”
- Select application type “Web application”
- Add authorized redirect URI:
https://yoursite.com/auth/social/google/callback
Get credentials
- Copy Client ID
- Copy Client Secret
Configure in Flute CMS
- Go to
Admin Panel
→General Settings
→Social Networks
- Find Google and click “Configure”
- Enter Client ID and Client Secret
- Save settings
Setting Up GitHub
GitHub authentication is suitable for developer communities.
Create OAuth App
- Go to GitHub Developer Settings
- Click “New OAuth App”
- Fill in the form:
- Application name: Your site name
- Homepage URL: https://yoursite.com
- Authorization callback URL: https://yoursite.com/auth/social/github/callback
Get credentials
- Copy Client ID
- Generate and copy Client Secret
Configure in Flute CMS
- Go to
Admin Panel
→General Settings
→Social Networks
- Find GitHub and click “Configure”
- Enter Client ID and Client Secret
- Save settings
Setting Up VKontakte
VKontakte is popular in CIS countries.
Create application
- Go to VK Developers
- Click “Create Application”
- Select “Website” type
- Enter site address
Configure application
- In application settings go to “Settings” section
- Add redirect URI:
https://yoursite.com/auth/social/vkontakte/callback
- Set required permissions (email, basic info)
Get credentials
- Copy Application ID (Client ID)
- Copy Secure Key (Client Secret)
Configure in Flute CMS
- Go to
Admin Panel
→General Settings
→Social Networks
- Find VKontakte and click “Configure”
- Enter Application ID and Secure Key
- Save settings
Setting Up Yandex
Yandex is popular in Russia and CIS countries.
Create application
- Go to Yandex OAuth
- Click “Register new client”
- Fill in application information
- Select required permissions
Configure redirects
- In “Callback URI” field enter:
https://yoursite.com/auth/social/yandex/callback
- Save application
Get credentials
- Copy Client ID
- Copy Client Secret
Configure in Flute CMS
- Go to
Admin Panel
→General Settings
→Social Networks
- Find Yandex and click “Configure”
- Enter Client ID and Client Secret
- Save settings
Testing Social Authentication
Checking configuration
After setting up each service:
- Log out from your site
- Go to login page
- Click social network button
- Check redirect to service
- Authorize and check return to site
- 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:
- Go to
Admin Panel
→General Settings
→Social Networks
- For each service select default role
- 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.