This module centralizes authorization management for multiple Drupal sites connected via Single Sign-On (SSO). It allows an Identity Provider to manage user roles and access policies across all connected Service Provider sites, ensuring consistent and auditable permission control. The system supports central role mapping, per-user overrides, and automatic role application as part of the SSO process.
Centralised role and permission management for an SSO network. The Identity Provider is the source of truth: it defines per-Service-Provider role mappings and per-user role/permission overrides, resolves each user's effective SP roles, and pushes HMAC-signed updates to registered Service Providers. A Service Provider registers with the IdP, applies inbound pushes, and can pull the full permissions manifest on cron.
Features
- Per-SP role mappings defined on the IdP.
- Per-user role and granular permission overrides (extra / excluded).
- HMAC-SHA256 signed push from IdP to SP, via queue and cron or immediately.
- SP-side manifest pull on cron (throttled), applying roles and permission overrides locally.
- Self-service SP registration with an admin approval gate — no signing key is issued until approved.
- Registration rate limiting.
- Fail-closed HMAC verification with a replay window; privilege-escalation guard that strips restricted permissions and never touches admin roles.
- SSRF-guarded outbound calls (HTTPS only; private/loopback/reserved IPs blocked).
- Optional content and group transfer rules across connected sites (when the Sync module is present).
Security model
The per-site API key, signing secret and registration secret live in settings.php or State, never in exportable configuration. The global SSO JWT secret is never reused for permission signing.
Requirements
- Drupal core
^11.2 || ^12 - PHP
>= 8.1 - SSO Connector
^1.0
Installation
composer require drupal/sso_connector_permissions drush en sso_connector_permissions
Part of the SSO Connector bundle
Requires SSO Connector (core). See the core project for the full suite.
Ask your assistant about SSO Connector Permissions
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
- SSO Connector
- help Drupal core
- serialization Drupal core
- user Drupal core
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | PHP | Release date | |
|---|---|---|---|---|---|
| 1.0.1 | Stable | 11 | Jul 21, 2026 | ||
| 1.0.0 | Stable | 11 | Jul 18, 2026 | ||
| 1.0.0-beta1 | Pre-release | 10–11 | Apr 26, 2026 |