Aufbau des Plugins
Das Plugin benötigt brandbox/component-simplesamlphp für eine korrekte Funktionsweise.
Konfiguration
Nach der Installation findet sich im Admin-Dashbard unter "Single Sign On" ein neue Konfigurations-Entität "SimpleSAMLphp".
Konfigurationsoptionen im Überblick
| Option | Bedeutung |
|---|---|
| SSO Domain | Ermöglicht die Festlegung der Domain die für SAML2 verwendet wird. Dies ist relevant für Multi-Domain Installationen. |
| Secret Salt | Wird von SimpleSAMLphp genutzt um kryptografische Vorgänge sicherer zu machen |
| Admin Passwort | Dieses Passwort ermöglicht den Login im SimpleSAMLphp Admin-Bereich. |
| Kontakt E-Mail | Wird bei SimpleSAMLphp im Fehlerfall als Kontakt E-Mail angezeigt. |
| Fehler anzeigen | Zeigt auftretende Fehler im Authentifizierungsprozess im Browser an. |
| Debug: SAML | Debug Modus für das SAML Protokoll |
| Debug: XML | Debug Modus für die XML Kommunikation |
| Debug: Backtraces | Zeige Backtraces im Debug Modus |
| Log level | Log level für die simplesamlphp-Logfiles unter temp/log/ |
Zugang zum SimpleSAMLphp Admin Bereich
Der Admin-Bereich von SimpleSAMLphp ist erreichbar unter: https://www.example.com/public/saml/. Die Zugangsdaten lauten:
- Benutzer: admin
- Passwort: "Admin Passwort" aus den Konfigurationsoptionen
Der Admin Bereich ermöglicht einen Zugriff über alle im System konfigurierten Service Provider.
Verwendung
Die SAML2 Ergänzgung für SSO ermöglicht die Authentifikation gegen einen SAML2 kompatiblen Identity Provider (z. B. Microsoft Active Directory).
Events
Brandbox\JoinCore\Join\SsoSaml2\Lib\Event\OnManipulateUser
Ermöglicht die Anpassung von instanziierten Benutzern nachdem der Login Mechanismus von SAML2 abgeschlossen wurde.
Methoden
Dieses Event enthält Informationen über den gemappten User, die SSO Provider Konfiguration und alle Attribute, die über vom SAML2-Identity Provoider übergeben wurden. Es erlaubt einem Listener den User oder die Provider Konfiguration anzupassen. Das ergänzen von Attributen oder das Ersetzen des Users ist nicht gestattet.
Beispiel
class OnManipulateUserSubscriber extends Event\EventSubscriberAbstract
{
/**
* @inheritDoc
*/
public function manipulateUser(Brandbox\JoinCore\Join\SsoSaml2\Lib\Event\OnManipulateUser $event) {
$user = $event->getMappedUser();
$attributes = $event->getSamlAttributes();
$user->setFirstName($attributes[0]);
$user->setLastName($attributes[1]);
$user->setMail('janedoe@example.com');
}
}