SSO-Schnittstelle
- Birim Karaustaoglu [Be.Beyond]
- Tom Hanssen
- Dennis Djeraba [BeBeyond]
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.
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 | ||
customer_user_aussendienst | 200 Zeichen (Utf8) | ||
customer_funktion | 200 Zeichen (Utf8) | ||
sprache | de: Deutsch (Standard) | ||
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) | ||
dest_page | wg: Eine Warengruppenseite | ||
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 | ||
| continue_shopping | Zeigt im Warenkorb den Button "Weiter einkaufen". 0: Deaktivieren 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 |
* 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.
$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'
