...
This section provides information on the authentication settings that you can specify to log in to a Subversion repository
...
SubGit, like any other Subversion client, can access a Subversion repository by using one of the following protocols.
Table 1. Subversion repository access protocols
...
file://...
svn://...
svn+ssh://...
http(s)://...
The access via file:// can be usedwhen both Subversion and Git repositories are hosted on the same machine. In this case, the local operating system account is used for authentication and no additional settings are required.All the other access methods to a Subversion repository require the appropriate authentication settings for SubGit..
| Children Display | ||||
|---|---|---|---|---|
|
Access methods to a Subversion repository
| Include Page | ||||
|---|---|---|---|---|
|
Obtaining the authentication data for a Subversion repository
SubGit obtains
| Include Page | ||
|---|---|---|
|
|
- a username and a password
- an SSL client certificate
- an SSH private key
In the [auth "default"] section of the SubGit configuration file, you can specify the authentication settings depending on the authentication data that is required to log in to
|
Specifying a username and a password
You can specify credentials to log in to a Subversion repository in the following settings:
| Code Block |
|---|
[auth "default"]
userName =
password =
passwords =
credentialHelper =
subversionConfigurationDirectory =
useDefaultSubversionConfigurationDirectory = |
SubGit refers to these settings in the sequence presented below. If some setting is not specified or the credentials fetched from the setting are not valid, SubGit refers to the next one until it is able to log in to a Subversion repository.
- The userName and password settings.
- The passwords setting that refers to the passwords file for a username-password pair.
- A credential helper program.
- Subversion credentials cache from the Subversion client configuration directory.
If none of the settings is specified or fetched credentials are not valid, SubGit reports the authentication error.
The userName and password settings
The userName and password settings specify
| Include Page | ||||
|---|---|---|---|---|
|
| Note |
|---|
The password is stored as plain text. For security reason, it is recommended to limit the access to the SubGit configuration file. |
The passwords setting
The passwords setting defines a path to the passwords file that can contain the list of username-password pairs to log in to a Subversion repository. The path can be either absolute or relative to the Git repository.
The default value:
| Code Block |
|---|
[auth "default"]
passwords = subgit/passwd |
The default password file is located in the subgit directory within a Git repository. In this file, you can specify the list of username-password pairs as plain text in the following format:
| Code Block |
|---|
svnUserName svnUserPassword |
The credentials from the passwords file may be used for mapping Git authors to Subversion revision authors when you translate Git commits to Subversion revisions. For the mapping purpose, you can specify the list of available usernames and passwords in the passwords file, though it is not obligatory. For more information on authors mapping, refer to the Authors Mapping section.
...
Using the SSH key-based authentication
| Include Page | ||||
|---|---|---|---|---|
|
Using the SSL client certificate authentication
| Include Page | ||||
|---|---|---|---|---|
|