Access Control

1. Installation

1.1 Installation Procedure

Before you begin, check through the Access Control deployment checklist. Once you're confident that your system meets all the requirements, run through the following section to get SVN Access Control installed.

1. Download the Access Control installation file "svnsec.tar.gz" from the WANdisco File Distribution website.

2. Create a home directory for the installation, e.g. /wandisco.

3. Extract the "svnsec.tar.gz" file to the wandisco folder.

4. The installation files are now in place, they are arranged in the following directory structure:

drwxr-xr-x 2 root root  4096 Feb 12 10:30 audit
drwxr-xr-x 2 root root  4096 Feb 12 10:53 backups
drwxr-xr-x 2 root root  4096 Feb 12 10:20 bin
drwxr-xr-x 7 root root  4096 Feb 12 10:37 config
drwxr-xr-x 8 root root  4096 Feb 12 10:20 lib
drwxr-xr-x 2 root root  4096 Feb 12 10:20 license
-rw-r--r-- 1 root root 26727 Feb  4 14:06 license.txt
drwxr-xr-x 4 root root  4096 Feb 12 11:01 logs
drwxr-xr-x 4 root root  4096 Feb 12 10:53 systemdb
drwxr-xr-x 4 root root  4096 Feb 12 10:20 utils
-rw-r--r-- 1 root root    24 Feb  7 12:37 version.txt
drwxr-xr-x 8 root root  4096 Feb 12 10:20 webapp

5. Copy your SVN Access Control license.key file into the config directory.

    
-rw-r--r-- 1 root root   267 Feb 12 13:53 deletionqueue.ser
-rw-r--r-- 1 root root   512 Feb 12 10:28 license.key
-rw-r--r-- 1 root root  3399 Feb  4 14:06 log.properties
-rw-r--r-- 1 root root   771 Feb 12 10:53 logrotation.ser
-rw-r--r-- 1 root root   579 Feb  4 14:06 mailconfig.properties
drwxr-xr-x 5 root root  4096 Feb 12 10:30 membership
drwxr-xr-x 3 root root  4096 Feb 12 10:30 prefs
-rw-r--r-- 1 root root  2727 Feb  4 14:06 prefs-template.xml
-rw-r--r-- 1 root root  1353 Feb 12 10:37 prefs.xml
-rw-r--r-- 1 root root 92160 Feb  7 12:37 reports.tar
drwxr-xr-x 3 root root  4096 Feb 12 10:30 scm
drwxr-xr-x 5 root root  4096 Feb 12 10:30 security
drwxr-xr-x 2 root root  4096 Feb 12 10:53 sessions

6. Enter the bin directory and run the setup, using the command:

./setup -msp.deployment

=======================================================================
WANdisco java processes will start with the following memory settings:

         -Xms128m -Xmx2048m -ea -server -Djava.net.preferIPv4Stack=true

Change the environment variable WD_JVMARGS if you wish to start java differently
WARNING: if the host does not meet these specified memory requirements, you will
encounter problems starting the WANdisco processes.
Continue,  Y or N ? [Y] : Y
Feb 12, 2014 10:30:06 AM org.nirala.trace.Logger info
INFO: Invoked from WANdisco installation at: /opt/wandisco/svn-security
[I] using specified port: 6445
[I] Starting SVN web installer

Point a web browser to http://10.2.5.124:6445/ to configure the product.

7. From a browser, enter the setup URL (http://<Server IP>:<port>). From the welcome screen, click Continue.

8. Read the WANdisco End User License Agreement, then click I Agree.

9. The next screen asks for a password to associate with the admin account username (which is "admin"). Enter the password again (to verify your entry) then click Next.

10. Next, you'll see a message about SSL being disabled by default (it's a good idea ot get up and running before enabling SSL or you'll have a harder time troubleshooting problems. If you can, leave the setup of SSL until after the installation has completed, in this case, click Next. If you need to setup SSL right away, tick the checkbox. You'll get a chance to enter the SSL details before you proceed to the screen in the next step.

11. On the SVN Security Agent Proxy Settings screen, enter the following details

Node Name: A name you will use for the Access Control server.
Node IP: The server's IP address
Bind Host: By default, this uses the wildcard 0.0.0.0 IP that binds to all network interfaces on the node. Read our Knowledgebase article about the benefits of using the wildcard IP
Admin Console Port By default this is 6445, allowing SVN users to continue without making change to their client setup.

Admin Console Port 6445 by default.
Reserved Ports A block of 10 ports are reserved for use by SVN Access Control. By default these are sequential, starting with the Admin Console Port, however you can specify out of sequence ports if required.



Click Next.

12. The next step automatically checks the MultiSite Plus Settings. First Apache is checked. If the httpd.conf file isn't found, enter its path into the Configuration File entry box, then click Reload Configuration.

If a problem is highlighted, you'll need to manually edit the httpd.conf file, then click on Reload Configuration to have setup check your changes.

SVN Executable: the fully qualified path to the SVN executable. Setup will try to fill this in automatically, otherwise enter it manually.
SVN Password FileThe full path to the SVN password file - this will also be referenced in the Apache config file.
Authorization File: Enter the path to the Authz file.
Restrictive AC mode: Access Control can now toggle between either a restrictive or additive mode for handling conflicting access rule:

Restrictive AC Mode
By default Access Control is restrictive and gives more weight to access restrictions, which ensures that in a situation with conflicting rules user's don't get the benefit of the doubt and the "deny" rule always takes precedence, i.e.:the order in which rules are applied is DENY, READ-ONLY, READ-WRITE.

If you prefer that Access Control behave like mod_authz_svn then untick Restrictive AC Mode. In which case Access Control applies rules in the opposite way: READ-WRITE, READ-ONLY then DENY. So that in a rules conflict, the most favorable rule is applied.

MultiSite Plus replicator Node Name: Name of the node.
MultiSite Plus replicator Replicator Host: The IP/hostname of the node's server.
MultiSite Plus replicator API port :The port used to commincate with the MultiSite node.
MultiSite Plus replicator Admin Password :The password associated with the node.


Click Next. Now enter your mail server details. these relate to your email relay server which SVN Access Control will use to send alert messages should there be any problems. You can choose to enter these settings later, in which case you can click Skip. If you enter your mail details you can verify they're correct by triggering a test email.

13. The setup is now ready to complete. Click Complete installation with these setting button to continue.

2. Administration

This section details with the running of SVN MultiSite Access Control.

MultiSite+ Settings

When running SVN Access Control in MultiSite Plus Mode, a new screen appears which is used to control the settings that connect Access Control to your SVN MultiSite server(s).

Access Control's screen for SVN MultiSite Plus integration

When Access Control has been configured for use in conjunction with SVN MultiSite Plus it features an extra settings screen, "Multisite+ Settings"

SVN Executable

Specified for use by the SVN browser.

Password file

The global password file to which the repositories in SVN MultiSite Plus will point

Authorization File

Global authz file, for svnserve repositories - the applicable sections of the authz file for that repository will be written to an authz file as determined by the repository's svnserve.conf file.

Repository Polling Frequency

The frequency the local MultiSite Plus node will be polled for repositories.

Read Timeout

Sets the read timeout for Access Control to SVN MultiSite Plus reads, default value is 60s.

Connection timeout

Sets the connection timeout between Access Control and SVN MultiSite Plus, default value is 30s.

Multisite Plus SSL

Ticked if SVN MultiSite Plus is set up to use SSL for its traffic.

Save Settings

Clicking the Save Settings button ensures that any changes made to the above form fields are saved to Access Control's database.

Reset Authz Generation Count

Each time the authz file is generated to be sent to SVN MultiSite Plus a generation number is incremented and included as a comment in the file. This is used to lock down the ordering of files being processed by SVN MultiSite Plus. Selecting this button resets the generation count to zero.

Reset Password Generation Count

as above but for the password file.

Replicator table

Lists the SVN MultiSite Plus nodes. You can add/edit or delete more nodes from the Actions drop-down menu.

Repository table

Lists the repositories managed by SVN MultiSite Plus, this is a list of repositories from the local MultiSite node.

Poll Now

Retrieve the list of repositories from the local SVN MultiSite Plus node.

Generic File Replication

The Generic File Replication Script handles the final delivery for AuthZ and Password data for WANdisco SVN MultiSite Plus. Customers modifying this code assume all responsibility for the execution thereof. Please contact WANdisco support for more information.

script location

/opt/wandisco/svn-multisite-plus/replicator/gfr
            bin
               postDeliveryAZPQ
            lib
            log
            var

The script handles the following duties:

• Figuring out which file type this is.
• Determining if the current file is later than the current generation.
• Atomically updating the appropriate file(s) based on the file type sent and the type of the SVN implementation serving the users.

The only argument allowed by the script is the file to be processed.

Exit codes

• 0: Ok
• 1: Errors before making changes
• 2: Errors while making changes
• 3: Errors while renaming
• 4: Errors while updating state
• 42: Internal script error - errors with this code will create an error event within GFR to e.g. send an email notification (see below)

Set up email notifications for failure events

While a failure of the Generic File Replication script is pushed to SVN MultiSite Plus, email notifications are not set up by default. You should use the Email Notifications tool to setup emails to your specific requirements. When setting up rules, select the Generic File Replication Error occurred event from the dropdown list.

The specific notification information for GFR notifications:

{event.filename}

which gives information on what file the replication failed on, however this is referring to content distribution so will look something like this: ` /opt/wandisco/svn-multisite-plus/replicator/content/74fced44-7934-11e3-b3a6-0a9bddc2625c`

and

{event.errorMessage}

which is much more informative and says why GFR failed - i.e. `postDeliveryAZPW: Error: GFR log directory "/opt/wandisco/svn-multisite-plus/replicator/gfr/log" does not exist, aborting`

Reference

The following section runs through the Access Control admin console, explaining the purpose and function of each part.

Quick Links

Proxy Status - Proxy Status Displays the node's status in the tab's main panel.
Change User Password - Follow this link to change the password of a User, it's not used for changing the Admin password.

Security

Access Control's functionality is mostly controlled through the settings found under the Security tab. This includes all user, team and rules management.

Teams

The teams section lets you create and list teams. Teams are used to organise Subversion users in order that you can apply access rules to users without the need to have a separate rule for every single users -- although you can work this way if required.

Create Team

In Access Control a Team is a group of users who are associated with a resource or collection of resources. Teams underpin how user authorization is managed in Access Control.

Name*

A name by which Access Control will refer to the team. A Team name can consist of letters numbers and spaces.

Team Names Must Be Globally Unique
All teams must have a unique name within Access Control. It's currently not possible to have two teams with the same name, even if they are located within different directories.

Description

A description of the team. This can help distinguish the team, possibly referring to the team's purpose or location.

Add Users

Enter usernames into the "Add Users" entry field, will make the user appear. Entering a letter into the field will result in all users whose usernames begin with that character being listed under the entry field.

If you prefer, instead of entering the username of each user you wish to add to the team, you can click the Browse button and select from all available users by ticking check boxes. Tick those users that you want in the team, or if you're adding a lot of users it maybe be faster to click Select All then untick users that you don't want to add. When you've finished selecting users, click the Save button.

Add Resources

Resources are repository folders. Browse the repository and select a folder, or type in the directory path and click the Add button.

Adding a resource to a team doesn't automatically provide the team's members with authorization to access the resource, first Team Rules must be created that will set the specific permissions for selected team members.

List Teams

The List Teams screen provides a list of all teams as well as action buttons for editing, deleting or creating rules or subteams.

Create Team Rule

The Create Team Rule is used to set the access permission rules that will control which users and teams can access specific repository resources and what level of access they will have.

Parent Team Name

The name of the team to which the rule will apply.

Rule Name

A name that will be used to refer to the rule.

Define Resources/Paths for this rule:

Select repositories and repository subfolders to which the rule will apply. You can select an access level (Deny, Read-only or Read/Write) for each resource. You can select resources using the browse option, or manually enter its relative path on the second entry box.

Create Subteam

Access Control supports the creation of subteams which allow team leaders to delegate management of a subset of their team members and resources without having to give subordinates access to anything above what the parent team can access.

List Team Leaders

From the List Team Leaders screen it is possible to see which users are team leaders, the teams they lead adn the resources that their teams can access.

List Users

the List Users screen gives you to all the users who have been entered into Access Control.

4.1.4 Import Users

It's possible to import users instead of entering them manually through the Create User screen. Use a comma delimited (CSV) format for the import, with the following fields:

<username>,<first name>,<last name>,<email address>,<password>,<UserType>[,[Parent/Team/Names/]<team name>]

Click on Choose File and navigate to your import file. When selected click the Import button. A message window will appear, indicating whether the import was successful.

Rules Lookup

The Lookup/Search tool lets you test a user's access permissions for a specfied repository resource. For users who are members of multiple teams and to whom numerous team rules are applied, the Lookup/Search greatly simplifies the verification of their access permissions.

Search

The Acccess Control Search tool lets you find information about users, teams rules or resources through a search form. It's possible to filter searches by user, teams, rules or even permissions.

MultiSite Plus Settings

When Access Control is installed in SVN MultiSite Plus mode an extra screen is revealed which stores those settings that control how Access Control interacts with SVN MultiSite Plus. See more about MultiSite+ Settings

System