zeriontech/socialite-zerion

Zerion OAuth2 Provider for Laravel Socialite

Zerion OAuth2 Provider for Laravel Socialite

1. Installation

composer require zeriontech/socialite-zerion, _(*1)

2. Service Provider

• Remove Laravel\Socialite\SocialiteServiceProvider from your providers[] array in config\app.php if you have added it already.
• Add SocialiteProviders\Manager\ServiceProvider to your providers[] array in config\app.php.

For example:, _(*2)

'providers' => [
    // a whole bunch of providers
    // remove 'Laravel\Socialite\SocialiteServiceProvider',
    SocialiteProviders\Manager\ServiceProvider::class, // add
];

• Note: If you would like to use the Socialite Facade, you need to install it.

3. Add the Event and Listeners

• Add SocialiteProviders\Manager\SocialiteWasCalled::class event to your listen[] array in <app_name>/Providers/EventServiceProvider., _(*3)

• Add your listeners (i.e. the ones from the providers) to the SocialiteProviders\Manager\SocialiteWasCalled[] that you just created., _(*4)

• The listener that you add for this provider is ZerionTech\SocialiteProviders\Zerion\ZerionExtendSocialite@handle., _(*5)

• Note: You do not need to add anything for the built-in socialite providers unless you override them with your own providers., _(*6)

For example:, _(*7)

/**
 * The event handler mappings for the application.
 *
 * @var array
 */
protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        'ZerionTech\SocialiteProviders\Zerion\ZerionExtendSocialite@handle'
    ],
];

4. Services Array and .env

Add to config/services.php:, _(*8)

'zerion' => [
    'client_id'     => env('ZERION_ID'),
    'client_secret' => env('ZERION_SECRET'),
    'redirect'      => env('ZERION_REDIRECT'),
],

Append provider values to your .env file: Note: Add both public and secret keys!, _(*9)

// other values above
ZERION_ID=your_app_id_for_the_service
ZERION_SECRET=your_app_secret_for_the_service
ZERION_REDIRECT=https://example.com/login