SVN分级授权部署手册 --Windows用户认证
http://wenku.baidu.com/view/a0a16ea34028915f804dc2f8.html
第一章 概述
当VisualSVN 2.7采用Windows用户认证或Windows域认证时,可以使用SVN分级授权工具对VisualSVN的授权功能进行扩展,实现SVN库的创建、分库的分级授权、SVN用户密码修改等。本手册主要描述Windows用户认证的配置方法,关于采用Windows域认证的配置方法请参考《SVN分级授权工具部署手册--Windows域认证》。
第二章 安装部署
2.1 Windows操作系统
本手册环境为Windows 2008 SP1 R2版本,具体安装过程略。需要特别注意的是Windows本地组策略中的用户策略设置不当会影响到通过SVN分级授权工具进行用户管理,建议按照下面的策略设置:运行gpedit.msc启动本地组策略编辑器,把密码复杂度等策略设置好后,执行gpupdate /force命令使策略立即生效。
2.2 SVN服务软件安装
低于2.6版本的VisualSVN无法使用SVN分级授权工具,本手册环境为VisualSVN Server2.7.5。采用Windows用户认证和Windows域认证需要购买VisualSVN授权(本文仅仅为了说明分级授权工具的安装部署,因此SVN Server采用了特殊方法使之支持Windows用户认证)。
运行VisualSVN Server2.7.5.msi,采用缺省设置安装:
停止VisualSVN Server服务并退出管理控制台。
采用特殊方法使之支持Windows用户认证,正式生产环境请购买商业版授权。
把VisualSVN的认证方式更改为“Use Windows Authentication”。
启动VisualSVN Server服务。
2.3 SVN分级授权工具安装
2.3.1 安装C++运行库
安装vcredist2010_x86.exe和vcredist2010_x64.exe,否则无法显示SVN仓库的结构树:
2.3.2 部署数据库、COM+和WebSerivce
本分级授权工具支持Oracle、SQL Server、Sybase、MySQL、PostgreSQL六种数据库,本手册采用SQL Server桌面数据库进行部署,使用分级授权自带的配置工具自动安装数据库和部署应用。分级授权工具相关软件如下:
点击PMagicConfig.exe开始安装部署:
自动部署支持SQL Server2008数据库,其余数据库需要手工安装并导入SQL脚本。微软SQL Server 2008桌面版免费,本文采用此方案。
开始自动部署SQL Server 2008桌面版数据库。
SQL Server 2008桌面版数据库部署中不需要认为干预,等待安装完成即可。
自动发布COM+,安装COM+过程中会自动新建一个MagicLtdUser的Windows用户。
部署WebServer服务前需要安装Apache,自动部署会启动Apache的安装,只需要点击下一步缺省安装就可以了。
这儿可以随便输入一些值。
检测到端口冲突(因为SVN服务已经用到了80端口,Apache缺省也使用80),退出即可,部署工具在后面会自动调整可用apache的端口。
自动部署程序调整apache端口后启动apache服务。
完成基本部署并询问是否运行程序。
SVN分级授权工具为绿色软件(向用户发布参考2.6节),第一次运行时会自动下载并配置19个环境支撑文件。
输入用户名和密码后登录系统。缺省的用户登录认证方式为DB认证,稍后需要改成WINDOWS认证。
svnuser1具有分级授权、SVN仓库管理、组织维护、角色维护、授权管理和基础代码管理的权限(调整权限参考3.3节),因此他登录后看到的程序界面如下:
2.3.3 安装同步服务
安装MagicService服务,此服务可以实现端口转发、定时从外部系统同步用户到SVN分级授权工具,定时从Active Directory刷新SVN分级授权工具中用户的SID、定时从本地Windows刷新SVN分级授权工具中用户的SID等功能。本文只用到定时从本地Windows刷新SVN分级授权工具中用户的SID这一个功能。
右键点击Windows任务栏应用程序托盘区域的红***标,选择服务控制、启动服务。
程序检测到服务未安装,将询问是否安装服务,点击确定:
在端口映射区域点击右键,选择WEB管理控制台用户管理修改admin的缺省密码:
这个用户名和密码是端口映射WEB管理控制台的的账号,同时这个密码可以供SVN管理员模拟用户身份登录SVN分级授权管理工具,以测试用户是否可以正常使用SVN分级授权管理工具。
2.3.4 更改登录认证方式
更改SVN分级授权的登录认证方式为Windows用户认证。
认证方式改为WINDOWS后,主机名会自动带出来,选择允许用户同步后点击应用设置。
2.3.5 SVN分级授权参数配置
参数说明如下:
SYSUSERNAMES:定时同步程序会根据SVN分级授权工具数据库中不存在的用户删除WINDOWS用户,但SYSUSERNAMES定义的用户除外。
REPO_ROOT_DIR:SVN仓库根目录,缺省为D:\SVNROOT\Repositories,一般不用更改。
REPO_BASE_URL:必须修改,SVN分级授权管理中拷贝URL地址时就根据此参数组成完整的地址,本文环境中需要改成:http://192.168.43.253:80。
ENABLEWINDOWSUSERSYNC:允许用本地Windows账号刷新数据库的SID字段,设置为TRUE。
ENABLEVSSUSERSYNC:是否允许从外部数据源同步用户到VSS(SourceAnywhere),设置为FALSE。
ENABLESVNUSERSYNC:是否允许从外部数据源同步用户数据到SVN,设置为FALSE。
IS_NW:特殊标记请不要修改,设置为FALSE。
2.4 发布分级授权工具
把下图中的三个文件发给需要使用SVN分级授权管理的用户即可。
建议放到一个网站下载,下图是利用SVN的apache发布的下载服务:
访问http://192.168.43.253/下载SVN分级授权管理工具客户端程序SvnManage.zip
第三章 基本操作
为了简化初始化部门和用户的操作,工具提供了批量导入组织机构的功能,按照如下格式整理成csv格式文件并命名为Sync_Magic_Org.csv放在C:\位置即可导入。第一行为列名称,第二行开始为用户、部门对应关系(目前版本只支持一级部门)。
点击组织机构的根节点,点击右键选择“同步组织机构信息(导入)”菜单。
3.2 超级管理员SVNADMIN
SVNADMIN用户是SVN的超级管理员,他可以做一般用户无法执行的操作,如给tag目录授权、给已将创建的SVN库修改库名称,可以在SVN分级授权模块设置SVN库的配置管理员等。
3.3 SVN工具权限管理
此授权是指对SVN分级授权功能的访问控制,如哪些人可以访问分级授权、SVN仓库管理、组织维护。
允许配置管理员角色访问分级授权管理、SVN仓库管理和组织维护;允许全体人员访问分级授权管理。
3.4 管理SVN用户
在SVN分级授权管理工具中添加、修改、删除用户,并同步到Windows,下面做个演示。出Admin和Administrator用户外,系统刚部署好后只有MagicLtdUser一个内置用户(用于运行COM+和WebServer的用户)。
在组织维护选择组织机构,在拥有雇员Tab选项卡上邮件菜单选择重设对应的Windows和Cynthia用户密码(Cynthia作为分级授权用不到,这个功能在2.5节禁用了)。
设置初始化密码后点击确定。
在Windows的用户管理中已经看到SVNADMIN被创建了,此用户属于User用户组。
同样,再把研发部下面的7位同事一次性初始化。
在Windows用户管理中已经出现7位新用户。
3.5 管理员重置用户的SVN密码
管理员可以重置SVN分级授权工具用户和SVN用户的密码。
3.6 用户修改自己的SVN密码
用户修改密码,修改后登录SVN分级授权管理工具和存取SVN的密码都同步更改。
3.7 创建SVN仓库
第一次使用需要准备SVN仓库模板,将模板放到D:\SVNROOT\Template下,文件名为“00000000.开发项目模板”。
启动“SVN仓库管理”,点击“添加”按钮:
选择可以管理这个SVN库的用户,最多可以设置5个。
点击“创建SVN库”,确认SVN库名称(SVNADMIN用户可以在创建前修改)。
SVN库创建成功。
3.8 SVN仓库权限管理
用户登录SVN分级授权管理工具(刚才授权的五个用户中的一个svnuser1),这里以svnuser1登录。点击“分级授权”,点击“查询”,展开需要授权的SVN节点,在右边点击鼠标右键,可以添加用户、删除用户、设置拒绝访问权限、只读访问权限和读/写访问权限,需要注意:
1) 除管理员SVNADMIN外,只能对branches和trunk及其下级目录进行授权。
2) 新增加的用户缺省权限为读/写。
3) 节点权限会覆盖父节点权限。
4) 从父节点继承而来的权限不能删除。
当用户特别多时,可以根据登录名或用户姓名筛选后多选:
缺省加入的用户具有”读/写”权限:
完成授权。存在一个建议删除的用户:这是创建SVN库时SVN自动设置的Administrator对此库的访问权限,建议删除。
3.9 获取SVN存取的URL地址
选中SVN目录树的节点,点击 “拷贝URL” 按钮会将SVN访问的URL地址复制到Windows剪贴板中,方便在TortoiseSVN等SVN客户端工具中使用。
第四章 进一步阅读
在下一篇文章中,将讲述采用Windows活动目录进行认证配置的方法,并且将实施高可用配置保证SVN的安全:
1)服务器硬件层面的数据可靠性保障;
2)基于Oracle数据库部署SVN分级授权工具;
3)主域控制器和额外域控制器保证域认证的高可用;
4)SVN采用文件同步的主SVN服务器和备SVN服务器;
5)与外部业务系统的组织机构自动同步;
6)提供AD用户管理接口;
7)备份脚本及Windows备份任务的策略。