Crowd bietet eine Vielzahl von Modulen an, mit denen Sie Crowd für die Authentifizierung von HTTP Basic Authentication Anfragen an einem Apache Web Server konfigurieren.

Die folgenden Features werden unterstützt:

• Authentifizierung: Benutzen Sie Crowd um die Ressourcen auf Ihrer Website mit einem Passwort zu schützen.
• Autorisierung: Konfigurieren Sie Website-Locations, um den Zugriff auf bestimmte Crowd-Gruppen oder -Benutzer zu beschränken.

Diese Version des Konnektors (3.0) wird von Linux unterstützt. Bitte lesen Sie für Details und Alternativen die Seite über das Auswählen des richtigen Apache Konnektors für Ihr Betriebssystem.

Beachten Sie: Diese Instruktionen beziehen sich auf Crowd 2.1 und neuer. Etwas Wissen über UNIX-Systeme und die Apache-Konfiguration wird vorausgesetzt.

Grundvoraussetzungen

Downloaden und konfigurieren Sie Crowd. Beziehen Sie sich für detaillierte Informationen darüber auf die Crowd Installationsanleitung.

Schritt 1: Deaktivieren Sie vorherigen Versionen des Crowd-Apache Konnektors

Wenn Sie von einer älteren Version des Konnektors upgraden, dann müssen Sie die ältere Version deaktivieren, bevor Sie weiter fortfahren.

Schritt 2: Konfigurieren Sie Crowd für die Kommunikation mit Apache

Crowd muss darüber bescheid wissen, dass Apache Authentifizierungs-Anfragen an Crowd stellen wird. Sie müssen also folgendes tun:

1. Definieren Sie Apache als Crowd-verbundene Applikation in Crowd.
2. Fügen Sie die Verzeichnisse hinzu und machen Sie sie für Apache sichtbar.
3. Fügen Sie die Gruppen hinzu, denen es erlaubt ist sich mit Apache zu authentifizieren und mappen Sie sie.

Schritt 3: Wählen Sie den korrekten Apache Konnektor für Ihr Betriebssystem aus

Der Installationsvorgang für den Apache und den Crowd Apache Konnektor variieren je nach Ihrem Betriebssystem. Finden Sie weiter unten die Links zu den passenden Installationsanleitungen für Ihr Betriebssystem. Wenn Sie bisher noch kein Betriebssystem ausgewählt haben, dann ist eine der Linux-Varianten empfehlenswert, denn sie sind am einfachsten in der Konfiguration.

Die 2.x Version des Crowd Apache Konnektors unterstützt erweiterte Features, wie verschachtelte Gruppen und das Single Sign-On, aber sie wird im Moment nur von bestimmten Betriebssystemen unterstützt.

Betriebssystem	Crowd Apache Konnektor 2.0	Crowd Apache Konnektor 1.4
Red Hat Enterprise Linux	6.0 5.5 Installationsanleitung.	Installationsanleitung für andere OS-Versionen (auf Englisch).
CentOS Linux	5.5 Installationsanleitung.	Installationsanleitung für andere OS-Versionen (auf Englisch).
Ubuntu Linux	11.04 10.10 10.04 Installationsanleitung.	Installationsanleitung für andere OS-Versionen (auf Englisch).
Debian	6.0 Installationsanleitung.	Installationsanleitung für andere OS-Versionen (auf Englisch).
Andere UNIX-ähnliche Systeme	*Nicht unterstützt.	Installationsanleitung (auf Englisch).
Windows	*Nicht unterstützt.	Installationsanleitung (auf Englisch).

*Der Crowd-Apache Konnektor 2.0 Quellcode ist mit den Instruktionen für das Kompilieren vom Quellcode verfügbar.

Schritt 4: Konfiguration der Authentifizierung

In diesem Abschnitt werden Sie in Apache einstellen, dass Crowd für die Authentifizierungs-Anfragen einer bestimmte Location verwendet werden soll. Editieren Sie die Apache Config-Datei und fügen Sie die folgenden Befehle zu einem <Location> oder <Directory> Abschnitt hinzu.

<Directory "/var/mysite/">
.
.
.
  AuthName "Atlassian Crowd"
  AuthType Basic
  AuthBasicProvider crowd

  CrowdAppName myappname
  CrowdAppPassword mypassword
  CrowdURL http://localhost:8095/crowd/

  Require valid-user
.
.
.
</Directory>

Das ist die mindeste Konfiguration, die für eine Passwort-geschützte Location mit Crowd benötigt wird.

Die folgenden Konfigurationsbefehle sind optional und können für die weitere, benutzerdefinierte Konfiguration verwendet werden:

Für weitere Details zu der Apache-Konfiguration lesen Sie bitte die Apache Dokumentation (auf Englisch).

Schritt 5: Konfiguration der Autorisierung

Wenn Sie den Zugriff auf ein bestimmtes Apache <Directory> oder eine <Location> einschränken möchten, sodass nur ein Teil der Crowd-Benutzer und/oder -Gruppen die Berechtigungen haben, dann fügen Sie die folgenden Zeilen zu Ihrer Konfiguration hinzu:

<Location URL_to_restrict>
  .
  .
  .
  Require user johnh kevinr
  Require group developers crowd-administrators
  AuthzUserAuthoritative Off
  .
  .
  .
</Location>

Wenn Sie die "Require user" und "Require group" Direktiven in Kombination verwenden, dann müssen Sie die folgende Einstellung hinzufügen:

Wenn Sie zusätzlich zum Crowd Apache Konnektor noch weitere Autorisierungs-Anbieter konfiguriert haben, dann müssen Sie die folgenden, optionalen Einstellungen hinzufügen:

Schritt 6: Konfiguration von Subversion

Wenn Sie Subversion unter Apache verwenden, dann erlaubt Ihnen der Crowd Subversion Konnektor ein Subversion-Verzeichnis mit einem Passwort zu schützen und außerdem den Zugriff nach Gruppen oder Benutzer zu steuern.

Befolgen Sie den Instruktionen auf der Seite Crowd in Subversion integrieren.

Hinweise

• Normalerweise ist nur eine der Require user oder Require group Befehle für eine bestimmte Location notwendig. Sie können jedoch beide definieren. Wenn Sie das tun, dann wird der Zugriff gewährt, wenn einer der beiden Befehle erfüllt wird.
• Wenn die CrowdCacheMaxEntries Einstellung fehlt oder der Wert hier höher als 0 beträgt, dann werden die Anfragen an Crowd zwischengespeichert, um die Performance zu steigern. Das bedeutet, dass Änderungen an Passwörtern, Gruppenzugehörigkeiten und abgelaufene Sitzungen in Crowd nicht sofort beim Benutzerzugriff wiedergegeben werden.

• Obwohl der Apache Connector nicht die Digest-Authentifizierung unterstützt, kann die Verbindung zu Crowd mit https gesichert werden, um die SOAP-Verbindungen herzustellen.

  CrowdURL https://localhost:8095/crowd/

  Für Informationen darüber wie Sie die Crowd-Verbindungen sichern, lesen Sie bitte die Dokumentation über das Konfigurieren von SSL für Crowd.

• Wenn Sie Crowd 2.0 oder früher verwenden, dann müssen Sie den Instruktionen für Crowd 2.0 befolgen (auf Englisch).