Cookie Authentifizierung mit Mindbreeze
Installation und Einrichtung
Copyright ©
Mindbreeze GmbH, A-4020 Linz, .
Alle Rechte vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Marken der jeweiligen Hersteller.
Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet.
Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z.B. Benutzer/-innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter.
Cookie Authentifizierung mit Mindbreeze
Die Cookie Authentifizierung ermöglicht Mindbreeze InSpire, die Anmeldeinformationen eines Webportals für die Suche zu verwenden. Voraussetzung ist, dass ein eingeloggter Benutzer im Webportal ein Cookie hat (das Webportal und Mindbreeze InSpire liegen am selben Host) oder ein Cookie mit Anmeldeinformationen angefordert werden kann (das Webportal und Mindbreeze InSpire müssen nicht am selben Host liegen). Außerdem muss die Voraussetzung gegeben sein, dass ein Cookie wieder in Benutzername und dessen Gruppen vom Webportal „aufgebrochen“ werden kann. Anmeldeszenarien können in Kapitel Anmeldeszenarien gefunden werden.
Konfiguration
Die Cookie Authentifizierung wird am Client Service konfiguriert. Durch Hinzufügen der „SessionAuthenticationService.CookieAuthentication“ als „Session Authentication Plugin“ wird die Cookie Authentifizierung für das jeweilige ClientService aktiviert und kann konfiguriert werden.
Login Form URL
Die „Login Form URL“ sollte auf das Client-Service gesetzt werden (https://<clientservice+port> /apps/login/login.html?destination=/apps/login/loggedin.html). Es handelt sich bei diesem Formular um ein Login Formular, das bei der Anmeldung verwendet wird.
Sample URL
Die „Sample URL“ muss vom Portal zur Verfügung stehen und „konvertiert“ ein durch das Login erhaltenes Cookie in den Benutzernamen und dessen Gruppen im Portal. Dabei wird ein GET-Request an die „Sample URL“ gesendet (Header „Cookie“ ist gesetzt), wobei im Response dann die Headers „X-Username“ und „X-Groups“ gesetzt sind. Damit weiß der Mindbreeze Search Client dann einerseits, welcher Benutzer angemeldet ist und andererseits, zu welchen Gruppen der Benutzer gehört.
Post URL for Login on Portal
Das ist die Login Post URL am Portal wohin der Benutzername und dessen Passwort aus dem Login Form gepostet werden. Dabei wird der Benutzername mit „credential_0“ und das Passwort mit „credential_1“ mittels Content-Type „application/x-www-form-urlencoded“ an die „Post URL for Login on Portal“ gesendet. Damit erhält Mindbreeze das Cookie im Header „Set-Cookie“, das mittels der „Sample URL“ in Benutzer und Gruppen aufgelöst werden kann.
Additional Login URLs
Das sind zusätzliche URLs, die vor der Login-Post-URL aufgerufen werden, um zusätzliche Cookies zu erhalten.
Additional Form Params
Diese Parameter werden zusätzlich an die definierte Login-Post-URL übermittelt.
Anmeldeszenarien
Der Mindbreeze Search Client ist in das Portal eingebunden
Falls der Search Client ins Portal eingebunden ist und das Anmeldecookie auch an das Client Service geschickt wird, muss nur die „Sample URL“ konfiguriert werden. Erhält der Mindbreeze Client eine Anfrage mit dem Cookie, wird dieses automatisch an die Sample URL geschickt, um dort in Benutzernamen und Gruppen „aufgebrochen“ zu werden.
Der Mindbreeze Search Client existiert außerhalb des Portals
Soll der Mindbreeze Search Client über eine andere URL als das Portal angesprochen werden, müssen folgende Parameter konfiguriert werden, wobei der Ablauf folgendermaßen aussieht:
- Der Login erfolgt über die „Login Form URL“, um den Benutzernamen und das Passwort eingeben zu können.
- Die Anmeldeinformationen werden dann an „Post URL for Login on Portal“ gesendet, um ein Cookie zu erhalten.
- Dieses Cookie wird anschließend an die „Sample URL“ gesendet, um den angemeldeten Benutzernamen und dessen Gruppenzugehörigkeiten auflösen zu können.