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)
AnwendungsbeispielBeispielcodeÜbergabeparameterErgebnis
Benutzername wird im Parameter "userName" übergebenParameterkonfiguration für Benutzername: {$userName}…&userName=maxMustermannmaxMustermann
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=Mustermannmax.mustermann
Benutzername soll immer den Präfix "user-" enthaltenParameterkonfiguration für Benutzername: user-{$userName}…&userName=maxMustermannuser-maxMustermann