Mittels der SSO-Schnittstelle kann eine automatisierte Registrierung und Anmeldung 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 Printlounge 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 ein 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 |
|---|---|---|---|
| valid_to * | Unixtime (Integer) | since 4.3.23 | |
customer_user_name * | 50 Zeichen (A-Z0-9_-.@) | Wird keine Budgetgruppe übergeben, wird der Benutzer in einer definierten Standardbudgetgruppe angelegt. Gleiches gilt, wenn das System anhand der ID keine gültige Budgetgruppe ermitteln kann. | |
customer_user_budgetgruppe__id | Integer | ||
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) | ||
| customer_user_countrycode | Ländercode (ISO 3166) | ||
customer_user_costcenter | 200 Zeichen (Utf8) | ||
customer_user_telefon | 200 Zeichen (Utf8) | ||
customer_user_telefax | 200 Zeichen (Utf8) | ||
customer_user_email | 100 Zeichen (Utf8) | ||
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 |
* 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, so dass Benutzer nur noch über die Schnittstelle ins System gelangen können.
$u_data["customer_user_name"] = "max@mustermann.de";
$u_data["customer_longname"] = "Max Mustermann";
$u_data["customer_user_company1"] = "Mustermann GmbH";
$string = http_build_query($u_data);
$encoded_string = encrypt ($string, "Hier steht die geheime 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))));
}