easylearn Webservice lsessionservice Interface für Single Sign On (SSO)

Transkript

1 - 1 - easylearn Webservice lsessionservice Interface für Single Sign On (SSO) SDN AG, Solution Development Network Dezember 2008

2 - 2 - Inhaltsverzeichnis Inhaltsverzeichnis... 2 easylearn Webservice lsessionservice... 3 Funktionsweise... 3 Webservice Funktionen... 4 CreateLoginSession (key, userid)... 4 Fehlermeldungen / Exceptions... 4 Technische Anforderungen LSESSIONSERVICE... 4 WebService-Beschreibung... 4 Webserver... 4 Client... 4 Einstellungen... 5 Option LSESSIONSERVICE... 5 Zugriffsschlüssel erstellen... 5 PHP Beispiel... 6 Ergebnis... 6

3 - 3 - easylearn Webservice lsessionservice Über den Webservice lsessionservice kann ein temporär gültiger Anmeldelink generiert werden. Der Link ist standardmässig 15 Minuten gültig, danach verfällt er. Mit dem Anmeldelink wird ein Benutzer automatisch angemeldet. Funktionsweise 1. Der Benutzer klickt auf den Anmeldelink im Intranet 2. Der Intranet-Server erkennt den angemeldeten Windows-Benutzer und fordert beim easylearn-server über den Webservice lsessionservice einen temporären Anmeldelink für diesen Benutzer an. 3. Der easylearn Server generiert einen temporär gültigen Anmeldelink für den Benutzer und sendet diesen an den Intranet-Server als Antwort zurückt. Der easylearn Server akzeptiert nur Anfragen von der definierten IP-Adresse des Intranet-Servers 4. Der Intranet-Server fügt evtl. weitere Parameter an den Anmeldelink an und sendet die URL als Redirect an den Browser zurück 5. Der Browser führt den Redirect aus und meldet den Benutzer über den Anmeldelink automatisch an easylearn an.

4 - 4 - Webservice Funktionen CreateLoginSession (key, userid) Parameter: String key: Zugriffsschlüssel String user: Benutzer-ID, für welchen der Anmeldelink erstellt werden soll Ergebnis: Anmeldelink Im Fehlerfalle wird eine Exception ausgelöst. Fehlermeldungen / Exceptions Fehlercode Inhalt/Beschreibung 101 Konfiguration für LSESSIONSERVICE nicht vorhanden (Siehe Option LSESSIONSERVICE auf Seite 5) 102 LSESSIONSERVICE ist deaktiviert 103 Ungültiger Zugriffsschlüssel 201 Verbotener Aufruf: Die IP-Adresse des Clients/Remoteserver ist nicht konfiguriert. 203 Parameter user ist leer 204 Der im Parameter user definierte Benutzer ist in easylearn gesperrt 205 LDAP Bind fehlgeschlagen 206 LDAP: Benutzer konnte nicht im LDAP-Verzeichnis gefunden werden 207 LDAP: Benutzer ist blockiert oder deaktiviert im LDAP-Verzeichnis 208 LDAP: Benutzer konnte im Portal nicht erstellt werden 209 LDAP: Option AUTOCREATE in der LDAP-Konfiguration nicht eingeschaltet 210 Der im Parameter user angegebene Benutzer ist nicht im Portal vorhanden und konnte auch nicht im LDAP-Verzeichnis gefunden werden 401 SQL Fehler Technische Anforderungen LSESSIONSERVICE WebService-Beschreibung Die Dienstbeschreibung wird über lsessionuservice.wsdl zur Verfügung gestellt Webserver easylearn skills4u oder neuer PHP 5 mit aktivierter Erweiterung PHP_SOAP.DLL benötigt. Client SOAP via HTTP Verbindung zum Webserver easylearn

5 - 5 - Einstellungen Option LSESSIONSERVICE Diese Option muss Systemadministrator eingeschaltet werden: Rolle Systemadministrator auswählen. Im Menü Systemadministrator -> Einstellungen -> Optionen auswählen Hinzufügen auswählen Feld Inhalt Option LSESSIONSERVICE Zahl 1 0 = LSESSIONSERVICEinaktiv 1 = LSESSIONSERVICEaktiviert Zahl 2 Text 1 Klartextpassphrase. Diese Passphrase wird bei jedem Zugriff überprüft. Diese Passphrase muss durch den Administrator verschlüsselt werden. Der daraus resultierende Text wird als Zugriffsschlüssel verwendet Text 2 Mit dem Schlüsselwort LDAP kann Option LDAP für die Suche aktiviert werden Data 1 Enthält die IP-Adresse/IP-Bereiche der erlaubten Clients, welche den Service verwenden dürfen. Bei mehreren IP-Adressen wird jeweils 1 Adresse pro Zeile konfiguriert. Zugriffsschlüssel erstellen. Diese Option muss Systemadministrator eingeschaltet werden: Rolle Systemadministrator auswählen. Im Menü Systemadministrator -> Admin-Funktionen -> Tools auswählen Unter System -> Ver-/Entschlüsselung auswählen Als Klartext die Passphrase aus dem Feld Text 1 eingeben und auf Übermitteln klicken. Der Text im Feld Verschlüsselt ist der Zugriffsschlüssel, welcher bei der Funktion CreateLoginSession() verwendet werden muss..

6 - 6 - PHP Beispiel <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML><HEAD> <TITLE>easyLEARN LoginSession Test</TITLE> </HEAD> <BODY> <h1>easylearn LSESSIONSERVICE Test</h1> <?php $server = " $wsdl = "$server/lsessionservice.wsdl"; $service = "$server/lsessionservice.php"; echo "Service: $service<br>"; echo "WSDL : <a href=\"$wsdl\" target=\"_blank\">$wsdl</a><br>"; $accesskey = "FiB3BkkiDFoat6xWCQ.."; $user = "admin@easylearn.ch"; ini_set ("soap.wsdl_cache_enabled",0); $client = new SoapClient($wsdl,array( "location" => $service, "uri" => "urn:lsessionservice", "trace" => 1, "exceptions" => 1)); echo "<h3>call <strong>createloginsession($accesskey, $user)</strong></h3>"; try { $result = $client->createloginsession($accesskey,$user); echo "Login-URL $user: <a href=\"$result\">$result</a><br>"; $r = $result. "&r=". urlencode("knowhow.php?cmd=knowledge&subcmd=dirlist&catid=282"); echo "Suchmaschine $user: <a href=\"$r\">$r</a><br> "; } catch (SoapFault $fehler) { echo "Fehler bei CreateLoginSession :". $fehler-> tostring(); print "<P>Response:\n".htmlspecialchars($client- > getlastresponse())."</p>\n"; exit; }?> </body> </html> Ergebnis