socialiteproviders / rekono
Rekono OAuth2 Provider for Laravel Socialite
Requires
- php: ^7.2 || ^8.0
- ext-json: *
- socialiteproviders/manager: ~4.0
This package is auto-updated.
Last update: 2024-11-07 22:13:06 UTC
README
composer require socialiteproviders/rekono
About Rekono
Rekono is an electronic identity service that allows you to create and manage a single user account to log in to all services included in the Rekono system.
Register an application
Client ID and secret can be obtained by requesting via Rekono Support email mailto:support@rekono.si. After registering a new client, access to technical documentation will be provided.
Installation & Basic Usage
Please see the Base Installation Guide, then follow the provider specific instructions below.
Add configuration to config/services.php
'rekono' => [ 'client_id' => env('REKONO_CLIENT_ID'), 'client_secret' => env('REKONO_CLIENT_SECRET'), 'redirect' => env('REKONO_REDIRECT_URI') ],
Add provider event listener
Laravel 11+
In Laravel 11, the default EventServiceProvider
provider was removed. Instead, add the listener using the listen
method on the Event
facade, in your AppServiceProvider
boot
method.
- Note: You do not need to add anything for the built-in socialite providers unless you override them with your own providers.
Event::listen(function (\SocialiteProviders\Manager\SocialiteWasCalled $event) { $event->extendSocialite('rekono', \SocialiteProviders\Rekono\Provider::class); });
Laravel 10 or below
Configure the package's listener to listen for `SocialiteWasCalled` events.Add the event to your listen[]
array in app/Providers/EventServiceProvider
. See the Base Installation Guide for detailed instructions.
protected $listen = [ \SocialiteProviders\Manager\SocialiteWasCalled::class => [ // ... other providers \SocialiteProviders\Rekono\RekonoExtendSocialite::class.'@handle', ], ];
Usage
You should now be able to use the provider like you would regularly use Socialite (assuming you have the facade installed):
return Socialite::driver('rekono')->redirect();
Returned User fields
id
name
email
More fields - defined upon client registration - are available under the user subkey:
$user = Socialite::driver('rekono')->user(); $locale = $user->user['locale']; $email_verified = $user->user['email_verified'];