PHPackages                             netresearch/nr-saml-auth - 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. netresearch/nr-saml-auth

ActiveTypo3-cms-extension[Authentication &amp; Authorization](/categories/authentication)

netresearch/nr-saml-auth
========================

TYPO3 SAML Authentication for frontend

10.0.10(7mo ago)121[2 issues](https://github.com/netresearch/t3x-nr-saml-auth/issues)GPL-2.0+PHPPHP &gt;=7.1.0CI passing

Since Jun 27Pushed 2w ago4 watchersCompare

[ Source](https://github.com/netresearch/t3x-nr-saml-auth)[ Packagist](https://packagist.org/packages/netresearch/nr-saml-auth)[ Docs](https://netresearch.de)[ RSS](/packages/netresearch-nr-saml-auth/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (3)Versions (15)Used By (0)

Netresearch TYPO3 SAML Auth
===========================

[](#netresearch-typo3-saml-auth)

[![CI](https://github.com/netresearch/t3x-nr-saml-auth/actions/workflows/ci.yml/badge.svg)](https://github.com/netresearch/t3x-nr-saml-auth/actions/workflows/ci.yml)[![TYPO3](https://camo.githubusercontent.com/cfea29f55fd4bf87d4727e5ce7640baaad6274047c8051a6c4ba85290b9e3565/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31322e3425323025374325323031332e342d6f72616e67652e737667)](https://typo3.org/)[![PHP](https://camo.githubusercontent.com/c085e69c145c301903c335cc8653ba83cd9ee8233c36970ef539354adf607898/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532302d2d253230382e342d626c75652e737667)](https://www.php.net/)[![PHPStan](https://camo.githubusercontent.com/d117944b58da8146f96b4ef7403807610a20eeb3fbcaaaf95157bbcdad1686eb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e2e737667)](https://phpstan.org/)[![License](https://camo.githubusercontent.com/26f8b6541ea045cc1dbc2267208158b5a7ebbf5cf437c4b486d80fee9386f77e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302d2d6f722d2d6c617465722d626c75652e737667)](LICENSE)

> TYPO3 extension for SAML SSO authentication supporting frontend and backend users using the `onelogin/php-saml` library.

Requirements
------------

[](#requirements)

VersionTYPO3PHP12.x12.4, 13.48.1 - 8.410.x10.4, 11.57.4 - 8.1Installation
------------

[](#installation)

Install via Composer:

```
composer require netresearch/nr-saml-auth
```

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

[](#configuration)

### Backend Setup

[](#backend-setup)

1. Create a new **SAML Auth Settings** record on the root page in the TYPO3 backend
2. Configure the Service Provider (SP) and Identity Provider (IdP) settings

### Example Configuration

[](#example-configuration)

```
# Service Provider Settings
Entity ID: https://your-domain.tld
Customer service URL: https://your-domain.tld/?logintype=login
Customer service binding: urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST
Name ID format: urn:oasis:names:tc:SAML:2.0:nameid-format:transient

Certificate: -----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIJAMWkGz7F5peWMA0GCSqGSIb3DQEB...
-----END CERTIFICATE-----

Private key: -----BEGIN PRIVATE KEY-----
MIIJQwIBADANBgkqhkiG9w0BAQEFAASCCS0wggkpAgEAAoIC...
-----END PRIVATE KEY-----

# Identity Provider Settings
Entity ID: urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
SSO URL: https://idp.example.com/sso
Binding: urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect
Certificate: [IDP Certificate]

# User Settings
Username prefix: sso-
User folder: [Select frontend user folder]
User groups: [Select default frontend user groups]

```

### Testing with SimpleSAMLphp

[](#testing-with-simplesamlphp)

For development/testing, you can use [SimpleSAMLphp](https://simplesamlphp.org/docs/stable/simplesamlphp-install.html) or online SAML testing tools like [samling](https://capriza.github.io/samling/samling.html).

Features
--------

[](#features)

### Auto Discovery

[](#auto-discovery)

The login service automatically detects the SAML configuration for the current request based on the `sp_entity_id` matching your domain.

### Deep Link Support (Middleware)

[](#deep-link-support-middleware)

The extension includes middleware for redirecting users to their original destination after login/logout:

- The `RelayState` parameter should contain the target URL
- Transmitted via POST (login) or GET (logout) from SAML server to the configured ACS URLs

### Backend Module

[](#backend-module)

Access SAML metadata via the **Admin Tools &gt; SAML Auth** backend module to configure your IdP.

Upgrading
---------

[](#upgrading)

### From 10.x to 12.x

[](#from-10x-to-12x)

Version 12.x includes breaking changes:

- **PHP 8.1+ required**: Upgrade your PHP version
- **TYPO3 12.4+ required**: Upgrade your TYPO3 installation
- **onelogin/php-saml 4.0**: Library upgraded with security improvements
- **PSR-14 Events**: Legacy hooks replaced with modern event system
- **Dependency Injection**: Services now use TYPO3 DI container

No database migrations required.

Development
-----------

[](#development)

### Quality Tools

[](#quality-tools)

```
# Install dependencies
composer install

# Run all CI checks
composer ci

# Individual checks
composer ci:test:php:phpstan  # Static analysis
composer ci:test:php:cgl     # Code style check
composer ci:cgl              # Code style fix
composer ci:test:php:unit    # Unit tests
```

License
-------

[](#license)

This extension is proprietary software by Netresearch DTT GmbH.

Support
-------

[](#support)

For issues and feature requests, please use the [GitHub issue tracker](https://github.com/netresearch/t3x-nr-saml-auth/issues).

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance62

Regular maintenance activity

Popularity8

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

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

Every ~87 days

Recently: every ~217 days

Total

11

Last Release

232d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/151247?v=4)[Netresearch DTT GmbH](/maintainers/netresearch)[@netresearch](https://github.com/netresearch)

---

Top Contributors

[![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (50 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (21 commits)")[![Gitsko](https://avatars.githubusercontent.com/u/17161911?v=4)](https://github.com/Gitsko "Gitsko (5 commits)")[![TechnicalAthere](https://avatars.githubusercontent.com/u/85685099?v=4)](https://github.com/TechnicalAthere "TechnicalAthere (3 commits)")

---

Tags

typo3-extension

### Embed Badge

![Health badge](/badges/netresearch-nr-saml-auth/health.svg)

```
[![Health](https://phpackages.com/badges/netresearch-nr-saml-auth/health.svg)](https://phpackages.com/packages/netresearch-nr-saml-auth)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

611.1M8](/packages/netresearch-rte-ckeditor-image)[pagemachine/typo3-formlog

Form log for TYPO3

23238.6k8](/packages/pagemachine-typo3-formlog)[typo3/cms-fluid-styled-content

TYPO3 CMS Fluid Styled Content - Fluid templates for TYPO3 content elements.

229.4M387](/packages/typo3-cms-fluid-styled-content)[typo3/cms-seo

TYPO3 CMS SEO - SEO features including specific fields for SEO purposes, rendering of HTML meta tags and sitemaps.

168.9M155](/packages/typo3-cms-seo)[in2code/femanager

Modern TYPO3 Frontend User Registration.

53790.4k8](/packages/in2code-femanager)

PHPackages © 2026

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