PHPackages                             maenbn/openamauth-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. maenbn/openamauth-laravel

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

maenbn/openamauth-laravel
=========================

OpenAM Authentication driver for Laravel

02.4k[2 issues](https://github.com/maen-bn/openamauth-laravel/issues)PHP

Since Oct 18Pushed 8y ago2 watchersCompare

[ Source](https://github.com/maen-bn/openamauth-laravel)[ Packagist](https://packagist.org/packages/maenbn/openamauth-laravel)[ RSS](/packages/maenbn-openamauth-laravel/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

OpenAM Authentication
=====================

[](#openam-authentication)

This is a provider for adding a OpenAM driver to your authentication system in Laravel 5

Installation
------------

[](#installation)

To install the package run the following composer command

```
composer require maenbn/openamauth
```

You will also need to register the service provider by going into `config/app.php` and add the following to the `providers` key:

```
Maenbn\OpenAmAuthLaravel\Providers\OpenAmServiceProvider::class,
```

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

[](#configuration)

You'll need to configure the package for your OpenAM server. First publish the vendor assets:

```
$ php artisan vendor:publish
```

which will create a `config/openam.php` file in your app where you can modify it to reflect your OpenAM server.

Finally make sure to change the value for the `driver` key to `openam` in `config/auth.php`.

### Eloquent model

[](#eloquent-model)

There is also an option to use an Eloquent model as the user object for OpenAM authentication. This is useful if you want to authenticate against OpenAM but want to control authorisation within Laravel e.g. using [Entrust](https://github.com/Zizaco/entrust) package.

Ideally the default `App\User` class found in a new install of Laravel is perfect for this. Modify the `eloquentModel` key to refer to the Eloquent class you want and the `eloquentUid` key to store the OpenAM uid into your user table column in the `config/openam.php` file e.g.

```
'eloquentModel' => App\User::class,

'eloquentUidName' => 'username',
```

Finally, modify your Eloquent model to use the OpenAM `Authenicatable` trait and extend off the Laravel `Model` class instead of the `Authenticable` class like below:

```
namespace App;

use Illuminate\Notifications\Notifiable;
use Illuminate\Database\Eloquent\Model;
use Maenbn\OpenAmAuthLaravel\Authenticatable

class User extends Model
{
    use Notifiable, Authenticatable;
    ..........
```

Middleware
----------

[](#middleware)

If you require your app to set a cookie to hold the OpenAM token, you can utilise the middleware available in this package. Add it to your `app/Http/Kernel.php` as a middleware group:

```
protected $middlewareGroups = [
    ...............
    \Maenbn\OpenAmAuthLaravel\Middleware\SetOpenAmCookie::class,
];
```

You have to also make sure you add your OpenAM cookie name into the `except` array found in the middleware `app/Http/Middleware/EncryptCookies.php` so the token value isn't encrypted as it will need to be validated during authentication attempts.

You can either hard code it or do the following in `app/Http/Middleware/EncryptCookies.php` making sure you import the `Closure` class into the middleware:

```
namespace app\Http\Middleware;

use Closure;
use Illuminate\Cookie\Middleware\EncryptCookies as BaseEncrypter;

class EncryptCookies extends BaseEncrypter
{
    /**
     * The names of the cookies that should not be encrypted.
     *
     * @var array
     */
    protected $except = [
    ];

    public function handle($request, Closure $next)
    {
        $this->except[] = config('openam.cookieName');
        return parent::handle($request, $next);
    }
}
```

\##Usage Now your Auth driver is using OpenAM you will be able to use the Laravel's `Auth` class to authenticate users.

\###Examples

```
//Authenticating using the OpenAM TokenID from a cookie
Auth::attempt();

//Authenticating using user input
$input = Input::only('username', 'password');
Auth::attempt($input);

//Retrieving the OpenAM attributes of a logged in user
$user = Auth::user();
```

###  Health Score

24

—

LowBetter than 30% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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/8006284?v=4)[Ben Norcombe](/maintainers/maen-bn)[@maen-bn](https://github.com/maen-bn)

---

Top Contributors

[![maen-bn](https://avatars.githubusercontent.com/u/8006284?v=4)](https://github.com/maen-bn "maen-bn (3 commits)")

### Embed Badge

![Health badge](/badges/maenbn-openamauth-laravel/health.svg)

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

###  Alternatives

[tg/tgwebvalid

An easy way to validate Telegram Login Widget and Telegram Mini App users on your website using PHP

6827.5k1](/packages/tg-tgwebvalid)[vitalybaev/laravel5-dkim

Laravel 5/6 package for signing outgoing messages with DKIM.

3163.1k](/packages/vitalybaev-laravel5-dkim)[kissdigital-com/apple-sign-in-client-secret-generator

PHP package for generating 'client secret' for Sign In with Apple

2125.5k](/packages/kissdigital-com-apple-sign-in-client-secret-generator)[denniseilander/laravel-passport-scopes-restriction

Restrict scopes for different Laravel Passport clients.

1636.3k](/packages/denniseilander-laravel-passport-scopes-restriction)

PHPackages © 2026

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