PHPackages                             os2web/os2web\_simplesaml - 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. os2web/os2web\_simplesaml

ActiveDrupal-module[Authentication &amp; Authorization](/categories/authentication)

os2web/os2web\_simplesaml
=========================

Enhances integration with simplesamlphp\_auth module, by force triggering SimpleSAML auth page redirect when certain criteria are met

8.x-dev(2y ago)010.3k↓38.9%4EUPL-1.2PHP

Since Nov 27Pushed 4mo ago10 watchersCompare

[ Source](https://github.com/OS2web/os2web_simplesaml)[ Packagist](https://packagist.org/packages/os2web/os2web_simplesaml)[ RSS](/packages/os2web-os2web-simplesaml/feed)WikiDiscussions 8.x Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (8)Used By (4)

OS2Web SimpleSAML Drupal module [![Build Status](https://camo.githubusercontent.com/be81b918111bd15dfbb2c718672ab79bb9fc165babd116a037d053f5ef888f84/68747470733a2f2f7472617669732d63692e6f72672f4f53327765622f6f73327765625f73696d706c6573616d6c2e7376673f6272616e63683d382e78)](https://travis-ci.org/OS2web/os2web_simplesaml)
=================================================================================================================================================================================================================================================================================================================================

[](#os2web-simplesaml-drupal-module--)

Module purpose
--------------

[](#module-purpose)

The aim of this module is to enhance integration with **simplesamlphp\_auth** module, by force triggering **SimpleSAML auth page** redirect when certain criteria are met.

How does it work
----------------

[](#how-does-it-work)

Module performs checks on a single redirect triggering page. In order for it to work the cache for anonymous user for that page response is programmatically killed.

The redirect check cannot be done on all pages. Reason for that is the performance. The redirect only works properly when page response cache is killed (otherwise response is cached for all anonymous users), so in order for it to work on all pages anonymous page response caches must be killed (which is the same as disabling page cache entirely).

As a compromise between the functionality and performance it has been decided to use a single page to trigger redirect check.

If the request passes all the criteria (meaning user is anonymous and the IP is within whitelist), request is redirected to **SimpleSAML auth page**.

To improve the performance, the redirect decision is stored in cookies to a limited time.

Additionally module provides a special field for user entity, called **SimpleSAML UID** that allows to create a **SimpleSAML mapping** with the existing Drupal users.

Additional setings
------------------

[](#additional-setings)

### Local authentication

[](#local-authentication)

Path: `/admin/config/people/simplesamlphp_auth/local`

- **IP's whitelist**Comma separate values of IP or IP ranges that will be redirected to SimpleSAML auth page.
- **Redirect triggering page**A certain page that triggers the redirect to SimpleSAML auth page if the criteria pass (*defaults: front page "/"*).
- **Cookies TTL**Stores the redirect response in the cookies for a certain period of time (*defaults: 5min*).

### User info and syncing

[](#user-info-and-syncing)

Path: `/admin/config/people/simplesamlphp_auth/sync`

- **OS2Web user fields mapping** Allows to create mapping between SimpleSAML claims and user profile fields. Upon login user fields will be populated using specified SimpleSAML claims.

    Each field mapping also supports param **Force sync on every login**. Having it *OFF* will only populate the field from claim if the field is empty, having this param *ON* will make field to be populated each time user has logged in.

Install
-------

[](#install)

Module is available to download via composer.

```
composer require os2web/os2web_simplesaml
drush en os2web_simplesaml

```

Update
------

[](#update)

Updating process for OS2Web SimpleSAML module is similar to usual Drupal 8 module. Use Composer's built-in command for listing packages that have updates available:

```
composer outdated os2web/os2web_simplesaml

```

Automated testing and code quality
----------------------------------

[](#automated-testing-and-code-quality)

See [OS2Web testing and CI information](https://github.com/OS2Web/docs#testing-and-ci)

Contribution
------------

[](#contribution)

Project is opened for new features and os course bugfixes. If you have any suggestion or you found a bug in project, you are very welcome to create an issue in github repository issue tracker. For issue description there is expected that you will provide clear and sufficient information about your feature request or bug report.

### Code review policy

[](#code-review-policy)

See [OS2Web code review policy](https://github.com/OS2Web/docs#code-review)

### Git name convention

[](#git-name-convention)

See [OS2Web git name convention](https://github.com/OS2Web/docs#git-guideline)

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance52

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

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

Unknown

Total

1

Last Release

731d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/827308?v=4)[Jørn Skifter Andersen](/maintainers/skifter)[@skifter](https://github.com/skifter)

![](https://www.gravatar.com/avatar/62f8489b69aecc84322f8899d288c3ab41d3022532d49c849ae4ca10e20f4df7?d=identicon)[andriyun](/maintainers/andriyun)

![](https://www.gravatar.com/avatar/134c42b216718e3d28298bcec8772eeb309c8c94afff3462dac1245b06c06cc5?d=identicon)[stanbellcom](/maintainers/stanbellcom)

---

Top Contributors

[![stankut](https://avatars.githubusercontent.com/u/1537807?v=4)](https://github.com/stankut "stankut (12 commits)")[![juuliabellcom](https://avatars.githubusercontent.com/u/5367428?v=4)](https://github.com/juuliabellcom "juuliabellcom (5 commits)")[![thollebellcom](https://avatars.githubusercontent.com/u/100751734?v=4)](https://github.com/thollebellcom "thollebellcom (2 commits)")[![andriyun](https://avatars.githubusercontent.com/u/5544994?v=4)](https://github.com/andriyun "andriyun (1 commits)")[![inuitviking](https://avatars.githubusercontent.com/u/11981709?v=4)](https://github.com/inuitviking "inuitviking (1 commits)")

### Embed Badge

![Health badge](/badges/os2web-os2web-simplesaml/health.svg)

```
[![Health](https://phpackages.com/badges/os2web-os2web-simplesaml/health.svg)](https://phpackages.com/packages/os2web-os2web-simplesaml)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)[beatswitch/lock

A flexible, driver based Acl package for PHP 5.4+

870304.7k2](/packages/beatswitch-lock)[amocrm/amocrm-api-library

amoCRM API Client

182728.5k6](/packages/amocrm-amocrm-api-library)[vonage/jwt

A standalone package for creating JWTs for Vonage APIs

424.1M4](/packages/vonage-jwt)

PHPackages © 2026

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