Social Auth

Allow your customers to log in or register quickly using their existing social media accounts.

Supported Providers

All providers below are built into laravel/socialite (no extra packages required), except Envato which uses socialiteproviders/envato.

Provider	Driver	Notes
Google	google
Facebook	facebook
GitHub	github
GitLab	gitlab
LinkedIn	linkedin-openid	Uses OpenID Connect (recommended)
Bitbucket	bitbucket
Slack	slack-openid	Uses OpenID Connect (recommended)
Twitch	twitch
Twitter / X	twitter
Envato	envato	Essential for verifying Envato purchases

How to Configure

1. Create an App: Register a developer application on the respective provider's platform (e.g., Google Cloud Console).
2. Obtain Credentials: Copy the Client ID and Client Secret.
3. Set Redirect URL: In your provider's app settings, set the Redirect URI to: https://yourdomain.com/auth/{provider}/callback
4. Enter Details in Admin: Go to Admin Dashboard > Settings > Social Auth and paste your credentials.

Provider Setup Guides

Google

1. Go to the Google Cloud Console and create or select a project.
2. Navigate to APIs & Services > Credentials and click Create Credentials > OAuth client ID.
3. Select Web application, then add your redirect URI: https://yourdomain.com/auth/google/callback
4. Copy the Client ID and Client Secret.
5. In the admin panel go to Settings > Social Auth > Google, enable it, and paste your credentials.

Facebook

1. Go to Meta for Developers and create an app (type: Consumer).
2. Add the Facebook Login product to your app.
3. Under Facebook Login > Settings, add your redirect URI: https://yourdomain.com/auth/facebook/callback
4. Copy the App ID and App Secret from Settings > Basic.
5. In the admin panel go to Settings > Social Auth > Facebook.

GitHub

1. Go to GitHub Developer Settings and click New OAuth App.
2. Set the Authorization callback URL to: https://yourdomain.com/auth/github/callback
3. Copy the Client ID and generate a Client Secret.
4. In the admin panel go to Settings > Social Auth > GitHub.

GitLab

1. Go to your GitLab profile > Preferences > Applications (or use the Admin Area for an instance-wide app).
2. Add a redirect URI: https://yourdomain.com/auth/gitlab/callback
3. Select scopes: read_user, openid, email, profile.
4. Copy the Application ID (Client ID) and Secret.
5. In the admin panel go to Settings > Social Auth > GitLab.

LinkedIn

1. Go to the LinkedIn Developer Portal and create an app.
2. Under Auth, add a redirect URI: https://yourdomain.com/auth/linkedin-openid/callback
3. Add the openid, profile, and email scopes under Products > Sign In with LinkedIn using OpenID Connect.
4. Copy the Client ID and Client Secret.
5. In the admin panel go to Settings > Social Auth > LinkedIn.

Bitbucket

1. Go to your Bitbucket workspace > Settings > OAuth consumers and click Add consumer.
2. Set the Callback URL to: https://yourdomain.com/auth/bitbucket/callback
3. Grant permissions: Account: Read, Email: Read.
4. Copy the Key (Client ID) and Secret.
5. In the admin panel go to Settings > Social Auth > Bitbucket.

Slack

1. Go to the Slack API and create a new app.
2. Under OAuth & Permissions, add a redirect URI: https://yourdomain.com/auth/slack-openid/callback
3. Add scopes: openid, profile, email.
4. Copy the Client ID and Client Secret from Basic Information.
5. In the admin panel go to Settings > Social Auth > Slack.

Twitch

1. Go to the Twitch Developer Console and register a new application.
2. Set the OAuth Redirect URL to: https://yourdomain.com/auth/twitch/callback
3. Copy the Client ID and generate a Client Secret.
4. In the admin panel go to Settings > Social Auth > Twitch.

Twitter / X

1. Go to the Twitter Developer Portal and create a project and app.
2. Under User authentication settings, enable OAuth 2.0 and set the redirect URI to: https://yourdomain.com/auth/twitter/callback
3. Copy the Client ID and Client Secret.
4. In the admin panel go to Settings > Social Auth > Twitter / X.

Envato

1. Go to Envato API and create an app.
2. Set the Confirmation URL to: https://yourdomain.com/auth/envato/callback
3. Copy the OAuth Client ID and Client Secret.
4. In the admin panel go to Settings > Social Auth > Envato.