JiveSoftware Jive Connector

Installation und Konfiguration

Konfiguration von Mindbreeze

Konfiguration von Index und Crawler

Klicken Sie auf das „Indices“-Tab und danach auf das „Add new index“-Symbol, um einen neuen Index zu erstellen.

Geben Sie den Indexpfad ein, z.B. „C:\Index“. Passen Sie gegebenenfalls den Display Name des Index Service und des zugehörigen Filter Service an.

Weiter muss die Option „Use ACL References“ aktiviert werden.

Fügen Sie eine neue Datenquelle mit dem Symbol „Add new custom source“ rechts unten ein.

Wenn nicht bereits ausgewählt, selektieren Sie „JiveSoftware Jive“ bei der Schaltfläche „Category“ aus.

Über die Einstellung „Crawler Interval“ konfigurieren Sie die Zeitspanne, die zwischen zwei Indizierungsdurchläufen gewartet wird.

Web Page

Im Feld Crawling Root können Sie Ein URL angeben wo ein Jive Sitemap erreichbar ist. Wenn Sie den Mindbreeze Sitemap Generator Add-On auf ihren Jive Server installiert ist und eine Sitemap erzeugt wurde, sollte hier die URL <Jive URL>/rpc/rest/mindbreeze/sitemap?jobid=full eingetragen werden.

Im Feld „URL Regex” können Sie einen regulären Ausdruck bestimmen, der ein Muster für die Links, die indiziert werden sollen, vorgibt.

Sollen bestimmte URLs vom Crawlen ausgenommen werden, so können diese mit einem regulären Ausdruck unter „URL Exclude Pattern“ konfiguriert werden.

Sollte aus netzwerktechnischen Gründen die DNS-Auflösung bestimmter Webserver nicht klappen, kann man mit dem „Additional Hosts File“ die IPs vorgeben.

Möchte man bestimmte HTTP Header hinzufügen (beispielsweise Accept-Language), so kann man das über die „Accept Headers“ einstellen.

Mit der „Use Stream Parser“ Option wird ein Stream Parser für die Bearbeitung der Sitemaps verwendet. Diese Option ist für Sitemaps mit sehr vielen URLs geeignet.

Die “Max Retries” Option legt fest, wie oft der Connector bei vorrübergehenden Fehlern (z.B Socket-Tiemout) versucht ein Dokument erneut herunterzuladen. Der Standardwert ist hier 0 (keine erneuten Versuche). Wenn die Timeouts durch ein instabiles Netzwerk verursacht werden, kann es helfen den Wert zu erhöhen. Wenn die Timeouts jedoch auf eine Überlastung der Datenquelle zurückzuführen sind, sollte der Wert auf 0 belassen werden um die Datenquelle nicht noch mehr zu belasten.

Die Option “Retry Delay Seconds” legt die Wartezeit zwischen den erneuten Versuchen fest (in Sekunden). Der Standardwert ist 1.

Resource Parameters

In diesem Abschnitt (nur verfügbar, wenn „Advanced Settings“ ausgewählt ist) kann noch die Crawl-Geschwindigkeit adjustiert werden.

Mit der Anzahl der Crawler-Threads („Number Of Crawler Threads“) kann definiert werden, wie viele Threads gleichzeitig Webseiten vom Webserver abholen.

Das „Request Interval“ definiert die Anzahl an Millisekunden, die der Crawler(-Thread) zwischen den einzelnen Requests warten soll. Eine „Crawl-Delay“ Robots-Anweisung wird jedoch auf alle Fälle berücksichtigt und überschreibt diesen Wert.

Proxy

Im Abschnitt „Proxy“ können Sie einen Proxy Server eintragen, falls Ihre Infrastruktur dies erfordert. Tragen Sie dazu den Computernamen und den Port des Proxy-Servers in „Proxy Host“ und „Proxy Port“ ein.

Der Jive Connector kann sich am Proxy auch mittels HTTP-BASIC anmelden. Tragen Sie in das Feld „Proxy User“ den Benutzer und in „Proxy Password“ das zugehörige Passwort ein, wenn die Verbindungen über einen Proxy mit Authentifizierung erfolgen sollen.

Jive Login

Basic Authentication

Im Abschnitt „Basic access authentication“ kann ein „Credential“ ausgewählt werden, welches bei der Basic Authentifizierung für die http Anfragen verwendet wird. Hier sollte ein Credential vom Typ „Username/Password“ angegeben werden.

Dieses Credential kann im Reiter „Network“ unter „Credentials“ hinzugefügt und konfiguriert werden.

OAuth Authentication

Der Mindbreeze Jive Connector unterstützt auch OAuth, aber wegen technischen Einschränkungen der Jive API Endpunkte muss zusätzlich auch Basic Authentication konfiguriert werden.Um OAuth zu konfigurieren, muss in den Jive Einstellungen ein Add-On hochgeladen werden. Dieses Add-On kann hier erstellt werden. Das erstellte Add-On kann hier hochgeladen werden: <Jive URL>/addon-services!input.jspa
Unter „Action“ können dann „Client ID“ und „Secret“ eingesehen werden.

Für die OAuth Authentication muss ein Credential vom Typ „OAuth 2“ angelegt werden, welches bei der OAuth Authentifizierung für die HTTP Anfragen verwendet wird. Für das Credential wird die „Client ID“ und das „Client Secret“ benötigt.

Das Credential kann dann im Reiter „Network“ unter „Credentials“ erstellt und konfiguriert werden.

Im Abschnitt „OAuth access authentication“ wählt man nun das Credential aus, welches man vorhin konfiguriert hat.

Formularbasierte Authentisierung

Wenn die Jive Sitemap mit HTTP formularbasierter Authentisierung erreichbar ist, können die Login Parameter im Abschnitt „Form Based Login“ folgendermaßen konfiguriert werden:

• Login URL: die Jive URL, an die das Login Formular geschickt werden soll: z.B.
• Form Elements: hier muss ein Element mit Name „username“ hinzugefügt werden. Der Wert („Value“) soll der Benutzername sein, der dazu berechtigt ist, die Sitemap runterzuladen.
• Form Password Elements: hier muss ein Element mit Name „password“ hinzugefügt werden. Der Wert („Value“) soll das Passwort für den zuvor angegebenen Benutzer sein.

Access Check Rules

Zusätzlich gibt es noch die Möglichkeit, sogenannte „Access Rules“ zu definieren, wobei diese aus folgenden Optionen besteht:

• „Access Check Principal”, die Benutzernamen können im Format „username@domain“, „domain\username“ oder „distinguished name“ sein. Die Gruppennamen können nur im Format distinguished name sein. Weiters kann hier ein Verweis auf eine Capture-Group in der Selection Pattern verwendet werden.
• „Access Check Action”, Grant order Deny.
• „Metadata Key for Selection”, ein Metadatenname, kann leer sein (alle Dokumente werden selektiert)
• „Selection Pattern”, eine Regularexpression, kann leer sein (alle Dokumente werden selektiert).

Jive URL

Kaltura Video Integration

Der Jive Connector bietet auch die Möglichkeit, in Jive eingebettete Kaltura Videos zu indizieren. Wichtig dabei ist, dass die Videos in Jive als HTML iframe eingebunden werden (siehe auch Embedding Kaltura Media Players in Your Site). Die eingebetteten Videos vererben in Mindbreeze InSpire die Berechtigungen der Jive-Seite, in der sie eingebettet wurden. Bitte beachten Sie außerdem, dass mehrfach eingebettete (also gleiche) Videos in einer Suche mehrfach gefunden werden.

Folgende Optionen müssen konfiguriert werden:

Jive Principal Resolution

In die Mindbreeze Konfiguration öffnen Sie die “Indizes” Reiter und fügen Sie ein Caching Jive Principal Resolution Service hinzu.

Geben Sie den „Jive Server URL“ an. Ist bei Jive der Zugriff für nicht angemeldete Benutzer erlaubt, bitte die Option „Jive Guest Access enabled“ aktivieren. Mit der Option „Groups Containing All Users“ können Gruppen definiert werden, sodass alle Benutzer so behandelt werden, als ob sie Mitglieder dieser Gruppen sind. Mit der Aktivierung von „Keep Groups Containing All Users in Memory“ werden solche Gruppen bis zum nächsten Cacheupdate im RAM gehalten.

1. Die notwendigen Anmeldeinformationen, um auf den „Jive Server URL“ zugreifen zu können, müssen im Reiter „Network“ konfiguriert und auf den „Jive Server URL“ Endpunkt abgebildet werden.

Geben Sie den Verzeichnispfad für den Cache im „Database Directory Path“ Feld an und ändern Sie, wenn notwendig, die „Cache In Memory Items Size“, abhängig vom verfügbaren Speicherplatz der JVM. Im „Cache Update Interval“ Feld geben sie die Zeit (Minuten) an, die gewartet wird bevor der Cache aktualisiert wird. Beim ersten Starten des Service wird diese Zeit ignoriert. Beim nächsten Starten des Services wird diese Zeit berücksichtigt. Die Einstellungen „Health Check Interval“, „Health Check max. Retries On Failure“ und „Heath Check Request Timeout“ ermöglichen es, dass dieser Service neugestartet wird falls es z.B. dauerhafte Verbindungsprobleme gibt.

Das Service wird am angegebenen “Webservice Port” verfügbar. Wenn mehrere Principal Resolution Services konfiguriert sind, stellen Sie sicher, dass die „Webservice Port“ Parameter unterschiedlich sind und die konfigurierte Ports verfügbar sind.

Mit der Option „Lowercase Principals“ werden alle Principals vom Cache kleingeschrieben geliefert.

Wenn Benutzer bei einer Suchanfrage nicht aufgelöst werden können, wird eine Anfrage direkt an Jive abgesetzt, wenn die Option „Supress JIVE Service Calls“ nicht aktiviert ist. Aus Performancegründen wird jedoch empfohlen, diese Option zu aktivieren, sodass keine Live-Anfragen an Jive gestellt werden.

Um den Caching Principal Resolution Service zu testen, können Sie die Principal Resolution Service REST API verwenden.

Falls die Benutzernamen nach der Authentifizierung im ClientService nicht den Benutzernamen in JIVE entsprechen, dann ist es möglich, diese von einem anderen Cache mit der Konfiguration eines „Parent Principals Cache“ aufzulösen. Dafür muss „Use Parent Principals Cache Service“ aktiviert und der Port „Parent Principals Cache Service Port“ eingetragen werden. Mit der Konfiguration von „Parent Cache Principals Include Patterns“ und „Parent Cache Principals Exclude Patterns“ können die aufgelösten Gruppen und Aliasnamen vom „Parent Cache“ gefiltert werden. Wenn die aufgelösten Gruppen und Aliasnamen vom „Parent Cache“ den Aliasnamen im JIVE Cache entsprechen, dann darf die Checkbox „Parent Principals Are Unique IDs“ nicht ausgewählt werden.