/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to debian/mandos.templates

  • Committer: Teddy Hogeborn
  • Date: 2019-07-18 00:02:43 UTC
  • Revision ID: teddy@recompile.se-20190718000243-okz4s9xao1r1tfnx
Document bug in mandos-keygen which strips white space from passwords

Passwords, as read by mandos-keygen when given the --password or -p
options, are stripped of white space from the start and from the end
of the password.  This is because mandos-keygen is a shell script, and
the Bourne Shell "read" builtin does not seem to have a way to avoid
this.  Document this bug.

* manods-keygen.xml (OPTIONS): Document the white space-stripping
                               nature of the --password/-p option, and
                               also note in the description of
                               --passfile and -F that they avoid this
                               behavior.
  (BUGS): Again mention the problem with the --password and -p
          options, and suggest --passfile as a possible workaround.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Template: mandos/key_id
2
2
Type: note
3
3
Description: New client option "key_id" is REQUIRED on server
4
 
 A new "key_id" client option is REQUIRED in the clients.conf file,
5
 
 otherwise the client most likely will not reboot unattended.  This option:
6
 
 .
7
 
  key_id = <HEXSTRING>
8
 
 .
9
 
 must be added in the file /etc/mandos/clients.conf, right before the
10
 
 "fingerprint" option, for each Mandos client.  You must edit that file and
11
 
 add this option for all clients.  To see the correct key ID for each
12
 
 client, run this command (on each client):
13
 
 .
14
 
  mandos-keygen -F/dev/null|grep ^key_id
15
 
 .
16
 
 Note: the clients must all also be using GnuTLS 3.6.6 or later; the server
17
 
 cannot serve passwords for both old and new clients!
18
 
 .
19
 
 Rationale: With GnuTLS 3.6.6, Mandos has been forced to stop using OpenPGP
20
 
 keys as TLS session keys.  A new TLS key pair will be generated on each
21
 
 client and will be used as identification, but the key ID of the public
22
 
 key needs to be added to this server, since this will now be used to
23
 
 identify the client to the server.
 
4
 A new "key_id" client option is REQUIRED in the clients.conf file, otherwise the client most likely will not reboot unattended.  This option:
 
5
 .
 
6
 key_id = <HEXSTRING>
 
7
 .
 
8
 must be added in the file /etc/mandos/clients.conf, right before the "fingerprint" option, for each Mandos client.  You must edit that file and add this option for all clients.  To see the correct key ID for each client, run this command (on each client):
 
9
 .
 
10
 mandos-keygen -F/dev/null|grep ^key_id
 
11
 .
 
12
 Note: the clients must all also be using GnuTLS 3.6.6 or later; the server cannot serve passwords for both old and new clients!
 
13
 .
 
14
 Rationale: With GnuTLS 3.6.6, Mandos has been forced to stop using OpenPGP keys as TLS session keys.  A new TLS key pair will be generated on each client and will be used as identification, but the key ID of the public key needs to be added to this server, since this will now be used to identify the client to the server.
24
15
 
25
16
Template: mandos/removed_bad_key_ids
26
17
Type: note
27
18
Description: Bad key IDs have been removed from clients.conf
28
 
 Bad key IDs, which were created by a bug in Mandos client 1.8.0, have been
29
 
 removed from /etc/mandos/clients.conf
 
19
 Bad key IDs, which were created by a bug in Mandos client 1.8.0, have been removed from /etc/mandos/clients.conf