Add-On: Single-Sign-On (kundenspezifische Konfiguration)
Die Standardkonfiguration der SSO-Schnittstelle in der PRINT LOUNGE sieht feste Parameter wie bspw. "customer_user_name" vor. Um abweichende Parameternamen, Kombinationen aus mehreren Informationen oder feste Vorgaben nutzen zu können, kann das Add-On "CustomSingleSignOn" genutzt werden.
Innerhalb der Add-On-Konfiguration kann dann zum einen der Parametername festgelegt, aber auch der Inhalt jedes SSO-Parameters einzeln konfiguriert werden. Wird keine abweichende Konfiguration hinterlegt, wird der Standard-Parametername der SSO-Schnittstelle verwendet.
Der Login erfolgt immer über den Endpunkt /shop/module/CustomSingleSignOn/Shop/login?key=…, wobei der Parameter "key" als base64-encodeten String enthält (bspw. base64_encode('userName=maxMustermann&firstName=Max&lastName=Mustermann')
).
Für den Bereich Grundlagen gibt es ein zusätzliches Feld.
"Verwendung eines anderen Trennzeichens als &"
Damit kann mein ein Trennzeichen wie z.B. | Pipe festlegen mit dem die Parameter im Base64 kodierten String getrennt werden.
Beispiel: "customer_user_name=Max123|customer_firstname=Max|customer_lastname=Mustermann@cust..."
Beispiele
Der Benutzername wird normalerweise über den Parameter "customer_user_name" an die PRINT LOUNGE übergeben. Gibt das externe System diese Information allerdings beispielsweise über den Parameter "userName" an die PRINT LOUNGE, kann dies mit dem Befehl {$userName}
hinterlegt werden.
Bei der Konfiguration stehen folgende Möglichkeiten zur Verfügung:
- Abweichende Parameternamen
- Smarty-Befehle (bspw. um die übergebenen Informationen immer in Kleinbuchstaben zu konvertieren oder Bedingungen zu hinterlegen)
- Feste alphanumerische Werte (bspw. "de", um die Sprache immer auf Deutsch festzulegen)
Anwendungsbeispiel | Beispielcode | Übergabeparameter | Ergebnis |
---|---|---|---|
Benutzername wird im Parameter "userName" übergeben | Parameterkonfiguration für Benutzername: {$userName} | …&userName=maxMustermann… | maxMustermann |
Benutzername soll aus dem Vor- und Nachnamen zusammengesetzt werden und immer klein geschrieben sein. | Parameterkonfiguration für Benutzername: {$firstName|lower}.{$lastName|lower} | …&firstName=Max&lastName=Mustermann… | max.mustermann |
Benutzername soll immer den Präfix "user-" enthalten | Parameterkonfiguration für Benutzername: user-{$userName} | …&userName=maxMustermann… | user-maxMustermann |