PHPackages                             borovaka/keycloak-laravel - 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 & Authorization](/categories/authentication)
4. /
5. borovaka/keycloak-laravel

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

borovaka/keycloak-laravel
=========================

Keycloak OAuth2 Provider for Laravel Socialite

010PHPCI failing

Since Nov 9Pushed 6y ago1 watchersCompare

[ Source](https://github.com/borovaka/keycloak-laravel)[ Packagist](https://packagist.org/packages/borovaka/keycloak-laravel)[ RSS](/packages/borovaka-keycloak-laravel/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Keycloak OAuth2 Provider for Laravel Socialite
----------------------------------------------

[](#keycloak-oauth2-provider-for-laravel-socialite)

### Installation

[](#installation)

```
    git clone https://github.com/borovaka/keycloak-laravel

```

### Requirements

[](#requirements)

```
    Download latest keycloak server repository from https://www.keycloak.org/ and setup keycloak server at admin console.

```

### Environment Setup

[](#environment-setup)

Add below key array in '/config/services.php' file.

```
    'keycloak' => [
            'authServerUrl'         => env('KEYCLOAK_AUTHSERVERURL'),
            'realm'                 => env('KEYCLOAK_REALM'),
            'clientId'              => env('KEYCLOAK_CLIENTID'),
            'clientSecret'          => env('KEYCLOAK_CLIENTSECRET'),
            'redirectUri'           => env('KEYCLOAK_REDIRECTURI'),
            'encryptionAlgorithm'   => env('KEYCLOAK_ENCRYPTIONALGORITHM'),
            'encryptionKeyPath'     => env('KEYCLOAK_ENCRYPTIONKEYPATH'),
            'encryptionKey'         => env('KEYCLOAK_ENCRYPTIONKEY'),
    ]
```

### Laravel AppServiceProvider

[](#laravel-appserviceprovider)

Add below code in /app/Providers/AppServiceProvider.php file which helps to execute keycloak as a socialite provider.

```
    use Borovaka\KeycloakLaravel\KeycloakProvider;
```

In boot() method, add below code

```
    $this->bootKeycloakSocialite();
```

Add Function

```
    private function bootKeycloakSocialite()
    {
        $socialite = $this->app->make('Laravel\Socialite\Contracts\Factory');
        $socialite->extend(
            'keycloak',
            function ($app) use ($socialite) {
                $config = $app['config']['services.keycloak'];
                return new KeycloakProvider($config);
            }
        );
    }
```

### Laravel Functions and Routes

[](#laravel-functions-and-routes)

```
    use Socialite;
```

```
    Route::get('/redirect/{provider}', 'ProviderAuthController@redirectToProvider');

    /**
     * Redirect to keycloak server.
     * @provider
     * @return
     */
    public function redirectToProvider($provider)
    {
        /* where $provider = 'keycloak' */
        return Socialite::driver($provider)
                    ->stateless()
                    ->scopes([]) // Array ex : name
                    ->redirect();
    }
```

```
    Route::get('/callback/{provider}', 'ProviderAuthController@CallbackFunction');

    /**
     * retrieve user information which is located at keycloak serve.
     * @provider
     * @return
     */
    public function CallbackFunction($provider)
    {
        /* where $provider = 'keycloak' */
        $userData = Socialite::driver($provider)
                        ->stateless()
                        ->user();
        /* Note : */
        /* 1) Callback url is same for login and logout request. so this function executed twice. */
        /* 2) Must add below code, Because user data not retrieved while logout calls is requested. */
        if(!isset($userData->email)){
            return redirect()->back();
        }

        /* your logic for add or get user detail */

    }
```

```
    Route::get('/logout/{provider}', 'ProviderAuthController@ProviderLogout');

     /**
     * Log the user out of the application.
     * @provider
     * @return void
     */
    public function ProviderLogout(provider)
    {
        /* where $provider = 'keycloak' */
        /* logout from laravel auth */
        Auth::logout();
        /* redirect to keycloak logout url */
        return redirect(
            Socialite::driver($provider)
                ->getLogoutUrl()
        );
    }
```

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2879997?v=4)[Borislav Anchev](/maintainers/borovaka)[@borovaka](https://github.com/borovaka)

---

Top Contributors

[![banchev-smp](https://avatars.githubusercontent.com/u/139879516?v=4)](https://github.com/banchev-smp "banchev-smp (2 commits)")

### Embed Badge

![Health badge](/badges/borovaka-keycloak-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/borovaka-keycloak-laravel/health.svg)](https://phpackages.com/packages/borovaka-keycloak-laravel)
```

###  Alternatives

[kartik-v/yii2-password

Useful password strength validation utilities for Yii Framework 2.0

761.2M17](/packages/kartik-v-yii2-password)

PHPackages © 2026

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