Nächste Seite: sysctl Kernelkonfiguration Aufwärts: eisfair-Dokumentation Vorherige Seite: Das Stunnel-Paket Inhalt Index
Subversion ist der Nachfolger des bekannten CVS Tools. In ihm wurden viele der von dort bekannten Nachteile behoben. Im vorliegenden Eisfair-Paket sind sowohl die Client-, als auch die Serverkomponenten von Subversion enthalten. Damit kann man auf einfache Weise sowohl einen eigenen Subversion-Server realisieren, als auch auf Datenbestände entfernter Rechner zugreifen.
Wird Subversion als Server eingesetzt, so können mehrere unterschiedliche Datenbestände verwaltet werden. Jedes dieser Repositories verfügt dabei über seine eigene Benutzer- und Kennwortliste. Ist zusätzlich zu Subversion der Web-Server Apache2 auf dem selben Rechner installiert, dann ist neben dem Subversion-eigenen Protokoll (svn://...) zusätzlich der Zugriff über HTTP/WebDAV (http://...) möglich.
Alle lokalen Anwender, die über die Zugriffsmethode ”file://” auf ein lokales Repository zugreifen möchten, müssen in der Benutzergruppe ”svn” Mitglied sein. Anderenfalls ist das Zurückschreiben von Änderungen nicht möglich.
Für die Zugriffsmethode ”svn+ssh://” ist auf dem entfernten Rechner für den jeweiligen Anwender ein ssh Zugang erforderlich, was i.d.R ein mit dem Benutzernamen identisches Anmeldekonto voraussetzt. Damit nicht bei jedem Zugriff ein Kennwort eingegeben werden muss, empfiehlt es sich zudem, auf dem Zielsystem einen Anmeldeschlüssel (Preshared Key) zu hinterlegen.
Bei der Wahl des Speicherortes für Repositories ist zu beachten, dass diese nur auf lokalen Datenträgern mit ext2 oder ext3 Dateisystemen liegen dürfen. Niemals sollte ein NFS-Laufwerk als Speicherort verwendet werden.
Gültige Werte: ”yes”, ”no”
Gültige Werte: ”yes”, ”no”
Wird der Wert angegeben, dann ist in der URL beim Zugriff auf eines der Repositories lediglich der Pfad anzugeben der relativ zum Wurzelverzeichnis liegt. Anderenfalls ist eine absolute Pfadangabe erforderlich.
Beispiel: ”/var/lib”
Gültige Werte: ”yes”, ”no”
Falls ”basic” verwendet wird, werden die Anmeldedaten (Benutzername und/oder Kennwort) als einfach kodierte und leicht zu entschlüsselnde Base64-kodierte Zeichenkette über das Netzwerk übertragen.
Wird statt dessen ”digest” verwendet, werden die Anmeldedaten durch eine hash-Funktion verschlüsselt bevor sie übertragen werden. Zudem wird sichergestellt, dass ein Angreifer den Hash-Wert nicht abfangen und wiederverwenden kann.
Damit stellt ”digest” gegenüber ”basic” eine erheblich sicherere Authentifizierungsmethode dar und sollte wenn möglich verwendet werden. Solange der Client die Methode korrekt unterstützt bemerkt der Anwender keinen Unterschied im Vergleich zu ”basic”.
Gültige Werte: ”basic”, ”digest”
Um getrennte Userlisten für jedes Repository zu haben, wie es aus früheren Versionen dieses Pakets bekannt war, muss eine einzelne Zugriffsliste für jedes Repository angelegt werden. Diese wird dann dem jeweiligen Repo zugeordnet. Um statt dessen eine globale Liste von Anwendern zu erhalten, die gleichermaßen auf alle Repositories zugreifen dürfen, kann eine einzelne Zugriffsliste angelegt werden, die dann allen Repositories zugewiesen wird. Da es möglich ist, einem Repository mehrere Zugriffsliste zuzuordnen, können beide Zugriffsmodelle (global und lokal) kombiniert werden.
Beispiel: ”3”
Beispiel: ”DEVELOPERS”
Beispiel: ”10”
Um den Anwender dauerhaft aus der Liste zu entfernen, wird er an das Ende der Liste verschoben (F3). Anschließend wird die Länge der Liste um ein Element reduziert.
Gültige Werte: ”yes”, ”no”
Beispiel: ”hans”
Beispiel: ”geheim”
Bitte beachten: Beim Zugriff über den Subversion Server ”svnserve” wird die URL bei nur einem Repository aus dem Namen des Servers ohne den absoluten Pfad zum Repository gebildet. Bei mehreren Repositories dagegen muss der absolute Pfad hinter dem Servernamen angegeben werden. Beispiele:
svn://svn.myhome.local = URL bei einem Repository
svn://svn.myhome.local/var/lib/svn1 = URL bei mehreren Repositories
Beispiel: ”2”
Beispiel: ”/var/lib/svn”
http://yourserver/svn/$SVN_REPOS_x_WEBNAME
Diese Einstellung ist jedoch wirkungslos, solange der Web-Server 'apache2' nicht auf diesem Rechner installiert ist.
Gültige Werte: ”yes”, ”no”
http://yourserver/svn/$SVN_REPOS_x_WEBNAME
Diese Einstellung ist jedoch wirkungslos, solange der Web-Server 'apache2' nicht auf diesem Rechner installiert ist.
Gültige Werte: ”yes”, ”no”
Gültige Werte: ”none”, ”read”, ”write”
Gültige Werte: ”none”, ”read”, ”write”
Es ist allerdings zu beachten, dass ACL Namen nicht nach Groß-Kleinschreibung unterschieden werden. Das bedeutet, dass ”Gobal”, ”GLOBAL” und ”global” alle die selbe Zugriffsliste angeben.
Beispiel: ”DEVELOPERS ADMINS”
Gültige Werte: ”yes”, ”no”
Siehe dazu auch das Kapitel ”Zugriffssteuerung auf Verzeichnisebene”
Gültige Werte: ”yes”, ”no”
Siehe dazu auch das Kapitel ”Zugriffssteuerung auf Verzeichnisebene”
Beispiel: ”2”
Siehe dazu auch das Kapitel ”Zugriffssteuerung auf Verzeichnisebene”
Beispiel: ”/my/repository/path”
Siehe dazu auch das Kapitel ”Zugriffssteuerung auf Verzeichnisebene”
Beispiel: ”user1=r user2=rw user3=”
Beispiel:
”30 0 * * *” –> täglich um 0:30 Uhr
”0 1 */2 * *” –> Jeden zweiten Tag um 1:00 Uhr
Standard: ”/var/lib/svn_backup”
Beispiel: ”4”
Beispiel: ”mount -t udffs /dev/sr0 /mnt”
Beispiel: ”umount /mnt”
Hinweis: Die Benachrichtigung funktioniert nur dann, wenn das E-mail Paket installiert ist.
Beispiel: ”admin@localhost”
Zu beachten ist, dass die Zugriffskontrolle auf Verzeichnisebene nur dann wirksam ist, wenn der Zugriff auf das Repository entweder über WebDAV oder oder über den svnserve-Dienst erfolgt. Wird statt dessen über die Zugriffsmethode ”file://” auf ein Repository zugegriffen gelten die Rechte auf Verzeichnisebene nicht.
In der eisfair-Konfiguration wird zunächst das Verzeichnis angegeben, auf das Rechte vergeben werden sollen. Dann wird eine Liste von Anwendern genannt, denen über den Zuweisungsoperator entweder Leserechte (r) oder Schreibrechte (rw) eingeräumt werden. Wird hinter dem Gleichheitszeichen nichts weiter angegeben, bedeutet dies den Rechteentzug für den entsprechenden Anwender. Beispiel:
SVN_REPOS_x_DIR_x_PATH=”/my/repository/path”
SVN_REPOS_x_DIR_x_PERM=”user1=r user2=rw user3=”
Zu beachten ist, dass einmal vergebene Rechte in unveränderter Form für alle Unterverzeichnisse gelten, solange sie nicht explizit durch eine weitere Regel überschrieben werden. Wurden keine Angaben gemacht, hat dagegen kein Anwender irgendein Recht zum Zugriff auf die Repository-Dateien. Aus diesem Grund kann es sinnvoll sein, zunächst für die Wurzel des gesamten Verzeichnisbaums ein Leserecht für alle Anwender einzurichten und dieses bei Bedarf für einzelne Unterverzeichnisse und Anwender einzuschränken. Der Asterisk kann dabei als Platzhalter für alle Anwender verwendet werden. Beispiel:
SVN_REPOS_1_DIR_1_PATH=”/”
SVN_REPOS_1_DIR_1_PERM=”*=r”
SVN_REPOS_2_DIR_2_PATH=”/a/secret/directory”
SVN_REPOS_2_DIR_2_PERM=”user1=”
Die globalen Anwenderlisten (ACLs) können verwendet werden um eine Gruppe von Anwendern gleichermassen anzusprechen. Dabei wird der ACL-Name mit einem führenden ”@” versehen um ihn als Gruppe zu kennzeichnen. Beispiel:
SVN_REPOS_x_DIR_x_PATH=”/my/repository/path”
SVN_REPOS_x_DIR_x_PERM=”@GLOBAL=rw”
Zu erwähnen ist, dass der Wert der Option ”SVN_REPOS_x_ANON_ACCESS” einen signifikaten Einfluss auf die Funktion der Zugriffsrechte auf Verzeichnisbene hat. Solange eine Operation als anonymer Nutzer vorgenommen werden kann greifen die Rechte nicht. Erst wenn eine Operation einen authentifizierten Benutzer erfordert, kann an diesen Benutzer eine Rechtevergabe erfolgen. Ist der Wert der Option ”none” ist für jede Operation eine Authentifizierung erforderlich - wodurch auf Verzeichnisebene sowohl die Lese- als auch die Schreibrechte effektiv beeinfluss werden können. Wurde der Wert dagegen auf ”read” gesetzt, werden Einschränkungen von Leserechten auf der Verzeichnisebene nicht wirksam.
svn checkout file:///var/svn
svn checkout svn://user@server
svn checkout http://server/svn/repo1
Werden mehrer Repositories verwendet, so muss der gesamte Pfad angegeben werden:
svn checkout svn://user@server/var/svn
svn checkout svn://user@server/var/svn2
Lokale Änderungen kann man sich wie folgt ansehen:
svn status
und zwischenzeitliche Änderungen auf dem Server mit:
svn status -u
Um lokale Änderungen ins Repository zurückzuschreiben, benutzt man:
svn commit -m ”set comment” *
svn add <objekt>
Sogenannte Binärdateien werden dabei automatisch erkannt.