Subversion的配置权限文件authz配置的常见问题及解答

一. 安装

　　yum install subversion

　　二. 配置

　　本系统采用为每个项目单独建一版本库的策略。配置文件，密码文件，访问控制文件等都放在版本库的conf 目录下。

　　所以每次开始一个新项目都必须新建一个版本库，并重新配置各配置文件。还有很重要的一条，要求各组员重新配置客户端，包括服务器版本库路径，本地路径等信息。

　　1. 建立版本库目录( 可建立多个，新建库后以下各项都需重新配置。注意区别安装目录与版本库目录, 以下讲的都是版本库目录)

　　mkdir –p /home/svn/repos

　　# 类似可以创建 mkdir –p /home/svn/repos2 /home/svn/repos3

　　2. 建立svn 版本库( 与上面目录对应)

svnadmin create /home/svn/repos

错误
[root@server local]# svn
svn: warning: cannot set LC_CTYPE locale
svn: warning: environment variable LANG is en_US.UTF-8
svn: warning: please check that your locale name is correct
Type 'svn help' for usage.

解决方案
echo "export LC_ALL=C" >> /etc/profile
export LC_ALL=C

　　执行此命令后svn 自动在repos 目录下添加必须的配置文件.

　　注意: 版本库不同于一般的文件夹, 直接在操作系统上新建文件无法被SVN 识别, 必须使用import 等命令将文件导入版本库.

　　此为svn 内部指令，create 用于新建版本库。请使用svn help 查看详细说明。

　　3. 修改版本库配置文件

　　vi /home/svn/repos/conf/svnserve.conf

　　各参数功能在配置文件的注释中有说明, 此处配置如下:

　　[general]

　　anon-access = none # 使非授权用户无法访问

　　auth-access = write # 使授权用户有写权限

　　password-db = passwd # 指明密码文件路径

　　authz-db = authz # 访问控制文件

　　realm = /home/svn/repos # 认证命名空间，subversion 会在认证提示里显示，并且作为凭证缓存的关键字。

　　其它采用默认配置. 各语句都必须顶格写, 左侧不能留空格, 否则会出错.

　　4. 配置用户

　　vi /home/svn/repos/conf/passwd

　　输入以下内容：

　　[users]

　　username1 = password1

　　username2 = password2

　　可以添加多个，此为用户名密码对。

　　5. 配置权限

　　vi /home/svn/repos/conf/authz

　　此配置文件设置各用户的授权。

　　包括只读r ，读写rw 。没有列出的用户，则不允许访问。还可以对用户分组，具体请参考svn 手册，以下是简单例子：

　　# 对仓库repos 根目录权限设置

　　[repos:/]

　　user1 = rw

　　user2 = r

　　6. 使用import 导入文件

　　新建好的版本库是空的，需要导入工作目录。

　　// 这条语句将把路径/home/user/code 下找到的文件导入到你创建的 Subversion 仓库中去

　　svn import /home/code/ file:///home/svn/repos/ -m “ 注释”

三. 启动服务

参见: 权限文件authz 配置的常见问题及解答.docx

　　svnserve -d -r /home/svn/

　　svn checkout svn://ip/repos

　　输入用户名密码即可。

#################################################################################

svnserve 是SVN 自带的一个轻型服务器，客户端通过使用以svn:// 或svn+ssh:// 为前缀的URL 来访问svnserve 服务器，实现远程访问SVN 版本库。

svnserve 可以通过配置文件来设置用户和口令，以及按路径控制版本库访问权限。本文详细分析了svnserve 配置文件格式，并说明如何使用配置文件控制版本库访问权限。

本文介绍SVN 的版本为1.4.4 。

1) svnserve 配置文件概述

svnserve 配置文件通常由以下3 个文本文件组成：
svn 服务配置文件，该文件版本库目录的conf 目录下，文件名为svnserve.conf 。
用户名口令文件，该文件名在文件svnserve.conf 中指定，缺省为同目录下的passwd 。
权限配置文件，该文件名也在文件svnserve.conf 中指定，缺省为同目录下的authz 。

2) svn 服务配置文件

svn 服务配置文件为版本库目录中的文件conf/svnserve.conf 。该文件仅由一个[general] 配置段组成。

[general] 配置段中配置行格式如下：
< 配置项> = < 值>

配置项分为以下5 项：

anon-access 控制非鉴权用户访问版本库的权限。取值范围为”write” 、”read” 和”none” 。
即”write” 为可读可写，”read” 为只读，”none” 表示无访问权限。
缺省值：read

auth-access 控制鉴权用户访问版本库的权限。取值范围为”write” 、”read” 和”none” 。
即”write” 为可读可写，”read” 为只读，”none” 表示无访问权限。
缺省值：write

password-db 指定用户名口令文件名。除非指定绝对路径，否则文件位置为相对conf
目录的相对路径。
缺省值：passwd

authz-db 指定权限配置文件名，通过该文件可以实现以路径为基础的访问控制。
除非指定绝对路径，否则文件位置为相对conf 目录的相对路径。
缺省值：authz

realm 指定版本库的认证域，即在登录时提示的认证域名称。若两个版本库的
认证域相同，建议使用相同的用户名口令数据文件。
缺省值：一个UUID(Universal Unique IDentifier ，全局唯一标示) 。

【说明】版本库认证域
在使用svn 客户端访问svnserve 服务器时，若需要用户登录，则提示信息如下：
[root@test root]# svn list svn://192.168.3.45/test
Authentication realm: 0d545a49-4038-0410-99b4-c66dc73f754e
Password for ‘root’:
在上述第2 行”Authentication realm: “ 之后显示的字符串为认证域名称。如果在配置文件中为设定认证域，就会提示一个UUID ，如上述所示。
如果在配置文件中指定了如下配置项：
realm = test
将在svn 客户端提示如下：
[root@test root]# svn list svn://192.168.3.45/test
Authentication realm: test
Password for ‘root’:

例1 ：svn 服务配置文件conf/svnserve.conf 的内容如下：
[general]
anon-access = none
auth-access = write
password-db = ../../conf/passwd
authz-db = ../../conf/authz
realm = test

上述配置文件设定非鉴权用户无权限访问该版本库；鉴权用户可对版本库进行读写；用户名口令文件为相对版本库conf 目录的文件”../.. /conf /passwd” ；权限配置文件为相对版本库conf 目录的文件”../../conf/authz” ；版本库的认证域为”test” 。

3) 用户名口令文件

用户名口令文件由svnserve.conf 的配置项password-db 指定，缺省为conf 目录中的passwd 。该文件仅由一个 [users] 配置段组成。

[users] 配置段的配置行格式如下：
< 用户名> = < 口令>
注意：配置行中的口令为未经过任何处理的明文。

例2 ：用户名口令文件conf/passwd 的内容如下：
[users]
admin = admin
thinker = 123456

该文件中配置了两个用户，用户名分别为”admin” 和”thinker” 。其中”admin” 用户的口令为”admin” ；”thinker” 用户的口令为”123456″ 。

4) 权限配置文件

权限配置文件由svnserve.conf 的配置项authz-db 指定，缺省为conf 目录中的authz 。该配置文件由一个[groups] 配置段和若干个版本库路径权限段组成。

[groups] 配置段中配置行格式如下：
< 用户组> = < 用户列表>
用户列表由若干个用户组或用户名构成，用户组或用户名之间用逗号”,” 分隔，引用用户组时要使用前缀”@”( 如：引用用户组”all” 要使用字符串”@all”) 。

版本库路径权限段的段名格式如下：
[< 版本库名>:< 路径>]
如版本库abc 路径/tmp 的版本库路径权限段的段名为”[abc:/tmp]“ 。
可省略段名中的版本库名。若省略版本库名，则该版本库路径权限段对所有版本库中相同路径的访问控制都有效。如：段名为”[/tmp]“ 的版本库路径权限段设置了所有引用该权限配置文件的版本库中目录”/tmp” 的访问权限。

版本库路径权限段中配置行格式有如下三种：
< 用户名> = < 权限>
< 用户组> = < 权限>
* = < 权限>
其中，”*” 表示任何用户；权限的取值范围为” 、’r' 和’rw’ ，” 表示对该版本库路径无任何权限，’r' 表示具有只读权限，’rw’ 表示有读写权限。
注意：每行配置只能配置单个用户或用户组。

例3 ：权限配置文件conf/authz 的内容如下：
[groups]
g_admin = admin,thinker

[admintools:/]
@g_admin = rw
* =

[test:/home/thinker]
thinker = rw
* = r

在上述配置文件中，定义了一个用户组”g_admin” ，该用户组包含用户”admin” 和”thinker” 。然后定义了2 个版本库路径权限段。其中，版本库”admintools” 只有用户组”g_admin” 可读写，其他用户无任何权限；版本库”test” 中路径”/home /thinker” 只有用户”thinker” 有读写权限，其他用户只有可读权限。

5) 总结

在本文中，详细介绍了svnserve 程序的3 个配置文件。SVN 管理员可以通过这3 个配置文件设置svnserve 服务的用户名口令，以及对版本库路径的访问权限。这些配置文件保存后就立即生效，不需要重启svnserve 服务。
需要强调的是本文介绍的配置文件只对svnserve 服务有效，即客户端通过前缀为svn:// 或svn+ssh:// 的URL 访问版本库有效，而对通过前缀http:// 、https:// 或file:/// 的URL 无效。

svnserve.conf:

### This file controls the configuration of the svnserve daemon, if you
### use it to allow access to this repository.  (If you only allow
### access through http: and/or file: URLs, then this file is
### irrelevant.)

### Visit http://subversion.tigris.org/ for more information.

[general]
### These options control access to the repository for unauthenticated
### and authenticated users.  Valid values are "write", "read",
### and "none".  The sample settings below are the defaults.
anon-access = none
auth-access = write
### The password-db option controls the location of the password
### database file.  Unless you specify a path starting with a /,
### the file's location is relative to the conf directory.
### Uncomment the line below to use the default password file.
password-db = passwd
### The authz-db option controls the location of the authorization
### rules for path-based access control.  Unless you specify a path
### starting with a /, the file's location is relative to the conf
### directory.  If you don't specify an authz-db, no path-based access
### control is done.
### Uncomment the line below to use the default authorization file.
authz-db = authz
### This option specifies the authentication realm of the repository.
### If two repositories have the same authentication realm, they should
### have the same password database, and vice versa.  The default realm
### is repository's uuid.
realm = /home/svnrepos/apple

authz

### This file is an example authorization file for svnserve.
### Its format is identical to that of mod_authz_svn authorization
### files.
### As shown below each section defines authorizations for the path and
### (optional) repository specified by the section name.
### The authorizations follow. An authorization line can refer to a
### single user, to a group of users defined in a special [groups]
### section, or to anyone using the '*' wildcard.  Each definition can
### grant read ('r') access, read-write ('rw') access, or no access
### ('').

[groups]
apple = harry,edison,simon

# [/foo/bar]
# harry = rw
# * =

[apple:/]
@apple = rw

passwd:

### This file is an example password file for svnserve.
### Its format is similar to that of svnserve.conf. As shown in the
### example below it contains one section labelled [users].
### The name and password for each user follow, one account per line.

[users]
simon = simon 
edison = edison

见附件

Subversion的配置 权限文件authz配置的常见问题及解答

猜你喜欢

Subversion的配置权限文件authz配置的常见问题及解答