VERALTET Die SSO-Schnittstelle Version 1 ist veraltet und wird nicht länger unterstützt. Bitte verwenden Sie stattdessen die SSO-Schnittstelle Version 2

Mittels SSO-Schnittstelle kann eine automatisierte Anmeldung und Registrierung von Benutzern vorgenommen werden. In der Regel wird die Schnittstelle dazu verwendet, dass die Daten von einem Kundensystem (z. B. durch ein CMS- oder CRM-System, Intranet oder Procurementplattform) aufbereitet werden. Über einen Link mit speziell verschlüsselten Query String wird die PRINT LOUNGE aufgerufen.

Die URL lautet wie folgt:

http[s]://[www.]shopname.print-server.net/autologin.php?u_data=ENCODED_KEY_VALUE_PAIRS

Für shopname wird der Shopname angegeben, der in der Administration der Print Lounge (Verwaltung → Kunden → bearbeiten) eingestellt wurde. Bitte konfigurieren Sie in der Administration Ihres Shops die SSO-Schnittstelle (Verwaltung → Kunden → bearbeiten → SSO-Schnittstelle) und verwenden Sie die dort eine gestellte Passphrase um die Daten zu verschlüsseln.

Dabei muss ENCODED_KEY_VALUE_PAIRS mit den verschlüsselten Daten ersetzt werden. Sofern die Daten erfolgreich verarbeitet wurden, wird der Benutzer am System angemeldet und kann die Print Lounge regulär nutzen.
Die übermittelten Daten müssen mittels Rijnadel-256 verschlüsselt sein. Folgende Daten können übermittelt werden:

Bezeichnung	Typ / Wert	Bemerkung	Version
request_time *	Datum und Uhrzeit (ISO 8601)	Zeitpunkt des Aufrufs (Standardgültigkeit des Requests 500s - 8 min)	since 4.3.23
customer_user_name *	50 Zeichen (A-Z0-9_-.@)	Benutzen Sie eindeutige Zuordnungen wie UserIds, E-Mails oder Benutzernamen
customer_user_budgetgruppe__id	Integer	Wird keine Benutzergruppe übergeben, wird der Benutzer in einer definierten Standardbenutzergruppe angelegt. Gleiches gilt, wenn das System anhand der ID keine gültige Benutzergruppe ermitteln kann.
group_name	50 Zeichen (Utf8)	Wird der Name der Benutzergruppe übergeben, wird geprüft ob die Gruppe mit exakt diesem Namen existiert. Falls nicht wird die Gruppe neu angelegt. Der Benutzer wird dieser Gruppe zugewiesen. ACHTUG: Funktioniert nur wenn unter "Shops->bearbeiten" die Option "Benutzergruppen automatisch anlegen" aktiviert wurde.	since 6.34.0
customer_longname	50 Zeichen (Utf8)
customer_user_businessunit	50 Zeichen (Utf8)
customer_user_purchaser	50 Zeichen (Utf8)
customer_user_company1	200 Zeichen (Utf8)
customer_user_company2	200 Zeichen (Utf8)
customer_user_company3	200 Zeichen (Utf8)
customer_user_street	200 Zeichen (Utf8)
customer_user_zip	10 Zeichen (Utf8)
customer_user_town	200 Zeichen (Utf8)
customer_user_country	200 Zeichen (Utf8)	Veraltet, nutzen Sie customer_user_countrycode
customer_user_countrycode	Ländercode (ISO 3166)		since 4.2.10
customer_user_costcenter	200 Zeichen (Utf8)
customer_user_telefon	200 Zeichen (Utf8)
customer_user_telefax	200 Zeichen (Utf8)
customer_user_email	100 Zeichen (Utf8)
user_groups_binary_url	200 Zeichen (Utf8)	URL für Logo (Bild) einer Benutzergruppe
user_groups_binary_description	50 Zeichen (Utf8)	Beschreibung für Logo (Bild) einer Benutzergruppe
customer_user_internet	100 Zeichen (Utf8)
customer_user_mobil	50 Zeichen (Utf8)
customer_user_kundennummer	100 Zeichen (Utf8)
customer_user_level	Integer
freigabeportal_zeigen	53: Ja 54: Nein (Standard)
customer_user_aussendienst	200 Zeichen (Utf8)
customer_funktion	200 Zeichen (Utf8)
sprache	de: Deutsch (Standard) en: Englisch
customfield1	200 Zeichen (Utf8)
customfield2	200 Zeichen (Utf8)
customfield3	200 Zeichen (Utf8)
customfield4	200 Zeichen (Utf8)
customfield5	200 Zeichen (Utf8)
customer_user_level	57: A - Benutzer (Standard) 58: B - Supervisor 59: C - Verwaltung 60: X - Interessenten
dest_page	wg: Eine Warengruppenseite pers: Eine Personalisierungsseite
dest_id	Die ID des Eintrags (Warengruppe oder Artikel)
qty	Die Anzahl aus der Preisstaffel (Wird keine Anzahl übermittel, ermittelt das System die kleinste Preisstaffel für den jeweiligen Artikel)
skip_cart	53: Ja 54: Nein (Standard)
continue_shopping	Zeigt im Warenkorb den Button "Weiter einkaufen". 0: Deaktivieren 1: Aktivieren 2: zum SSO-Übergabepunkt Achtung: Beim Aktivieren wird die Variable "skip_cart" ignoriert.
settings	Liste von Settings, die zusätzlich übergeben werden können.		since 5.16.0
redirect_url	200 Zeichen (Utf8)	Hier kann eine URL (z.B. "/makepage.php?searchStr=test&p=search") eingetragen werden. Findet ein erfolgreicher Login statt, wird der User direkt zu der angegebenen URL geleitet.	since 7.1.0

* Pflichtfelder

Nach der Anmeldung am System stehen alle Funktionen wie gewohnt zur Verfügung, als ob der Benutzer sich regulär angemeldet hätte. Optional kann die reguläre Anmeldung mit Benutzernamen und Kennwort deaktiviert werden, sodass Benutzer nur noch über die Schnittstelle ins System gelangen können.

Beispiel zum Verschlüsseln mit PHP

$u_data["request_time"] = (new DateTime())->format(DateTime::ISO8601); // ab PHP 5.4
$u_data["customer_user_name"] = "max@mustermann.de";
$u_data["customer_longname"] = "Max Mustermann";
$u_data["customer_user_company1"] = "Mustermann GmbH";
$u_data["settings"]["evaluate_order"] = true; // Bestellauswertung aktivieren
$string = http_build_query($u_data);

$encoded_string = encrypt ($string, "Passphrase");

$encoded_string = urlencode ($encoded_string);

function encrypt($text, $passphrase)
{
    return trim(base64_encode(mcrypt_encrypt(MCRYPT_RIJNDAEL_256, $passphrase, $text, MCRYPT_MODE_ECB, 
    mcrypt_create_iv(mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB), MCRYPT_RAND))));
}

Innerhalb der Administration im Bereich Verwaltung → Kunden → bearbeiten → SSO-Schnittstelle können die oben beschriebenen Informationen abgelegt und die Funktionen aktiviert werden.

Die 32-stellige Passphrase kann über das System erneut generiert werden und ist sofort gültig.

Mit der Option 'Zurück Button mit HOOK_URL anzeigen?' kann man im Shop einen 'Zurück' Button zur HOOK_URL anzeigen.
Die Sprachvariable für den Button ist 'ssoBackButtonText'

Browser nicht unterstützt