LDAP Backend Login (inkl. SSO / Single Sign-On)

Wichtig

Nutzen Sie bitte vor einem Kauf die Testversion, um sicherzustellen, dass dieses Plugin mit Ihrer Shopware-Umgebung und Ihrem Verzeichnisdienst kompatibel ist.

Erforderliche PHP Module

1. ldap
2. openssl
3. reflection

LDAP Version

Aktuell wird nur die Protokollversion 3 unterstützt.

Konfiguration

Tragen Sie hier den Hostnamen oder die IP-Adresse des Verzeichnisdienstes ein, mit dem sich via LDAP verbunden werden soll (z. B. openldap.example.org oder 120.14.6.17).

Tragen Sie hier die Portnummer ein, auf dem der Verzeichnisdienst nach LDAP-Verbindungen lauscht (standardmäßig 389).

Wählen Sie hier die Art der Verschlüsselung, die für die LDAP-Verbindung verwendet werden soll. Bitte beachten Sie, dass bei Verwendung von LDAPS üblicherweise ein spezieller Port verwendet werden muss (standardmäßig 636).

Tragen Sie hier den vollständige DN des Bind-Nutzers ein (z.B. exampledomain\ldap-user oder cn=ldap-user,dc=example,dc=org). Mit diesem Nutzer wird beim Login oder der Datensynchronisierung nach Nutzern in LDAP gesucht. Es wird stets nur lesend auf das LDAP zugegriffen.

Tragen Sie hier das zugehörige Passwort für den oben definierten Bindnutzer ein.

Tragen Sie hier den DN ein, in dem nach Benutzern gesucht werden soll, die sich über Ihr Shopware-Backend einloggen dürfen (z.B. ou=shopwareusers,dc=example,dc=org).

Tragen Sie hier eine Filterbedingung ein, mit der nach Benutzern via LDAP gesucht werden soll. Hier kann ein beliebiger LDAP Suchfilter (RFC 4515 oder RFC 2254) angegeben werden, wie z.B. cn={$username} oder (&(cn={$username})(objectClass=person)(objectClass=user)). Der Platzhalter {$username} wird durch den Wert ersetzt, den der Nutzer im Feld "Benutzername" der Backend-Login-Maske eingibt.

Tragen Sie hier das Objekt-Attribut ein, welches als Name in Shopware übernommen werden soll. Üblicherweise sollte dies der Vor- und Nachname sein (z. B. cn).

Tragen Sie hier das Objekt-Attribut ein, welches als E-Mail-Adresse in Shopware übernommen werden soll.

Tragen Sie hier eine E-Mail-Adresse ein, die dem Benutzer in Shopware zugeordnet wird, falls keine via LDAP ermittelt werden kann.

Tragen Sie hier die ID der Shopware-Nutzerrolle ein, welche den Benutzern zugewiesen werden soll, die sich zum ersten mal via LDAP einloggen (in einer Standard-Shopware-Installation entspricht die ID 1 der Rolle local_admins). Die IDs der Rollen können Sie der Shopware-Datenbanktabell s_core_auth_roles entnehmen. Ist ein Nutzer einmal via LDAP eingeloggt, können Sie über das Shopware-Backend eine individuelle Rolle zuweisen.

ID des Shopware-Locales ein, welches den Benutzern zugewiesen werden soll, die sich zum ersten mal via LDAP einloggen (in einer Standard-Shopware-Installation entspricht die ID 1 dem Locale de_DE). Die hier konfigurierte Locale-ID wird dem Benutzer nur zugewiesen, wenn er keine Sprache in der Loginmaske auswählt. Die IDs der Locales können Sie der Shopware-Datenbanktabelle s_core_locales entnehmen.

Ist die Checkbox aktiviert, werden sämtliche Debuginformationen über den Shopware Pluginlogger geloggt (Dateipfad var/log/plugin_CONTEXT-YYYY-MM-DD). Hilfreich bei der Ersteinrichtung des Plugins oder Problemanalyse.

Cronjob

Nach der erfolgreichen Konfiguration des Plugins, sollten Sie noch den Cronjob für die Synchronisierung der Nutzerdaten konfigurieren. Diesen können Sie über den Cronjob-Manager von Shopware ausführen lassen. Das Plugin hat für Sie den Job Synchronise LDAP backend users angelegt. Sie müssen diesen nur noch aktivieren.

Alternativ können Sie auch direkt den folgenden CLI-Befehl im Crontab hinterlegen:
php bin/console ropildapbackendlogin:synchronise:users