Documentation
Installation
- Ensure PHP OpenSSL is enabled on your server.
- From the package directory, install dependencies:
- cd packages/md_saml
- composer install
- Install the package from the Concrete CMS Dashboard:
- Dashboard → Extend Concrete → Install "Macareux SAML Authentication"
- The installer initializes the default configuration and generates an SP key pair if none exists.
Configuration After installation, configure SAML under:
- Dashboard → System & Settings → Registration → Authentication → SAML Identity Providers
Typical steps:
- Add an Identity Provider by importing its metadata XML
- Choose the Unique Attribute used to correlate users
- Map Username and Email attributes
- Optionally map a Group attribute and configure Group Mappings
You can also adjust Service Provider and security options from the authentication type settings. Defaults are initialized on install.
Usage
- On the login screen, users can select an IdP and initiate SSO via the provided login element.
- You may also add the "Macareux SAML Login" block to pages where you want to expose an SSO button.
Support & Troubleshooting
- If you see "Required libraries not found", run composer install in packages/md_saml.
- Ensure the PHP OpenSSL extension is enabled.
- Check application logs (channel: md_saml) for details when diagnosing SAML issues.
