DocCheck® Economy Modus
DocCheck® Konfiguration
Sie benötigen einen DocCheck® Basis Zugang (kann unter https://crm.DocCheck.com/de/ angelegt werden). Wenn Sie unter diesem Zugang auf der DocCheck®-Seite eingeloggt sind, können sie einen DocCheck® Login anlegen.
Eingetragen wird auf der ersten Seite der Konfiguration (Grunddaten)
- Name des Logins
- URL des Logins
- Die Weiterleitungs-URL (Ziel-URL)
- Sprache
- Land
- Login Status
ACHTUNG: Die Weiterleitungs-URL für den erfolgreichen Login wird an dieser Stelle konfiguriert.
Abbildung 6 - DocCheck® Economy Login Konfiguration - Schritt 1
Im zweiten Schritt (nach Klick auf „speichern und weiter“) wählt man die Berufsgruppen aus, die über diesen Login Zugriff auf die Weiterleitungsseite erhalten sollen, indem man die Checkboxen der entsprechenden Berufsgruppen auswählt.
Abbildung 7 – DocCheck® Economy Login Konfiguration - 2. Schritt
Im dritten Schritt wird der Code für den Anmeldungs-Iframe generiert. Man hat die Wahl zwischen verschiedenen Designs und Sprach/Ländervarianten.
Der dort generierte Iframe-HTML-Code wird später in den Moduleinstellungen des Doc-Check® Login Moduls hinterlegt und darf nicht modifiziert werden.
Abbildung 8 - DocCheck® Economy Login Konfiguration - 3. Schritt
Für den Fall, dass sämtliche DocCheck®-authentifizierten Benutzer auf die gleiche contentXXL Seite weitergeleitet und mit dem selben Benutzernamen angemeldet werden sollen, ist die DocCheck® Login Konfiguration beendet.
Falls es pro Berufsgruppe unterschiedliche Weiterleitungsseiten, unterschiedliche contentXXL Benutzer und damit auch unterschiedliche contentXXL Zugriffsrechte geben soll, kann nun eine Berufsgruppenweiche eingerichtet werden.
Auf Seite vier der DocCheck® Login Konfiguration befindet sich für die Economylizenz ein zugewiesenes Special „Berufsgruppen-Routing“. Klicken Sie dort auf den Link „konfigurieren“.
Abbildung 9 - DocCheck® Economy Login Konfiguraton - 4. Schritt
Für jede von DocCheck® unterstützte Berufsgruppe kann eine eigene Weiterleitungsseite ein-gerichtet werden. Die URL der Weiterleitungsseite setzt sich zusammen aus der contentXXL BaseURL und dem virtuellen Skriptnamen „DocCheck®.login“ und einem Parameter „group-name“.
Der Groupname Parameter entspricht dem Gruppennamen, der im contentXXL Modul für die Weiterleitung und Benutzeranmeldung hinterlegt wird.
Beispiel: Der contentXXL Webauftritt soll einen speziellen Bereich für Ärzte und einen speziellen Bereich für Apotheker enthalten. Man richtet folgende Berufsgruppen-Routings ein
Arzt/Ärztin:
Weiterleitungs-URL: http://www.contentxxlurl.com/DocCheck.login?groupname=Aerzte
Apotheker/in:
Weiterleitungs-URL: http://www.contentxxlurl.com/DocCheck.login?groupname=Apotheker
Ist der authentifizierte DocCheck® Benutzer der DocCheck® Berufsgruppe „Arzt/Ärztin“ zugewiesen, erfolgt eine Weiterleitung an die unter 1. Konfigurierte URL.
Ist der authentifizierte DocCheck® Benutzer keiner dieser speziellen Berufsgruppen zugeordnet, erfolgt die Weiterleitung auf die URL, die in Schritt 1 hinterlegt wurde – vorausgesetzt seine Berufsgruppe ist in Schritt 2 nicht explizit ausgeschlossen worden.
Abbildung 10 - DocCheck® Economy Login Konfiguration - 5. Schritt
Die DocCheck® Log-in-Konfiguration auf dem DocCheck® CRM Server ist mit diesem Schritt beendet.
contentXXL Modulkonfiguration
Wenn die Konfiguration auf dem DocCheck® CRM Server abgeschlossen ist, kann in contentXXL eine neue Instanz des DocCheck® Login Moduls erzeugt werden.
Abbildung 11 - DocCheck® Module im Modulbaum
Unter dem Reiter „Spezielle Einstellungen“ wird der Lizenztyp „Economy“ ausgewählt und der HTML-Code des iFrames hinterlegt.
Zusätzlich müssen folgende Einstellungen getroffen werden:
1. MD-Hash-Ergänzung:
Das ist ein spezieller, firmenabhängiger Code, der Ihnen von DocCheck® zur Verfügung gestellt wird. Das Modul benötigt diesen Code, um die Integrität der Weiterleitungsanfragen gewährleisten zu können (d. h. dass niemand URLs manipuliert und eine contentXXL Weiterleitung erzwingt, ohne vorher zwangsweise von DocCheck® authentifiziert worden zu sein)
2. Authentifizierungsmodus:
- UniqueKey Authentifizierung
Hierbei werden Benutzer mit einem persönlichen Log-in angemeldet. Das Doc-Check®-Modul leistet hierbei nur das Mapping zwischen DocCheck®-Benutzer und contentXXL-Benutzer. Das Anlegen und Verknüpfen eines contentXXL-Benutzers mit dem entsprechenden DocCheck®-Benutzer muss bei der contentXXL-Benutzerregistrierung erfolgen. (Customization des Benutzerprofil-Moduls)
Dieser Modus sollte dann zum Einsatz kommen, wenn im contentXXL-Portal personalisierte Leistungen angeboten werden sollen.
- Gruppenauthentifizierung
In diesem Modus arbeitet das Modul, dass es pro unterstützter DocCheck®-Berufsgruppe eine entsprechende contentXXL Benutzer-Rolle zuordnet. Jede dieser contentXXL Rollen bekommt einen contentXXL-Benutzer zugewiesen und mit diesem Benutzer werden alle Mitglieder der DocCheck®-Gruppe in contentXXL angemeldet.
Dieser Modus ist dann zu wählen, wenn keine personalisierten Funktionalitäten im contentXXL-Portal zur Verfügung gestellt werden und lediglich geschützte Information für unterschiedliche Berufsgruppen angeboten wird.
3. Konfiguration (UniqueKey Authentifizierung)
Zwei Links müssen registriert werden:
- Link zum Registrierungsformular – sollte ein interner Link zu der Seite mit dem Benutzerregistrierungsformular sein. Existiert noch kein contentXXL-Benutzer mit dem übergebenen UniqueKey, dann wird er auf diese Seite weitergeleitet.
Das DocCheck®-Modul setzt folgende Werte in die Benutzersession, die in dem Registrierungsformular verarbeitet werden können:
o DocCheck®_UniqueKey
o DocCheck®_GroupName
o DocCheck®_AuthSession
- Weiterleitungsseite – auf diese Seite wird der Benutzer nach erfolgtem Log-in weitergeleitet.
Abbildung 12 – DocCheck®-Modul – Konfiguration – UniqueKey Authentifizierung
4. Benutzerkonfigurationen (Gruppenauthentifizierung):
Eine Benutzer/Log-in-Konfiguration besteht aus Gruppenname, contentXXL Benutzer-name (Anmeldekürzel) und WeiterleitungsURL.
5. Gruppenname:
Entspricht dem Gruppennamen-Parameter, der im DocCheck® CRM in den WeiterleitungsURLs übergeben wird. (Bsp: all, Aerzte, Apotheker). Für jede im DocCheck® CRM hinterlegte Weiterleitung muss es im Modul eine Entsprechung geben.
6. Anmeldekürzel:
Dahinter verbirgt sich der contentXXL-Benutzername, unter dem der DocCheck® authentifizierte Benutzer in contentXXL angemeldet wird. Stellen Sie sicher, dass dieser Benutzer angelegt ist und die notwendigen Rechte zugewiesen hat (z. B. Leserecht auf den Seiten, die über die WeiterleitungsURL erreichbar sind).
7. Weiterleitungsseite:
Die interne contentXXL-URL, auf die ein authentifizierter Doc-Check®-Benutzer weitergeleitet werden soll, der zu der entsprechenden Gruppe gehört.
Abbildung 13 - DocCheck® Modul - Economy Konfiguration - Gruppenauthentifizierung
Sofern kein Berufsgruppenrouting benötigt wird, muss eine Benutzerkonfiguration hinterlegt sein, die sämtliche authentifizierten DocCheck®-Benutzer anmeldet und weiterleitet. Der Gruppenname hat dann dem Gruppennamen zu entsprechen, der in der DocCheck® CRM Log-in-Konfiguration in Schritt 1 unter „Ziel URL“ angegeben wird.
Abbildung 14 - DocCheck® Modul - Economy Konfiguration
Sofern kein Berufsgruppenrouting benötigt wird, muss eine Benutzerkonfiguration hinterlegt sein, die sämtliche authentifizierten DocCheck®-Benutzer anmeldet und weiterleitet. Der Gruppenname hat dann dem Gruppennamen zu entsprechen, der in der DocCheck® CRM Log-in-Konfiguration in Schritt 1 unter „Ziel-URL“ angegeben wird.
Fehlermeldungen
Sofern ein Benutzer nicht von DocCheck® authentifiziert werden kann, seine Berufsgruppe nicht konfiguriert oder sein Berufsnachweis von DocCheck® nicht validiert wurde, werden DocCheck®-Fehlermeldungen angezeigt, die nicht konfigurierbar sind.
Für den Fall, dass die Weiterleitungs-Weiche (der DocCheck®.login HTTP Handler) keine Weiterleitung durchführen kann, gibt contentXXL eine entsprechende Fehlermeldung aus, die für 5 Sekunden angezeigt wird, bevor der Benutzer wieder auf die Login-Seite weitergeleitet wird.
Installation
Das DocCheck® Premiummodul wird als Add-on zu contentXXL ausgeliefert und muss separat installiert werden.
Voraussetzung: contentXXL 4.1 (ab build 2964)
- Die Zipdatei DocCheck®Login.zip muss im contentXXL-Rootverzeichnis entpackt werden.
- Prüfen Sie, ob nach dem Entpacken im Pfad /addons/contentxxl/ ein Verzeichnis „DocCheck®Log-in“ angelegt wurde.
- Das SQL Skript, unter: /addons/contentxxl/ DocChecklogin/sqlscripts befindet sich in der contentXXL-Datenbank.
- Bei der Ausführung des Skripts wird eine neue Tabelle „DocCheckLoginSessionsSet“ angelegt und der Modultyp in allen vorhandenen Portalen registriert.
- Im Sitemanager steht nun unter Seiteneinstellungen das Modul „DocCheck® Log-in“ bereit.