/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Jelmer Vernooij
  • Date: 2020-01-19 15:14:16 UTC
  • mto: This revision was merged to the branch mainline in revision 7455.
  • Revision ID: jelmer@jelmer.uk-20200119151416-f2x9y9rtvwxndr2l
Don't show submodules that are not checked out as deltas.

Show diffs side-by-side

added added

removed removed

Lines of Context:
breezy/help_topics/en/authentication.txt
24
24
 
25
25
Instead of using::
26
26
 
27
 
  bzr branch ftp://joe:secret@host.com/path/to/my/branch
 
27
  brz branch sftp://joe:secret@host.com/path/to/my/branch
28
28
 
29
29
you simply use::
30
30
 
31
 
  bzr branch ftp://host.com/path/to/my/branch
 
31
  brz branch sftp://host.com/path/to/my/branch
32
32
 
33
33
provided you have created the following ``authentication.conf`` file::
34
34
 
35
35
  [myprojects]
36
 
  scheme=ftp
 
36
  scheme=sftp
37
37
  host=host.com
38
38
  user=joe
39
39
  password=secret
43
43
--------------------------
44
44
 
45
45
There are two kinds of authentication used by the various schemes supported by
46
 
bzr:
 
46
brz:
47
47
 
48
48
1. user and password
49
49
 
58
58
against a host. But, by using ``.htaccess`` files, for example, it is possible
59
59
to define several (``user, realm, password``) for a given ``host``. So what is
60
60
really needed is (``user``, ``password``, ``host``, ``path``). The ``realm`` is
61
 
not taken into account in the definitions, but will displayed if bzr prompts
 
61
not taken into account in the definitions, but will displayed if brz prompts
62
62
you for a password.
63
63
 
64
64
``HTTP proxy`` can be handled as ``HTTP`` (or ``HTTPS``) by explicitly
81
81
 
82
82
  * ``path``: can be empty (FTP or SFTP will never user it),
83
83
 
84
 
  * ``user``: can be empty (``bzr`` will defaults to python's
 
84
  * ``user``: can be empty (``bzr`` will default to python's
85
85
    ``getpass.get_user()``),
86
86
 
87
87
  * ``password``: can be empty if you prefer to always be prompted for your
88
88
    password.
89
89
 
90
 
Multiple definitions can be provided and, for a given URL, bzr will select a
 
90
Multiple definitions can be provided and, for a given URL, brz will select a
91
91
(``user`` [, ``password``]) based on the following rules :
92
92
 
93
93
 1. the first match wins,
141
141
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
142
142
 
143
143
All connections are done with the same ``user`` (the remote one for which the
144
 
default bzr one is not appropriate) and the password is always prompted with
 
144
default brz one is not appropriate) and the password is always prompted with
145
145
some exceptions::
146
146
 
147
147
        # Pet projects on hobby.net
173
173
        # The leading '.' ensures that 'shp.net' alone doesn't match
174
174
        host=.shp.net
175
175
        user=joe
176
 
        # bzr don't support supplying a password for sftp,
 
176
        # brz doesn't support supplying a password for sftp,
177
177
        # consider using an ssh agent if you don't want to supply
178
178
        # a password interactively. (pageant, ssh-agent, etc)
179
179