Integrierte Benutzerüberprüfung Implementierungshandbuch für Kunden Vertraulich Version 2.9

Transkript

1 Integrierte Benutzerüberprüfung Implementierungshandbuch für Kunden Vertraulich Version 2.9

2 INHALTSVERZEICHNIS Einführung... 2 Zweck und Zielgruppe... 2 Informationen zu diesem Dokument... 2 Häufig verwendete Begriffe... 3 Implementierungsdauer... 3 Übersicht: Integrierte Benutzerüberprüfung (IUV)... 4 Benutzerüberprüfung, einmaliges Anmelden und integrierte Benutzerüberprüfung (IUV)... 4 Vorteile... 5 Nachteile... 5 So funktioniert IUV... 6 Welche Schritte müssen jetzt ausgeführt werden?... 7 Erstellen und Konfigurieren der integrierten Benutzerüberprüfung... 8 Der Workflow... 8 Erstellen Ihrer Integrationsanwendung... 9 Registrieren eines authentifizierten Käufers bei einem WebStore... 9 Umleiten des Käufers zum WebStore Konfigurieren von ELMS für die Interaktion mit Ihrer Anwendung Zugriff auf die ELMS-Verwaltung Ermitteln Ihrer Kontonummer Aktivieren von IUV Testoptionen Beispielcode Wiederherstellung von Administorrollen Support... 23

3 Einführung In diesem Abschnitt werden folgende Themen behandelt: Zweck und Zielgruppe Informationen zu diesem Dokument Häufig verwendete Begriffe Implementierungsdauer ZWECK UND ZIELGRUPPE Dieses Dokument enthält detaillierte Anweisungen zum Einrichten eines Mechanismus für einmaliges Anmelden zwischen dem vorhandenen Authentifizierungssystem (beispielsweise einem LDAP- Verzeichnis) eines Kivuto-Kunden und einem ELMS WebStore von Kivuto. Dieser Vorgang wird Integrierte Benutzerüberprüfung (Integrated User Verification, IUV) genannt. Dieses Dokument richtet sich in erster Linie an ELMS-Administratoren oder Webentwickler, denen in ELMS die Rolle des Administrators der Benutzerüberprüfung zugewiesen wurde. INFORMATIONEN ZU DIESEM DOKUMENT Lesen Sie dieses Dokument in Verbindung mit der auf der e5-verwaltungswebsite verfügbaren Onlinehilfe. In der folgenden Liste werden die einzelnen Kapitel dieses Dokuments aufgeführt: Übersicht über den IUV-Vorgang o Was ist unter dem einmaligen Anmelden und der integrierten Benutzerüberprüfung zu verstehen? o So funktioniert's o Welche Schritte müssen jetzt ausgeführt werden? Erstellen und Konfigurieren der integrierten Benutzerüberprüfung o Der Workflow o Erstellen Ihrer Integrationsanwendung o Konfigurieren von ELMS für die Interaktion mit Ihrer Anwendung s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

4 Beispielcode Support HÄUFIG VERWENDETE BEGRIFFE Begriff Kunde ELMS/e5 ELMS-Verwaltung IUV Käufer WebStore Beschreibung Ein Kivuto-Kunde (z. B. ein Unternehmen oder Bildungseinrichtung), der mit der integrierten Benutzerüberprüfung Käufer authentifiziert, sodass diese einen ELMS WebStore verwenden können. Auf der ELMS-Verwaltungswebsite ist ein Kunde als Organisation definiert. Elektronisches License Management System Das Modul zur sicheren Verwaltung von ELMS mit Funktionen zum Verwalten eines WebStore und zum Einrichten der integrierten Benutzerauthentifizierung. Nur autorisierte Benutzer können auf dieses Modul zugreifen. Integrierte Benutzerüberprüfung: Mechanismus zum einmaligen Anmelden zwischen dem Kundensystem und ELMS Benutzer, der bei einem ELMS WebStore angemeldet wird Eine ELMS-E-Commerce-Website von Kivuto, auf der im Namen des Kunden Produkte zum Verkauf angeboten werden IMPLEMENTIERUNGSDAUER Die Implementierungsdauer der integrierten Benutzerüberprüfung für Ihren Webstore, hängt vom Typ des in Ihrer Organisation derzeit verwendeten Authentifizierungsmechanismus und den technischen Kenntnissen der Entwickler ab. In der Regel benötigen die meisten erfahrenen Softwareentwickler einige Stunden für die Implementierung. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

5 Übersicht: Integrierte Benutzerüberprüfung (IUV) In diesem Abschnitt werden folgende Themen behandelt: Was ist unter dem einmaligen Anmelden und der integrierten Benutzerüberprüfung zu verstehen? o Vorteile o Nachteile So funktioniert's Welche Schritte müssen jetzt ausgeführt werden? BENUTZERÜBERPRÜFUNG, EINMALIGES ANMELDEN UND INTEGRIERTE BENUTZERÜBERPRÜFUNG (IUV) Nur authentifizierte Benutzer können Software in Ihrem WebStore erwerben. Der ELMS-Administrator muss die Methode für die Authentifizierung der Benutzer festlegen. Die verfügbaren Methoden werden als Überprüfungsmethoden bezeichnet. Es gibt viele Überprüfungsmethoden, mit denen Benutzer authentifiziert werden können, beispielsweise per -Domäne, Benutzerimport und integrierter Benutzerüberprüfung (IUV). Bei den SSO-Überprüfungsmethoden für einmaliges Anmelden kann ein Benutzer die Anmeldung bei mehreren verwandten, jedoch voneinander unabhängigen, Softwaresystemen mit derselben ID und demselben Kennwort vornehmen. Der Benutzer meldet sich einmal an und kann auf alle Systeme zugreifen, ohne jedes Mal erneut zum Anmelden aufgefordert zu werden. IUV ist eine Methode der SSO- Integration im ELMS. Für einen WebStore können mehrere Überprüfungsmethoden festgelegt werden, allerdings kann jeweils nur eine Authentifizierung mit einmaligem Anmelden aktiv sein. Ein WebStore kann also nicht gleichzeitig die integrierte Benutzerüberprüfung und Shibboleth als Überprüfungsmethode verwenden. Es können mehrere Instanzen von SSO-Überprüfungen (Single Sign-On, einmaliges Anmelden) zu Testzwecken hinzugefügt werden, es kann jedoch immer nur einer der SSO-Überprüfungstypen gleichzeitig getestet werden. Andere Überprüfungstypen (z. B. Benutzerimport) können nur einmal hinzugefügt werden. Wenn zudem für einen SSO-Typ Test festgelegt wird und sich bereits eine Überprüfung dieses Typs im Test befindet, wird der aktuelle Typ auf Inaktiv festgelegt. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

6 Da verschiedene Anwendungen und Ressourcen unterschiedliche Authentifizierungsmechanismen unterstützen, müssen beim einmaligen Anmelden die Anmeldeinformationen im Unterschied zu den bei der ersten Authentifizierung verwendeten Informationen intern in verschiedene Anmeldeinformationen übertragen und als solche gespeichert werden. VORTEILE Verringerung der Kennwortermüdung (Password Fatigue) aufgrund vielzähliger Benutzername-/Kennwortkombinationen Mögliche Unterstützung einer herkömmlichen Authentifizierung wie Windows- Anmeldeinformationen (z. B. Benutzername/Kennwort) Verringerung der Supportkosten wegen einer geringeren Anzahl von Helpdeskanrufen mit Fragen zu Kennwörtern Sicherheit auf allen Ebenen des Einstiegs/Beendens/Zugriffs für Systeme ohne unpraktische erneute Anmeldeaufforderung an die Benutzer Verringert Verwaltungskosten, da Administratoren für Benutzer nur die Benutzerdatenbanken/-listen in der übergeordneten Organisation verwalten müssen. Alle SSO-Systeme greifen auf dieses System zu. NACHTEILE Das einmalige Anmelden ermöglicht nach der ersten Authentifizierung des Benutzers den Zugriff auf viele Ressourcen. Dadurch wirken sich die negativen Konsequenzen stärker aus, falls die Anmeldeinformationen anderen Personen zur Verfügung stehen oder missbraucht werden. Deshalb ist es beim einmaligen Anmelden sehr wichtig, den Schutz der Benutzeranmeldeinformationen zu beachten und sichere Authentifizierungsmethoden zu verwenden. Darüber hinaus spielt die ordnungsgemäße Funktionsweise der Authentifizierungssysteme beim einmaligen Anmelden eine entscheidende Rolle. Wenn nicht auf die Authentifizierungssysteme zugegriffen werden kann (z. B. bei einem Netzwerkausfall), wird möglicherweise der Zugriff auf alle im Rahmen des einmaligen Anmeldens verbundenen Systeme verweigert. Aufgrund dieser Punkte muss bei der Verwendung von ELMS mit der integrierten Benutzerüberprüfung unbedingt die SSO-Implementierung des Kunden verfügbar sein, andernfalls können Käufer nicht auf den WebStore zugreifen und dort Software bestellen. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

7 SO FUNKTIONIERT IUV In der folgenden Übersicht werden die Schritte genannt, die zur Ausführung der integrierten Benutzerüberprüfung erforderlich sind: 1. Der Käufer gelangt auf die Kundenwebsite: Wenn der Käufer direkt zum ELMS WebStore navigiert und auf den Link für die Anmeldung klickt, wird er vom Webstore auf die Website des Kunden umgeleitet. Der Käufer könnte auch direkt auf der Website des Kunden beginnen. 2. Der Käufer wird von der Kundenwebsite authentifiziert: Auf der Website des Kunden wird der Käufer zur Eingabe der Anmeldeinformationen aufgefordert und anhand des Authentifizierungsmechanismus (z. B. ein LDAP-Verzeichnis) authentifiziert. 3. Der Käufer leitet den Wechsel zum WebStore ein: Der Käufer gibt an, dass er zum WebStore wechseln möchte, indem er auf einen Link oder eine Schaltfläche auf der Kundenwebsite klickt. 4. Der Käufer wird von der Kundenwebsite beim WebStore authentifiziert: Alle weiteren erforderlichen Informationen zum Käufer werden von der Kundenwebsite aus dem eigenen Datenspeicher abgerufen. Anschließend erfolgt ein HTTP-GET-Aufruf über SSL (Secure Sockets Layer) an eine Kivuto-URL, mit dem die relevanten Informationen über den Käufer und ein Sicherheitsschlüssel zur Identifikation des Kunden übergeben werden. Weitere Erstellen und Konfigurieren der integrierten Benutzerüberprüfung Informationen finden Sie unter. 5. Der Käufer wird von der Kundenwebsite an den WebStore umgeleitet: Wenn der HTTP-GET- Aufruf erfolgreich ist, wird der Käufer basierend auf einem bestimmten Rückgabecode von der Kundenwebsite an die Rückgabe-URL umgeleitet. Mit dieser Aktion ist der Überprüfungsvorgang abgeschlossen, der Käufer wird beim ELMS WebStore angemeldet und die Startseite des WebStores wird dem Benutzer angezeigt. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

8 WELCHE SCHRITTE MÜSSEN JETZT AUSGEFÜHRT WERDEN? + Erstellen Ihrer Integrationsanwendung Konfigurieren von ELMS für die Interaktion mit Ihrer Anwendung s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

9 Erstellen und Konfigurieren der integrierten Benutzerüberprüfung In diesem Abschnitt werden folgende Themen behandelt: Der Workflow Erstellen Ihrer Integrationsanwendung Konfigurieren von ELMS für die Interaktion mit Ihrer Anwendung DER WORKFLOW ELMS Anwendung zur Kundenintegration Der Käufer klickt auf den Anmeldelink Der Käufer gibt den Benutzernamen und das Kennwort ein Das Kundensystem authentifiziert den Käufer und ruft die erforderlichen Attribute ab ELMS gibt Antwortcode zurück HTTP-GET-Aufruf an ELMS Lesen/Überprüfen des Antwortcodes 200 ERFOLG 500 FEHLER (Kivuto-Problem) 400 FEHLER (Kundenproblem) Der Käufer beginnt mit dem Einkauf! Der Käufer wird zu ELMS umgeleitet 1. Dem Benutzer wird eine Meldung angezeigt. 2. Der Kunde wird per informiert. Kivuto wird automatisch über das Problem informiert und behebt es 1. Dem Benutzer wird eine Meldung angezeigt. 2. Eine wird an das Entwicklungsteam des Kunden gesendet. Das Entwicklungsteam des Kunden muss das Problem beheben und einen erneuten Test ausführen! s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

10 ERSTELLEN IHRER INTEGRATIONSANWENDUNG Erstellen Sie Ihre Integrationsanwendung mit der in Ihrer Organisation üblichen Webtechnologie. Am Ende dieses Dokuments finden Sie Codebeispiele in C# und VB.NET 2.0, die eine ASPX-Seite zum Testen der integrierten Benutzerüberprüfung einschließen, sowie ColdFusion- und PHP-Beispiele. Klicken Sie hier Beispielcode für weitere Informationen. Für die Erstellung Ihrer Integrationsanwendung müssen zwei Schritte ausgeführt werden: 1. Registrieren eines authentifizierten Käufers bei einem WebStore. 2. Umleiten des Käufers zum WebStore. REGISTRIEREN EINES AUTHENTIFIZIERTEN KÄUFERS BEI EINEM WEBSTORE Zur Registrierung eines authentifizierten Käufers bei einem WebStore muss die Kundenwebsite einen HTTP-GET-Aufruf über SSL an folgende URL ausgeben: Hinweis: Diese Aktion wird nicht weitergeleitet, der Schritt muss auf einem Kundenserver ausgeführt werden. Parameter der Benutzerauthentifizierung Die URL für den HTTP-GET-Aufruf über SSL besitzt mehrere erforderliche Parameter und mehrere optionale Parameter. Der Aufruf erfolgt über SSL, wodurch die Parameter automatisch verschlüsselt werden. Das folgende Beispiel veranschaulicht einen Aufruf zur Registrierung eines authentifizierten Käufers mit den angegebenen Parametern: h&key=bda0989f&academic_statuses=faculty,staff Die erforderlichen und optionalen Parameter werden in Tabelle [1]: Basisdaten der IUV-Implementierung erläutert. Einige WebStores sind möglicherweise speziell eingerichtet, insofern als es mehrere s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

11 Mitgliedsorganisationen gibt, denen Käufer angehören können, oder die IUV-Implementierung mehr als einen WebStore unterstützt. Weitere Informationen finden Sie unten in Tabelle [2]: Einzelner WebStore mit mehreren Organisationen, die den WebStore verwenden und Tabelle [3]: Einzelne IUV- Implementierung für mehrere Webstores. Tabelle [1] Basisdaten der IUV-Implementierung Parametername Obligatorisch? Beschreibung account Ja Die Kontonummer, die Ihrer Organisation in ELMS zugewiesen ist. username Ja Eine eindeutige Kennung zur Beschreibung jedes Benutzers. Maximal 100 Zeichen. key Ja Ein gemeinsamer geheimer Schlüssel in der ELMS-Verwaltung. Dieser Schlüssel sollte so sicher wie möglich gehalten werden. academic_statuses Ja (für akademische Organisationen) Wichtig: Dieser Parameter und die verfügbaren Standardwerte sollten von akademischen Organisationen übermittelt werden. Unternehmensorganisationen müssen möglicherweise andere Parameter übermitteln, um die Berechtigung des Benutzers anzuzeigen. Für genauere Informationen wenden Sie sich bitte an Ihren Kundenbetreuer. Eine durch Kommas getrennte Liste von Benutzergruppen der der Käufer angehört. Diese Gruppen beeinflussen die Berechtigung des Käufers Software zu bestellen. Jeder aufgelistete Wert muss exakt mit einem gültigen Code für die Benutzergruppe übereinstimmen (z. B. geben Sie nicht Student an, der Wert muss Studenten lauten). Standardbenutzergruppen werden unten aufgelistet. Es können weitere Benutzergruppen konfiguriert (in der ELMS-Verwaltung) und nach Bedarf übergeben werden. Die Standardbenutzergruppen lauten: Studenten Dozenten staff (Mitarbeiter) Nein adresse des Käufers Maximal 100 Zeichen. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

12 Parametername Obligatorisch? Beschreibung last_name Nein Nachname des Käufers. Maximal 50 Zeichen. first_name Nein Vorname des Käufers. Maximal 50 Zeichen. shopper_ip Nein Die IP-Adresse für den Computer des Käufers. Damit wird die Identität des Käufers bei der Umleitung zum Webstore überprüft. In den folgenden Fällen sollten Sie den Parameter nicht angeben: Die Integrität der IP-Adresse des Käufers kann nicht garantiert werden. Im Abschnitt Verification Settings (Überprüfung Einstellungen) der ELMS-Verwaltung ist die Option Verify shopper s IP address (IP-Adresse des Käufers überprüfen) deaktiviert. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

13 Tabelle [2] Einzelner WebStore mit mehreren Organisationen, die den WebStore verwenden Parametern ame member_org Obligatori sch? Ja** ** nur für einzelne WebStores mit mehreren Mitgliedsorgan isationen Beschreibung Organisationscode(s) der jeweiligen Mitgliedsorganisation(en), in welche der Nutzer zugeordnet wird. Hinweis: Diese Codes müssen in ELMS definiert werden. Richten Sie diese Daten zusammen mit Ihrem Kundenbetreuer ein. Beispiel: Meine Organisation ist die übergeordnete Organisation. Dieser gehören zwei untergeordnete Organisationen an (z. B. Krankenpflegeschule und Wirtschaftsschule). Wenn Sie für die gesamte Organisation nur einen WebStore nutzen möchten und dabei aber genau verfolgt werden soll, welcher Organisation die einzelnen Benutzer angehören, richtet Kivuto für jede Einheit eine Organisation ein. Meine Organisation = "OrgA" Krankenpflegeschule = "OrgB" Wirtschaftsschule = "OrgC" Jeder dieser Organisationen ist ein eigener Wert für member_org zugewiesen, der HTTP- GET-Aufruf nutzt jedoch einen gemeinsamen Schlüssel und ein gemeinsames Konto. Im folgenden werden Beispiele der HTTP GET-Aufrufe aufgeführt, bei denen die fiktive Kontonummer von OrgA ist: mber_org=orga&username=jsmith&key=orgakey&academic_statuses=students mber_org=orgb&username=bsmith&key=orgakey&academic_statuses=students mber_org=orgc&username=msmith&key=orgakey&academic_statuses=students [3] Einzelne IUV-Implementierung für mehrere WebStores Sie können eine IUV-Implementierung erstellen, die auf mehrere WebStores verweist. Jeder WebStore ist mit einer Organisation verknüpft. Die Kontonummer und Schlüsselparameter des HTTP-GET-Aufrufs bestimmen, an welchen WebStore der Käufer umgeleitet wird. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

14 Überprüfen der Antwortcodes ERFOLG War der HTTP-GET-Aufruf zum Registrieren des authentifizierten Benutzers erfolgreich, wird der HTTP- Statuscode 200 (OK) an die Integrationsanwendung des Kunden zurückgegeben. Der Text der Antwort enthält zudem eine URL, zu der der Käufer weitergeleitet werden kann. Siehe Umleiten des Käufers zum WebStore. FEHLER Bei einem Fehler im Kivuto-System wird der HTTP-Statuscode 500 an die Integrationsanwendung des Kunden zurückgegeben. Tritt ein Fehler mit dem HTTP-Statuscode 500 auf, empfiehlt Kivuto, dass der Anwendungscode Folgendes ausführen soll: Das Webentwicklungsteam wird in einer über den Fehler informiert. Dem Benutzer wird eine Meldung angezeigt, dass der Zugriff auf den WebStore derzeit offline ist und das Problem gerade behoben wird. Das Webentwicklungsteam sollte sich unter an den Kivuto- Support wenden. Falls aufgrund von Problemen mit den übergebenen Parametern ein Fehler auftritt, wird der HTTP- Statuscode 400 an die Integrationsanwendung des Kunden zurückgegeben. Außerdem wird eine der Fehlermeldungen angezeigt, die unten in Tabelle [4] Fehlermeldungen aufgeführt sind. Tritt ein Fehler mit dem HTTP-Statuscode 400 auf, empfiehlt Kivuto, dass der Anwendungscode Folgendes ausführen soll: Das Webentwicklungsteam wird in einer über den Fehler informiert. Dem Benutzer wird eine Meldung angezeigt, dass der Zugriff auf den WebStore derzeit offline ist und das Problem gerade behoben wird. Das Webentwicklungsteam muss das Problem beheben. Hinweis: Halten Sie zur weiteren Diagnose des Problems die genaue Meldung bereit (siehe folgende Tabelle), wenn Sie zur Fehlerbehebung Unterstützung vom Kivuto-Support benötigen. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

15 Tabelle [4] Fehlermeldungen Fehlermeldung Der erforderliche Parameter [Parametername] fehlte oder war in der Abfragefolge mehrmals mit unterschiedlichen Werten vorhanden. Webstore not found. Check caller IP address and WebStore system name (if passed). (WebStore nicht gefunden. Überprüfen Sie die IP-Adresse des aufrufenden Servers und den Systemnamen des WebStores (falls übergeben).) Submitted key does not match the one configured for the WebStore. (Der angegebene Schlüssel stimmt nicht mit dem für den WebStore konfigurierten Schlüssel überein.) One or more of the user groups specified in the query string does not exist. (Mindestens eine der in der Abfragezeichenfolge angegebenen Benutzergruppen ist nicht vorhanden.) One or more of the user group classes specified in the query string does not exist. (Mindestens eine der in der Abfragezeichenfolge angegebenen Benutzergruppenklassen ist nicht vorhanden.) Beschreibung Weist darauf hin, dass der als [Parametername] angegebene Parameter fehlte oder dupliziert wurde. Wenn mehrere Parameter fehlen, werden mehrere durch einen senkrechten Strich ( ) getrennte Meldungen angezeigt. Es wurde kein mit der IP-Adresse des aufrufenden Servers konfigurierter WebStore gefunden. Siehe Konfiguration IUV. Diese Fehlermeldung kann auch angeben, dass der Kontoparameter in der URL fehlt. Der übergebene Schlüssel stimmt nicht mit dem Schlüssel überein, der dem Kunden zugeordnet ist. Siehe Aktivieren von IUV. Mindestens eine der Benutzergruppen, die für den Käufer übergeben wurde entspricht keinem gültigen Code für die Benutzergruppe. Die Abfragezeichenfolge enthielt einen unbekannten Parameter. Künftig gelten zusätzliche Abfragezeichenfolgen als Benutzergruppenklassen. UMLEITEN DES KÄUFERS ZUM WEBSTORE Ist der oben beschriebene HTTP-GET-Aufruf erfolgreich, muss der Käufer an die in der Antwort zurückgegebene WebStore-URL umgeleitet werden. Das folgende Beispiel zeigt eine in der Antwort zurückgegebene URL: WsiG40nDSzDPFs%2fpwpWjM0jzrlBfyuF3JzrLzX6mg%3d%3d&ws=2fb0a48a-350a-dc11-bb1f fc5 s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

16 Falls nach der Umleitung beim Abschließen der Benutzerüberprüfung im WebStore ein Fehler auftritt, wird dem Käufer folgende Meldung angezeigt: We were unable to sign you in to the store. Please try again. Mögliche Gründe für diesen Fehler: Zwischen der Registrierung des authentifizierten Benutzers über den HTTP-GET-Aufruf und der Umleitung an den WebStore sind mehr als 60 Sekunden verstrichen. Die IP-Adresse des Käufers wurde überprüft und stimmt nicht mit der IP-Adresse überein, die vom Kundenserver bei der Registrierung des authentifizierten Benutzers übergeben wurde. Siehe Parameter der Benutzerauthentifizierung oben für Details. KONFIGURIEREN VON ELMS FÜR DIE INTERAKTION MIT IHRER ANWENDUNG Sie müssen registrierter und aktiver ELMS-Administrator oder Webentwickler sein, der der IUV- Administratorrolle in ELMS zugewiesen wurde, um IUV in ELMS konfigurieren zu können. ZUGRIFF AUF DIE ELMS-VERWALTUNG So greifen Sie über den WebStore auf die ELMS-Verwaltungswebsite zu 1. Geben Sie die URL des WebStores im Browser ein. 2. Klicken Sie in der rechten oberen Ecke der Seite auf den Link Anmelden. 3. Geben Sie Ihren Benutzernamen ein. 4. Geben Sie Ihr Kennwort ein. 5. Klicken Sie auf Anmelden. Nachdem Sie authentifiziert wurden, werden Sie bei Ihrem WebStore angemeldet. 6. Klicken Sie am oberen Bildschirmrand auf den Link Verwaltung, um die ELMS- Verwaltungswebsite aufzurufen. Ein neues Fenster wird geöffnet. ERMITTELN IHRER KONTONUMMER Die ELMS-Kontonummer ist eine eindeutige Kennung für Ihre Organisation. Diese Nummer ist aus den folgenden Gründen erforderlich: s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

17 Zur Anmeldung bei der ELMS-Verwaltungswebsite ohne Umweg über den Webstore. Hinweis: Wenn Sie die integrierte Benutzerüberprüfung einrichten und falsch konfigurieren, können Sie nicht über den Webstore auf die ELMS-Verwaltungswebsite zugreifen, um die nötigen Änderungen zur Korrektur der Konfiguration vorzunehmen. Sie können über eine spezielle Anmeldeseite auf die ELMS-Verwaltungswebsite zugreifen. Zum Einrichten der integrierten Benutzerüberprüfung. Wenn Sie sich bei der ELMS-Verwaltungswebsite abmelden, wird eine andere Anmeldeseite angezeigt. Diese Anmeldeseite ist nicht näher gekennzeichnet. Siehe Abbildung unten: Auf dieser Seite werden Sie aufgefordert, Ihre Kontonummer und Ihren Benutzernamen mit zugehörigem Kennwort einzugeben. Die Seite ermöglicht einen schnellen Zugriff auf die ELMS-Verwaltungswebsite ohne Umweg über den Webstore. So finden Sie Ihre Kontonummer: 1. Melden Sie sich bei Ihrem WebStore an. 2. Klicken Sie auf den Link Verwaltung. 3. Klicken Sie Organisation im Hauptmenü. Die Seite mit den Details zur Organisation wird angezeigt. 4. Notieren Sie sich die Kontonummer im gleichnamigen Eingabefeld. Sie können sich nun direkt bei der ELMS-Verwaltungswebsite anmelden. Wechseln Sie hierfür zu s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

18 und geben Sie Ihre Kontonummer sowie den Benutzernamen und das Kennwort des Administratorkontos ein. AKTIVIEREN VON IUV Sie müssen zuerst die integrierte Standardbenutzerüberprüfung als Überprüfungstyp einrichten, um IUV in ELMS aktivieren zu können. Für die Einrichtung der IUV (Integrated User Verification, integrierte Benutzerüberprüfung) sind die folgenden Schritte erforderlich: 1. Definieren von IUV als Überprüfungstyp 2. Konfigurieren der IUV Definieren von IUV als Überprüfungstyp So definieren Sie die IUV als Überprüfungstyp 1. Melden Sie sich bei der ELMS-Verwaltungswebsite an. 2. Klicken Sie im Hauptmenü auf WebStore. Die Seite <a>webstore-details wird angezeigt. 3. Klicken Sie auf die Registerkarte Überprüfung. Die Seite <a>webstore-überprüfung wird angezeigt. Die Liste mit den derzeit konfigurierten Überprüfungstypen wird auf der Seite angezeigt. Hinweis: Standardmäßig wird Benutzerimport für neue WebStores konfiguriert. Es kann jedoch bereits ein anderer Überprüfungstyp konfiguriert sein. 4. Klicken Sie auf das Kontrollkästchen neben jedem Überprüfungstyp, bei dem es sich nicht um die standardmäßige integrierte Benutzerüberprüfung (Standard Integrated User Verification) handelt, und klicken Sie dann auf die Schaltfläche Löschen. 5. Klicken Sie auf die Schaltfläche Hinzufügen. Die Seite <a>benutzerüberprüfungstypen wird angezeigt. 6. Aktivieren Sie das Kontrollkästchen neben <a>integrierte Standardbenutzerüberprüfung. 7. Klicken Sie auf OK, um Ihre Auswahl zu speichern. Zu Testzwecken können Sie mehrere IUV-Standardüberprüfungsmethoden hinzufügen. In der Standardeinstellung wird der Status eines neu hinzugefügten Authentifizierungstyps auf Test festgelegt. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

19 TESTOPTIONEN Während ein Authentifizierungstyp den Status Test aufweist, können Sie diesen testen. So zeigen Sie Ihren WebStore ausschließlich mit Test-Authentifizierungstypen an: 1. Klicken Sie im Hauptmenü auf WebStore. Die Seite <a>webstore-details wird angezeigt. 2. Klicken Sie auf die Registerkarte Überprüfung. Die Seite <a>webstore-überprüfung wird angezeigt. 3. Markieren Sie im Abschnitt mit den Testoptionen die Test-WebStore-URL mit ausschließlich Test-Authentifizierungstypen. 4. Kopieren Sie die URL. 5. Fügen Sie die URL in einen Browser ein, der nicht dem derzeit verwendeten Browser entspricht. Alle mit Test-WebStore-URLs aufgegebenen Bestellungen sind Testbestellungen. Dies bedeutet, dass auf der Seite mit den Bestellungsdetails *Testbestellung* angezeigt wird und keine Produktschlüssel angezeigt werden. Status der Überprüfungsmethode: Test: Der Authentifizierungstyp kann getestet werden, wird jedoch Käufern in Ihrem WebStore nicht angezeigt. Es kann jeweils nur einer der Single-Sign-On-Authentifizierungstypen gleichzeitig getestet werden. Aktiv: Der Überprüfungstyp wird im WebStore angezeigt. Es kann jeweils nur eine Authentifizierung mit einmaligem Anmelden aktiv sein. Inaktiv: Der Authentifizierungstyp wird nicht im WebStore angezeigt und nicht getestet. So ändern Sie den Status Ihres Überprüfungstyps zu Aktiv Klicken Sie in der Spalte Aktionen auf Aktivieren. Wenn bereits eine Authentifizierung dieses Typs aktiv ist, wird diese deaktiviert. So ändern Sie den Status Ihres Authentifizierungstyps in Test : Klicken Sie in der Spalte Aktionen auf Zu Test ändern. Wenn bereits eine Authentifizierung dieses Typs getestet wird, wird diese deaktiviert. So ändern Sie den Status Ihres Authentifizierungstyps in Inaktiv : Klicken Sie in der Spalte Aktionen auf Deaktivieren. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

20 Es können mehrere Authentifizierungsmethoden gleichzeitig aktiv sein, sofern die Authentifizierungsmethoden zu unterschiedlichen Klassen gehören. Konfigurieren der IUV Nachdem Sie die integrierte Benutzerüberprüfung für Ihre Organisation definiert haben, müssen Sie sie konfigurieren. So konfigurieren Sie die IUV für Ihre Organisation Auf der Überprüfungsseite von WebStore klicken Sie auf den Link Integrierte Standard- Nutzerüberprüfung. Die Seite <a>benutzerüberprüfungstyp wird für die IUV angezeigt. Die Seite <a>benutzerüberprüfungstyp besteht aus zwei Registerkarten: Details und Einstellungen. Details Nehmen Sie keine Änderungen an den Standardwerten für <a>sektor und <a>überprüfungen laufen ab in vor. Bei einer Änderung funktioniert die integrierte Benutzerüberprüfung möglicherweise nicht mehr ordnungsgemäß, und die Benutzer können sich nicht mehr bei ELMS anmelden. Einstellungen Auf der Seite Einstellungen werden alle Kundeninformationen definiert, die von Kivuto benötigt werden. In Tabelle [5]: Für Kivuto erforderliche Kundeninformationen werden die Informationen aufgeführt, die für die Konfiguration eines Kunden für IUV erforderlich sind. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung

21 Tabelle [5]: Für Kivuto erforderliche Kundeninformationen Information Obligatorisch? Beschreibung Externe Anmelde-URL Ja URL der Seite auf der Kundenwebsite, auf der der Käufer vor dem Umleiten zum WebStore authentifiziert wird, oder URL einer Seite mit einem Link, mit dem der Käufer zum WebStore umgeleitet wird. Der Käufer wird vom WebStore zu dieser URL umgeleitet, wenn er eine Aktion ausführt, die eine Authentifizierung erfordert (falls er z. B. dem Warenkorb ein Produkt hinzufügt), oder wenn sich ein Benutzer beim WebStore abmeldet. Damit auf der Seite der Kundenwebsite zwischen diesen Fällen unterschieden werden kann, wird der Abfragezeichenfolge der URL ein Parameter hinzugefügt. Der Name des Parameters lautet action, und die möglichen Werte sind signin und signout. Für die Handhabung der oben genannten Fälle muss geeigneter Code entwickelt werden. IP-Adressliste der aufrufenden Server Kontonummer der Organisation Nein Ja Liste mit IP-Adressen von Kundenservern, die mit HTTP-GET-Aufrufen authentifizierte Käufer bei einem WebStore registrieren. Vom WebStore wird überprüft, ob die IP eines aufrufenden Servers mit einer IP-Adresse in dieser Liste übereinstimmt. Für Hilfe bei der Bestimmung dieser Adressen siehe unten Ermitteln der IP-Adressen vom Kundenserver. Die Kontonummer, die Ihrer Organisation in ELMS zugewiesen ist. Diese Nummer wird hier angezeigt und kann in der Integrationsanwendung verwendet werden. Schlüssel Ja Der gemeinsame geheime Schlüssel, mit dem die Identität des aufrufenden Servers überprüft wird. Generieren Sie den Schlüssel, indem Sie auf die Schaltfläche Generieren klicken. Der Schlüssel wird erst gespeichert, wenn Sie auf OK oder Übernehmen klicken. -Adresse des IUV- Administrators Ja Die -Adresse der Person (oder Verteilerliste), die Fehlermeldungen von ELMS empfängt. s ELMS-Implementierungshandbuch für die integrierte Benutzerüberprüfung