In Jive Forums können Sie eine Implementierung spezifizieren, die für die Applikation eine externe Authentifizierung und Autorisierung bietet. Diese Dokumentation beschreibt wie Sie Crowds Authenticator in Jive Forums integrieren.

Grundvoraussetzungen

1. Downloaden und installieren Sie Crowd. Beziehen Sie sich für detaillierte Informationen dazu auf die Crowd Installationsanleitung. Nachfolgenden werden wir den Crowd Root-Ordner von nun an "CROWD" nennen.
2. Installieren/konfigurieren Sie Jive Forums. Beziehen Sie sich für den Installationsprozess auf die relevante Jive Forums Dokumentation. Die Dokumentation wird üblicherweise gemeinsam mit der Software-Distribution zur Verfügung gestellt. Versuchen Sie nicht Crowd als Authentifizierungssystem während des Installationsprozesses zu verwenden (benutzen Sie das Standard Authentifizierungssystem während des Installationsprozesses).

Schritt 1: Informieren Sie Crowd über Jive Forums

1.1 Bereiten Sie Crowds Verzeichnis/Benutzer für Jive Forums vor

Die Jive Forums Applikation wird Benutzer eines in Crowd konfigurierten Verzeichnisses lokalisieren müssen. Sie werden ein Verzeichnis in Crowd für Jive einrichten müssen. Für weitere Informationen darüber wie das funktioniert, lesen Sie bitte die Seite über das Hinzufügen eines Verzeichnisses. Wir werden das Verzeichnis von nun an in der restlichen Dokumentation Jive Forum Verzeichnis nennen. Es ist möglich mehr als ein Verzeichnis zu einer Applikation zuzuweisen, aber für die Zwecke dieses Beispiels werden wir nur das Jive Forum Verzeichnis für die Unterbringung der Jive Forum Benutzer verwenden.

Wenn Sie bereits Jive Forums im Einsatz haben und die existierenden Benutzer zu Crowd importieren möchten, dann verwenden Sie das Jive-Importer-Tool, indem Sie zu Users > Import Users > JIVE navigieren. Wählen Sie das Jive Forum Verzeichnis als das Verzeichnis aus, in das die Jive Forum Benutzer importiert werden. Für Details lesen Sie bitte die Dokumentation über das Importieren von Benutzern aus Jive Forums.
Wenn Sie Benutzer in Crowd importieren möchten, dann müssen Sie das jetzt tun, noch bevor Sie fortfahren.

1.2 Definieren Sie die Jive Forums Applikation in Crowd

Crowd muss darüber bescheid wissen, dass die Jive Forums Applikation Authentifizierungs-Anfragen an Crowd stellen wird. Wir müssen die Jive Forums Applikation zu Crowd hinzufügen und sie zu dem Jive Forums Verzeichnis zuweisen:

1. Loggen Sie sich in Crowds Administrationskonsole ein und navigieren Sie zu Applications > Add Application.
2. Schließen Sie den "Add Application" Assistenten für die Jive Forums Applikation ab. Lesen Sie die dazugehörigen Instruktionen, falls notwendig.
   Die Werte für Name und Passwort im "Add Application" Assistenten müssen mit den Werten von application.name und application.password übereinstimmen, die Sie in der JIVEFORUMS/WEB-INF/classes/crowd.properties Datei festlegen (sehen Sie Schritt 2 unten).

1.3 Definieren Sie welche Benutzer sich in Jive Forums einloggen können

Sobald Crowd über die Jive Forums Applikation bescheid weiß, muss Crowd noch wissen welche Benutzer sich in Jive Forums via Crowd authentifizieren (einloggen) können. Im "Add Application" Assistenten werden Sie Ihre Verzeichnisse und Gruppen-Autorisierungen für die Applikation einrichten. Wenn erforderlich, können Sie diese Einstellungen nach Fertigstellung des Assistenten noch anpassen. Unten finden Sie einige Beispiele.

Sie können entweder ganzen Verzeichnissen die Authentifizierung erlauben oder nur bestimmten Gruppen. In unserem Beispiel erlauben wir einfach dem ganzen Verzeichnis die Authentifizierung:

Alternativ können wir im Gruppen-Tab die Applikation auf bestimmte Gruppen einschränken. Für Details lesen Sie bitte die Dokumentation über das Definieren welche Gruppen auf eine Applikation zugreifen können.

1.4 Definieren Sie die Adresse, von der aus Jive Forums sich in Crowd einloggen kann

Im "Add Application" Assistenten werden Sie die Jive Forums IP-Adresse einrichten. Das ist die Adresse, von der aus sich Jive Forums bei Crowd authentifizieren wird. Falls notwendig, können Sie zusätzlich zur IP-Adresse noch einen Hostnamen hinzufügen. Lesen Sie dazu die Dokumentation über das Definieren eines Hostnamen und der Adresse einer Applikation.

Schritt 2: Informieren Sie Jive Forums über Crowd

2.1 Installieren Sie die Crowd Client-Libraries in der Jive Forums WebApp

Jive Forums wurde möglicherweise als einzelne WAR-Datei oder als entpackter WAR-Ordner auf einem Applikationsserver aufgesetzt. Für den restlichen Installationsprozess gehen wir davon aus, dass Jive Forums als entpackte WAR-Datei aufgesetzt wurde. Wenn Sie Jive Forums als einzelne WAR-Datei installieren müssen, dann erweitern Sie einfach die WAR zu einem Verzeichnis, nehmen die Änderungen, wie unten beschrieben, vor und komprimieren das Verzeichnis aus der WAR-Datei. Wir werden den Root-Ordner der Jive Forums Web-App von nun an in der restlichen Dokumentation "JIVEFORUMS" nennen.

1. Kopieren Sie die Crowd Integrations-Libraries und Konfigurationsdateien (dieser Schritt wird in der Dokumentation über die Client Konfiguration beschrieben). Das ist unten zusammengefasst:

   Kopieren Sie aus...	Fügen Sie ein in...
   CROWD/client/crowd-integration-client-X.X.X.jar	JIVEFORUMS/WEB-INF/lib
   CROWD/client/lib/log4j-1.2.8.jar	JIVEFORUMS/WEB-INF/lib/
   CROWD/client/lib/ehcache-1.2.3.jar	JIVEFORUMS/WEB-INF/lib/
   CROWD/client/conf/crowd.properties	JIVEFORUMS/WEB-INF/classes/
   CROWD/client/conf/crowd-ehcache.xml	JIVEFORUMS/WEB-INF/classes/

2. Ersetzen Sie die XFire-Libraries in Ihrer Jive Forums Installation mit den neueren Versionen, die mit Crowd mitgeliefert kommen:
   
   • Entfernen Sie alle xfire*.jar Dateien aus Ihrem JIVEFORUMS/WEB-INF/lib Ordner.

   • Kopieren Sie die XFire Libraries aus Crowd:

     Kopieren Sie aus...	Fügen Sie ein in...
     CROWD/client/xfire*.jar	JIVEFORUMS/WEB-INF/lib/

3. Überprüfen Sie die JIVEFORUMS/WEB-INF/lib Ordner und löschen Sie vorhandene Duplikate der JAR-Dateien. Duplizierte JAR-Dateien repräsentieren gemeinsame Libraries, die vom Crowd Client und Jive Forums verwendet werden.

4. Editieren Sie die JIVEFORUMS/WEB-INF/classes/crowd.properties. Ändern Sie die folgenden Einstellungen:

   Schlüssel	Wert
   application.name	jiveforums
   application.password	Definieren Sie ein Passwort.

   Der Name und das Passwort müssen mit selbigen übereinstimmend sein, die Sie bei der Definierung der Applikation in Crowd festgelegt haben (sehen Sie Schritt 1 oben).

Lesen Sie mehr über die crowd.properties Datei.

2.2 Konfigurieren Sie Jive Forums für die Verwendung des Crowd Authenticators

Crowd ist nun für die Bereitstellung der Authentifizierungsdienste für Jive eingerichtet. Nun muss Jive für die Verwendung von Crowds Authenticator eingerichtet werden. Es gibt mehrere Möglichkeiten das zu tun. Die benutzerfreundlichste Methode ist unten aufgeführt:

1. Editieren Sie in Ihrem jiveHome Verzeichnis eine Datei mit dem Namen jive-startup.xml. Modifizieren Sie den <setup> Knoten so, dass er falsch ist:

   <jive>
     <!-- When setup is false, you can access the setup tool. -->
     <setup>false</setup>
     ...
     <!-- Allow SSO login for admins -->
     <admin>
       <tryAlternativeLogin>true</tryAlternativeLogin>
     </admin>
   </jive>

   Wie der XML-Kommentar es schon sagt, lässt uns dies das Jive-Setup erneut starten.

2. Starten Sie Jive Forums neu, sodass diese Änderungen übernommen werden.
3. Öffnen Sie die Jive Forums Site mit einem Web-Browser - üblicherweise unter dem /jiveforums Kontext-Root. Jive wird das "Jive Forums Setup" starten.
4. Auf der "Install Checklist" Seite klicken Sie auf "Continue", um durch den Setup-Prozess zu navigieren.
5. Auf der "Datasource Settings" Seite geben Sie Ihre Datenbank Konfigurationsdetails erneut ein und klicken anschließend auf "Continue".
6. Auf der "User System" Seite wählen Sie das "Custom" Authentifizierungssystem aus und klicken danach auf "Continue".
   
   
   

7. Sie sollten auf der "Custom User System" Seite sein. Geben Sie die folgenden Details ein, die Crowd als benutzerdefinierten Authenticator definieren:
   
   
   UserManagerImplementierung:

   com.atlassian.crowd.integration.jive.CrowdUserManager

   GroupManager Implementierung:

   Wenn Sie möchten, dass Crowd Ihre Benutzergruppen verwaltet, dann fügen Sie den folgenden Group-Manager hinzu:

   com.atlassian.crowd.integration.jive.CrowdGroupManager

   Sie können dieses Feld ruhigen Gewissens leer lassen, wenn Sie nicht möchten, dass Crowd Ihre Gruppen verwaltet.

   
   AuthFactory Implementierung:

   com.atlassian.crowd.integration.jive.CrowdAuthFactory

   Klicken Sie auf "Continue".

   Wenn Sie an diesem Punkt Fehlermeldungen bekommen, dann ist es sehr wahrscheinlich, dass ein Classpath-Problem vorliegt (z. B. wurden die Crowd Client-Libraries von Jive nicht richtig geladen). Bitte lesen Sie die Dokumentation über die Crowd Client-Libraries (auf Englisch), um das Problem zu identifizieren.

8. Auf der "Email Settings" Seite geben Sie Ihre E-Mail Konfigurationsdetails erneut ein und klicken danach auf "Continue".

9. Auf der "Admin Account Setup" Seite geben Sie keine Details ein. Klicken Sie auf "Skip this step".

   Warnung

   Standardmäßig ist der Administrator für Jive Forums der Benutzeradmin. Dieser Benutzer muss in Ihrem zugewiesenen Verzeichnis (d. h. dem Jive Forums Verzeichnis) in Crowd existieren. Ohne diesen Benutzer werden Sie nicht in der Lage sein auf die Administrationskonsole von Jive Forums zuzugreifen.

10. Bouncen Sie den Server und testen Sie, ob Crowd die Benutzer für Jive authentifiziert. Sie können das tun, indem Sie Benutzer über die Crowd Administrationskonsole erstellen und verifizieren, dass sie in der Lage sind sich in Jive Forums einzuloggen.

    Jive Forums Dokumentation

    Für weitere Informationen zur Jive Forums Authentifizierungs-Integration, lesen Sie bitte die Jive Forums Dokumentation (auf Englisch).

    Sehen Sie sich die Jive SSO Seite für mehr Details zur Jive SSO-Integration und den dazugehörigen Use-Cases an.