PHPackages                             fishawack/laravel-passport-socialite - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. fishawack/laravel-passport-socialite

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

fishawack/laravel-passport-socialite
====================================

The missing laravel passport feature for social authentication

v2.0.0(7y ago)00MITPHPPHP ^7.1.3

Since May 3Pushed 6y agoCompare

[ Source](https://github.com/fishawack/laravel-passport-socialite)[ Packagist](https://packagist.org/packages/fishawack/laravel-passport-socialite)[ RSS](/packages/fishawack-laravel-passport-socialite/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (4)Versions (6)Used By (0)

Laravel Passport Socialite
==========================

[](#laravel-passport-socialite)

The missing social authentication plugin (i.e. SocialGrant) for laravel passport.

Description
-----------

[](#description)

This package helps integrate social login using laravel's native packages i.e. (passport and socialite). This package allows social login from the providers that is supported in laravel/socialite package.

Getting Started
---------------

[](#getting-started)

To get started add the following package to your composer.json file using this command.

`composer require schedula/laravel-passport-socialite`

Configuration
-------------

[](#configuration)

When composer installs this package successfully, register the `Schedula\Laravel\PassportSocialite\PassportSocialiteServiceProvider::class` in your `config/app.php` configuration file.

```
'providers' => [
    // Other service providers...
    Schedula\Laravel\PassportSocialite\PassportSocialiteServiceProvider::class,
],
```

**Note: You need to configure third party social provider keys and secret strings as mentioned in laravel socialite documentation **

Usage
-----

[](#usage)

### Step 1 - Setting up the User model

[](#step-1---setting-up-the-user-model)

Implement `UserSocialAccount` on your `User` model and then add method `findForPassportSocialite`. `findForPassportSocialite` should accept two arguments i.e. `$provider` and `$id`

**$provider - string - will be the social provider i.e. facebook, google, github etc.**

**$id - string - is the user id as per social provider for example facebook's user id 1234567890**

**And the function should find the user which is related to that information and return user object or return null if not found**

Below is how your `User` model should look like after above implementations.

```
namespace App;

use Schedula\Laravel\PassportSocialite\User\UserSocialAccount;
class User extends Authenticatable implements UserSocialAccount {

    use HasApiTokens, Notifiable;

    /**
    * Find user using social provider's id
    *
    * @param string $provider Provider name as requested from oauth e.g. facebook
    * @param string $id User id of social provider
    *
    * @return User
    */
    public static function findForPassportSocialite($provider,$id) {
        $account = SocialAccount::where('provider', $provider)->where('provider_user_id', $id)->first();
        if($account) {
            if($account->user){
                return $account->user;
            }
        }
        return;
    }
}
```

**Note: `SocialAccount` here is a laravel model where I am saving provider and provider\_user\_id and local database user id. Below is the example of `social_accounts` table**

idproviderprovider\_user\_iduser\_idcreated\_atupdated\_at1facebookXXXXXXXXXXXXXX1XX-XX-XX XX:XX:XXXX-XX-XX XX:XX:XX2githubXXXXXXXXXXXXXX2XX-XX-XX XX:XX:XXXX-XX-XX XX:XX:XX3googleXXXXXXXXXXXXXX3XX-XX-XX XX:XX:XXXX-XX-XX XX:XX:XX### Step 2 - Getting access token using social provider

[](#step-2---getting-access-token-using-social-provider)

I recommend you to not to request for access token from social grant directly from your app since the logic / concept of social login is you need to create account if it doesn't exists or else login if exists.

So here in this case we will be making a custom route and a controller that will recieve the Access Token or Authorization Token from your client i.e. Android, iOS etc. application. **Here client fetches access token / authorization token from provider**

Our route here can be something like this:

`Route::post('/auth/social/facebook', 'SocialLogin@loginFacebook');`

And here is how we can write our controller and its method for that :

```
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use Route;
class SocialLogin extends Controller {

	public function loginFacebook(Request $request) {
		try {

			$facebook = Socialite::driver('facebook')->userFromToken($request->accessToken);
			if(!$exist = SocialAccount::where('provider',  SocialAccount::SERVICE_FACEBOOK)->where('provider_user_id', $facebook->getId())->first()){

				// create user account
			}
			return response()->json($this->issueToken($request, 'facebook', $request->accessToken));
		}
		catch(\Exception $e) {
			return response()->json([ "error" => $e->getMessage() ]);
		}

	}

	public function issueToken($request, $provider, $accessToken) {

		/**
		* Here we will request our app to generate access token
		* and refresh token for the user using its social identity by providing access token
		* and provider name of the provider. (I hope its not confusing)
		* and then it goes through social grant and which fetches providers user id then calls
		* findForPassportSocialite from your user model if it returns User object then it generates
		* oauth tokens or else will throw error message normally like other oauth requests.
		*/
		$params = [
			'grant_type' => 'social',
			'client_id' => 'your-client-id', // it should be password grant client
			'client_secret' => 'client-secret',
			'accessToken' => $accessToken, // access token from provider
			'provider' => $provider, // i.e. facebook
		];
		$request->request->add($params);

		$requestToken = Request::create("oauth/token", "POST");
		$response = Route::dispatch($requestToken);

		return json_decode((string) $response->content(), true);
	}
}
```

**Note: SocialGrant will only accept access token not authorization token, for example google provides authorization token in android when requested server auth code i.e. offline access, so you need to exchange auth code for an access token. Refer here: **

**Note: SocialGrant acts similar to PasswordGrant so make sure you use client id and secret of password grant while making oauth request**

**That's all folks**

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 83.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~68 days

Total

5

Last Release

2659d ago

Major Versions

v1.0.3 → v2.0.02019-01-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/254646d513e4636788cdc20243419b60a17c32aef19bf391d3738cce768498e7?d=identicon)[fishawack](/maintainers/fishawack)

---

Top Contributors

[![anandsiddharth](https://avatars.githubusercontent.com/u/6649533?v=4)](https://github.com/anandsiddharth "anandsiddharth (26 commits)")[![hlca](https://avatars.githubusercontent.com/u/1301913?v=4)](https://github.com/hlca "hlca (3 commits)")[![fishawack](https://avatars.githubusercontent.com/u/6722269?v=4)](https://github.com/fishawack "fishawack (2 commits)")

---

Tags

laravelsocialitepassportlaravel socialiteSocial Loginlaravel passport

### Embed Badge

![Health badge](/badges/fishawack-laravel-passport-socialite/health.svg)

```
[![Health](https://phpackages.com/badges/fishawack-laravel-passport-socialite/health.svg)](https://phpackages.com/packages/fishawack-laravel-passport-socialite)
```

###  Alternatives

[schedula/laravel-passport-socialite

The missing laravel passport feature for social authentication

4922.6k](/packages/schedula-laravel-passport-socialite)[socialiteproviders/manager

Easily add new or override built-in providers in Laravel Socialite.

42442.0M544](/packages/socialiteproviders-manager)[andrewdwallo/filament-companies

A comprehensive Laravel authentication and authorization system designed for Filament, focusing on multi-tenant company management.

34450.0k2](/packages/andrewdwallo-filament-companies)[corbosman/laravel-passport-claims

Add claims to Laravel Passport JWT Tokens

88655.9k](/packages/corbosman-laravel-passport-claims)[truckersmp/steam-socialite

Laravel Socialite provider for Steam OpenID.

1516.7k](/packages/truckersmp-steam-socialite)[laravel-uis/socialite-ui

A Laravel Socialite UI for the new Laravel Starter Kits

114.3k1](/packages/laravel-uis-socialite-ui)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
