Social Login Setup

Allow users to sign in using their existing social media accounts. ChatNet uses HybridAuth to support multiple providers including Facebook, Google, GitHub, Twitter/X, Discord, LinkedIn, and Apple. This guide walks you through setting up each provider.

Navigate to Social Login

Overview

Social login simplifies registration and increases conversion by letting users sign in with accounts they already have. All providers follow a similar setup pattern:

1. Register your app with the provider
2. Configure the OAuth callback URL: https://yourdomain.com/hybridauth_callback
3. Copy the credentials (Client ID/Secret)
4. Enter credentials in ChatNet's Social Login settings
5. Enable the provider and test

Facebook

1. Go to Facebook Developers
2. Create a new app (select "Consumer" type)
3. Add the "Facebook Login" product
4. Go to Facebook Login > Settings
5. Add Valid OAuth Redirect URI: https://yourdomain.com/hybridauth_callback
6. Go to Settings > Basic to copy App ID and App Secret

Google

1. Go to Google Cloud Console
2. Create a new project (or select existing)
3. Navigate to APIs & Services > Credentials
4. Click "Create Credentials" > "OAuth client ID"
5. Select "Web application" as the type
6. Add Authorized redirect URI: https://yourdomain.com/hybridauth_callback
7. Copy Client ID and Client Secret

You may also need to configure the OAuth consent screen with your app name and authorized domains.

GitHub

1. Go to GitHub Developer Settings
2. Click "New OAuth App"
3. Fill in application details
4. Set Authorization callback URL: https://yourdomain.com/hybridauth_callback
5. Click "Register application"
6. Copy Client ID and generate a Client Secret

Twitter / X

1. Go to Twitter Developer Portal
2. Create a new project and app
3. Navigate to your app's "Keys and tokens" section
4. Under "User authentication settings", click "Set up"
5. Enable OAuth 2.0
6. Add callback URL: https://yourdomain.com/hybridauth_callback
7. Copy API Key and API Secret from "Keys and tokens"

Discord

1. Go to Discord Developer Portal
2. Click "New Application"
3. Navigate to OAuth2 > General
4. Add redirect URL: https://yourdomain.com/hybridauth_callback
5. Copy Client ID and Client Secret

Required Scopes

ChatNet requests these OAuth2 scopes:

• identify - Access user's basic info
• email - Access user's email address

LinkedIn

1. Go to LinkedIn Developer Portal
2. Create a new app
3. Verify your company page (required)
4. Navigate to Auth settings
5. Add redirect URL: https://yourdomain.com/hybridauth_callback
6. Copy Client ID and Client Secret

Required Products

Enable these products in your LinkedIn app:

• Sign In with LinkedIn using OpenID Connect

Apple

Apple Sign In requires an Apple Developer account ($99/year).

1. Go to Apple Developer Portal
2. Navigate to Certificates, Identifiers & Profiles
3. Create an App ID with "Sign in with Apple" capability
4. Create a Services ID for web authentication
5. Configure your domain and return URL
6. Create a private key for Sign in with Apple

Step-by-Step Apple Setup

1. Create App ID

• Go to Identifiers > App IDs
• Register a new identifier
• Enable "Sign in with Apple" capability
• Note your Bundle ID

2. Create Services ID

• Go to Identifiers > Services IDs
• Register a new Services ID
• Enable "Sign in with Apple"
• Configure web domain: yourdomain.com
• Add return URL: https://yourdomain.com/hybridauth_callback

3. Create Private Key

• Go to Keys
• Create a new key with "Sign in with Apple" enabled
• Download the .p8 file (keep this secure!)
• Note the Key ID

Troubleshooting