← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help_topics/en/authentication.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-05-09 21:05:07 UTC
  • mfrom: (3418.5.4 183705-auth-doc-unclear)
  • Revision ID: pqm@pqm.ubuntu.com-20080509210507-jcb0uvu1htlnnouy
(vila) Fix #183705 by updating auth docs to discuss SSH agents

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/en/authentication.txt
6
6
------
7
7
 
8
8
Many different authentication policies can be described in the
9
 
``authentication.conf`` file but a particular user should need
10
 
only a few definitions to cover his needs without having to specify a user and
11
 
a password for every branch he uses.
 
9
``authentication.conf`` file but a particular user should need only a few
 
10
definitions to cover his needs without having to specify a user and a password
 
11
for every branch he uses.
12
12
 
13
13
The definitions found in this file are used to find the credentials to use for
14
14
a given url. The same credentials can generally be used for as many branches as
47
47
 
48
48
1. user and password
49
49
 
50
 
``FTP`` and ``SFTP`` needs a (``user``, ``password``) to authenticate against a
51
 
``host`` (SFTP can use ssh keys too, but we don't talk about that here as ssh
52
 
agents provide a better solution).
 
50
``FTP`` needs a (``user``, ``password``) to authenticate against a ``host``
 
51
``SFTP`` can use either a password or a host key to authenticate. However,
 
52
ssh agents are a better, more secure solution. So we have chosen to not provide
 
53
our own less secure method.
53
54
 
54
55
2. user, realm and password
55
56
 
174
175
        # The leading '.' ensures that 'shp.net' alone doesn't match
175
176
        host=.shp.net
176
177
        user=joe
177
 
        password=precious
 
178
        # bzr don't support supplying a password for sftp,
 
179
        # consider using an ssh agent if you don't want to supply
 
180
        # a password interactively. (pageant, ssh-agent, etc)
178
181
 
179
182
HTTPS, SFTP servers and their proxy
180
183
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
181
184
 
182
 
At company.com, the server hosting released and integration code is behind a
183
 
proxy, the two servers use different authentication policies::
 
185
At company.com, the server hosting release and integration branches is behind a
 
186
proxy, and the two branches use different authentication policies::
184
187
 
185
188
        [reference code]
186
189
        scheme=https
195
198
        host=dev.company.com
196
199
        path=/dev/integration
197
200
        user=user2
198
 
        password=pass2
199
201
        
200
202
        # proxy
201
203
        [proxy]