Seitenvergleich

Mittels der

Status

colour	Yellow
title	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 und Anmeldung von 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 PRINT LOUNGE aufgerufen.

Die URL lautet wie folgt:

...

Für shopname wird der Shopname angegeben, der in der Administration der Print - Lounge (Verwaltung - Kunden - bearbeiten→ Kunden → bearbeiten) eingestellt wurde. Bitte konfigurieren Sie in der Administration Ihres Shops die SSO-Schnittstelle (Verwaltung - Kunden - bearbeiten - SSOVerwaltung → Kunden → bearbeiten → SSO-Schnittstelle) und verwenden Sie die dort ein gestellte Passphrase 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 Printlounge 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_

budgetgruppe__id

int(10)

customer_user_name *

int(10)

customer_longname

varchar(50

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

varchar

50 Zeichen (

50

Utf8)
customer_user_purchaser

varchar

50 Zeichen (

50

Utf8)
customer_user_company1

varchar

200 Zeichen (

200

Utf8)
customer_user_company2

varchar

200 Zeichen (

200

Utf8)
customer_user_company3

varchar

200 Zeichen (

200

Utf8)
customer_user_street

varchar

200 Zeichen (

200

Utf8)
customer_user_zip

varchar

10 Zeichen (

200

Utf8)
customer_user_town

varchar(200)

200 Zeichen (Utf8)
customer_user_country	200 Zeichen (Utf8)	Veraltet, nutzen Sie customer_user_countrycode
customer_user_

country

countrycode

varchar

Ländercode (

200)

ISO 3166)		since 4.2.10
customer_user_costcenter

varchar

200 Zeichen (

200

Utf8)
customer_user_telefon

varchar

200 Zeichen (

50

Utf8)
customer_user_telefax

varchar

200 Zeichen (

200

Utf8)
customer_user_email

varchar(100)

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

varchar

100 Zeichen (

100

Utf8)
customer_user_mobil

varchar

50 Zeichen (

50

Utf8)
customer_user_kundennummer

varchar

100 Zeichen (

100

Utf8)
customer_user_level

int(11)

Integer
freigabeportal_zeigen	53: Ja 54: Nein (Standard)
customer_user_aussendienst

varchar

200 Zeichen (

255

Utf8)
customer_funktion

varchar

200 Zeichen (

255

Utf8)
sprache	de: Deutsch (Standard) en: Englisch
customfield1

varchar

200 Zeichen (

255

Utf8)
customfield2

varchar

200 Zeichen (

255

Utf8)
customfield3

varchar

200 Zeichen (

255

Utf8)
customfield4

varchar

200 Zeichen (

255

Utf8)
customfield5

varchar

200 Zeichen (

255

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

: Bewirkt das nach der Personalisierung die Bestellung automatisch abgeschickt wird

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.

: 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.

Codeblock

language	php
firstline	1
title	Beispiel zum Verschlüsseln mit PHP
linenumbers	true

$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, "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))));
}

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

Image Added

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'

Image Added

Versionen im Vergleich

Alte Version 3

Neue Version Aktuell

Schlüssel