/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: John Arbash Meinel
  • Date: 2011-04-22 14:12:22 UTC
  • mfrom: (5809 +trunk)
  • mto: This revision was merged to the branch mainline in revision 5836.
  • Revision ID: john@arbash-meinel.com-20110422141222-nx2j0hbkihcb8j16
Merge newer bzr.dev and resolve conflicts.
Try to write some documentation about how the _dirblock_state works.
Fix up the tests so that they pass again.

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 ``~/.config/breezy/breezy.conf`` or
54
 
``~/.config/breezy/locations.conf`` is also a security risk.
 
53
Storing passwords in ``~/.bazaar/bazaar.conf`` or ``~/.bazaar/locations.conf``
 
54
is also a security risk.
55
55
 
56
56
Typing user and passwords is error-prone and boring.
57
57
 
158
158
 
159
159
Encoding passwords in ``base64``, while weak, provides protection against
160
160
accidental reading (if an administrator have to look into the file, he will not
161
 
see the passwords in clear).
 
161
see the passwords in clear).(Not implemented yet).
162
162
 
163
163
This specification intends to ease the authentication providing, not to secure
164
164
it in the best possible way.
179
179
File format
180
180
-----------
181
181
 
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
 
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
186
185
reasons:
187
186
 
188
187
  * allow the user to protect the content of one file only, relaxing security
193
192
    generally servers. The same authentification definition can even be used
194
193
    for several schemes for servers providing those schemes.
195
194
 
196
 
``~/.config/breezy//authentication.conf`` will use the same file format as
197
 
``~/.config/breezy/breezy.conf``.
 
195
``~/.bazaar/authentication.conf`` will use the same file format as
 
196
``~/.bazaar/bazaar.conf``.
198
197
 
199
198
Each section describes an authentication definition.
200
199
 
267
266
        scheme=https
268
267
        host=home.net
269
268
        user=joe
270
 
        # Obtain the base64 encoded password by running 'echo -n "secret-pass" | base64'
271
269
        password='c2VjcmV0LXBhc3M='
272
270
        password_encoding=base64
273
271
        verify_certificates=no # Still searching a free certificate provider
325
323
 
326
324
2. ``user`` given in the URL.
327
325
 
328
 
  Get a password from ``~/.config/breezy/authentication.conf`` or prompt
 
326
  Get a password from ``~/.bazaar/authentication.conf`` or prompt
329
327
  for one if none is found.
330
328
 
331
329
3. No ``user`` given in the URL (and no ``password``).
332
330
 
333
 
  Get a user from ``~/.config/breezy/authentication.conf`` or prompt for one if
334
 
  none is found. Continue as 2. (Not implemented yet)
 
331
  Get a user from ``~/.bazaar/authentication.conf`` or prompt for one if none is
 
332
  found. Continue as 2. (Not implemented yet)
335
333
 
336
334
Note: A user will be queried only if the server requires it for ``HTTP`` or
337
335
``HTTPS``, other protocols always require a user.
365
363
* As this specification proposes a matching between some credentials
366
364
  definitions and real URLs, the implementation provides an optional UI
367
365
  feedback about which credential definition is used. Using ``-Dauth`` will
368
 
  output some traces in the ``brz.log`` file metionning the sections
 
366
  output some traces in the ``.bzr.log`` file metionning the sections
369
367
  used. This allows the user to validate his definitions.
370
368
 
371
369
Questions and Answers