/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 doc/developers/authentication-ring.txt

  • Committer: Jelmer Vernooij
  • Date: 2017-07-30 18:38:48 UTC
  • mfrom: (6740.1.1 breezy-conf-1)
  • Revision ID: jelmer@jelmer.uk-20170730183848-195b9ch7sclkxmqs
Merge lp:~jelmer/brz/breezy-conf

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/authentication-ring.txt
50
50
hazard (see `bug #34685
51
51
<https://launchpad.net/products/bzr/+bug/34685>`_).
52
52
 
53
 
Storing passwords in ``~/.bazaar/bazaar.conf`` or ``~/.bazaar/locations.conf``
54
 
is also a security risk.
 
53
Storing passwords in ``~/.config/breezy/breezy.conf`` or
 
54
``~/.config/breezy/locations.conf`` is also a security risk.
55
55
 
56
56
Typing user and passwords is error-prone and boring.
57
57
 
179
179
File format
180
180
-----------
181
181
 
182
 
Even if ``~/.bazaar/bazaar.conf`` and ``~/.bazaar/locations.conf`` seems to
183
 
provide most of the needed infrastructure, we choose to use a dedicated file
184
 
for the authentication info ``~/.bazaar/authentication.conf`` for the following
 
182
Even if ``~/.config/breezy/breezy.conf`` and
 
183
``~/.config/breezy/locations.conf`` seems to provide most of the needed
 
184
infrastructure, we choose to use a dedicated file
 
185
for the authentication info ``~/.config/breezy/authentication.conf`` for the following
185
186
reasons:
186
187
 
187
188
  * allow the user to protect the content of one file only, relaxing security
192
193
    generally servers. The same authentification definition can even be used
193
194
    for several schemes for servers providing those schemes.
194
195
 
195
 
``~/.bazaar/authentication.conf`` will use the same file format as
196
 
``~/.bazaar/bazaar.conf``.
 
196
``~/.config/breezy//authentication.conf`` will use the same file format as
 
197
``~/.config/breezy/breezy.conf``.
197
198
 
198
199
Each section describes an authentication definition.
199
200
 
324
325
 
325
326
2. ``user`` given in the URL.
326
327
 
327
 
  Get a password from ``~/.bazaar/authentication.conf`` or prompt
 
328
  Get a password from ``~/.config/breezy/authentication.conf`` or prompt
328
329
  for one if none is found.
329
330
 
330
331
3. No ``user`` given in the URL (and no ``password``).
331
332
 
332
 
  Get a user from ``~/.bazaar/authentication.conf`` or prompt for one if none is
333
 
  found. Continue as 2. (Not implemented yet)
 
333
  Get a user from ``~/.config/breezy/authentication.conf`` or prompt for one if
 
334
  none is found. Continue as 2. (Not implemented yet)
334
335
 
335
336
Note: A user will be queried only if the server requires it for ``HTTP`` or
336
337
``HTTPS``, other protocols always require a user.