/mandos/release

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

« back to all changes in this revision

Viewing changes to mandos-keygen

Documentation changes:

* DBUS-API: New file documenting the server D-Bus interface.

* clients.conf: Add examples of new approval settings.

* debian/mandos.docs: Added "DBUS-API".

* mandos-clients.conf.xml (OPTIONS): Added "approved_by_default",
                                     "approval_delay", and
                                     "approval_duration".
* mandos.xml (D-BUS INTERFACE): Refer to the "DBUS-API" file.
  (BUGS): Remove mention of lack of a remote query interface.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos-keygen
2
2
# 
3
3
# Mandos key generator - create a new OpenPGP key for a Mandos client
4
4
# 
5
 
# Copyright © 2007-2008 Teddy Hogeborn & Björn Påhlsson
 
5
# Copyright © 2008,2009 Teddy Hogeborn
 
6
# Copyright © 2008,2009 Björn Påhlsson
6
7
# 
7
8
# This program is free software: you can redistribute it and/or modify
8
9
# it under the terms of the GNU General Public License as published by
20
21
# Contact the authors at <mandos@fukt.bsnet.se>.
21
22
# 
22
23
 
23
 
VERSION="1.0"
 
24
VERSION="1.0.14"
24
25
 
25
 
KEYDIR="/etc/mandos"
 
26
KEYDIR="/etc/keys/mandos"
26
27
KEYTYPE=DSA
27
 
KEYLENGTH=1024
28
 
KEYNAME="`hostname --fqdn`"
 
28
KEYLENGTH=2048
 
29
SUBKEYTYPE=ELG-E
 
30
SUBKEYLENGTH=2048
 
31
KEYNAME="`hostname --fqdn 2>/dev/null || hostname`"
29
32
KEYEMAIL=""
30
33
KEYCOMMENT="Mandos client key"
31
34
KEYEXPIRE=0
32
35
FORCE=no
33
36
KEYCOMMENT_ORIG="$KEYCOMMENT"
 
37
mode=keygen
 
38
 
 
39
if [ ! -d "$KEYDIR" ]; then
 
40
    KEYDIR="/etc/mandos/keys"
 
41
fi
34
42
 
35
43
# Parse options
36
 
TEMP=`getopt --options vhd:t:l:n:e:c:x:f \
37
 
    --longoptions version,help,dir:,type:,length:,name:,email:,comment:,expire:,force \
 
44
TEMP=`getopt --options vhpF:d:t:l:s:L:n:e:c:x:f \
 
45
    --longoptions version,help,password,passfile:,dir:,type:,length:,subtype:,sublength:,name:,email:,comment:,expire:,force \
38
46
    --name "$0" -- "$@"`
39
47
 
40
48
help(){
 
49
basename="`basename $0`"
41
50
cat <<EOF
42
 
Usage: `basename $0` [options]
 
51
Usage: $basename [ -v | --version ]
 
52
       $basename [ -h | --help ]
 
53
   Key creation:
 
54
       $basename [ OPTIONS ]
 
55
   Encrypted password creation:
 
56
       $basename { -p | --password } [ --name NAME ] [ --dir DIR]
 
57
       $basename { -F | --passfile } FILE [ --name NAME ] [ --dir DIR]
43
58
 
44
 
Options:
 
59
Key creation options:
45
60
  -v, --version         Show program's version number and exit
46
61
  -h, --help            Show this help message and exit
47
62
  -d DIR, --dir DIR     Target directory for key files
48
63
  -t TYPE, --type TYPE  Key type.  Default is DSA.
49
64
  -l BITS, --length BITS
50
 
                        Key length in bits.  Default is 1024.
 
65
                        Key length in bits.  Default is 2048.
 
66
  -s TYPE, --subtype TYPE
 
67
                        Subkey type.  Default is ELG-E.
 
68
  -L BITS, --sublength BITS
 
69
                        Subkey length in bits.  Default is 2048.
51
70
  -n NAME, --name NAME  Name of key.  Default is the FQDN.
52
 
  -e EMAIL, --email EMAIL
 
71
  -e ADDRESS, --email ADDRESS
53
72
                        Email address of key.  Default is empty.
54
 
  -c COMMENT, --comment COMMENT
 
73
  -c TEXT, --comment TEXT
55
74
                        Comment field for key.  The default value is
56
75
                        "Mandos client key".
57
76
  -x TIME, --expire TIME
58
77
                        Key expire time.  Default is no expiration.
59
78
                        See gpg(1) for syntax.
60
 
  -f, --force           Force overwriting old keys.
 
79
  -f, --force           Force overwriting old key files.
 
80
 
 
81
Password creation options:
 
82
  -p, --password        Create an encrypted password using the key in
 
83
                        the key directory.  All options other than
 
84
                        --dir and --name are ignored.
 
85
  -F FILE, --passfile FILE
 
86
                        Encrypt a password from FILE using the key in
 
87
                        the key directory.  All options other than
 
88
                        --dir and --name are ignored.
61
89
EOF
62
90
}
63
91
 
64
92
eval set -- "$TEMP"
65
93
while :; do
66
94
    case "$1" in
 
95
        -p|--password) mode=password; shift;;
 
96
        -F|--passfile) mode=password; PASSFILE="$2"; shift 2;;
67
97
        -d|--dir) KEYDIR="$2"; shift 2;;
68
98
        -t|--type) KEYTYPE="$2"; shift 2;;
 
99
        -s|--subtype) SUBKEYTYPE="$2"; shift 2;;
69
100
        -l|--length) KEYLENGTH="$2"; shift 2;;
 
101
        -L|--sublength) SUBKEYLENGTH="$2"; shift 2;;
70
102
        -n|--name) KEYNAME="$2"; shift 2;;
71
103
        -e|--email) KEYEMAIL="$2"; shift 2;;
72
104
        -c|--comment) KEYCOMMENT="$2"; shift 2;;
87
119
PUBKEYFILE="$KEYDIR/pubkey.txt"
88
120
 
89
121
# Check for some invalid values
90
 
if [ -d "$KEYDIR" ]; then :; else
 
122
if [ ! -d "$KEYDIR" ]; then
91
123
    echo "$KEYDIR not a directory" >&2
92
124
    exit 1
93
125
fi
94
 
if [ -w "$KEYDIR" ]; then :; else
95
 
    echo "Directory $KEYDIR not writeable" >&2
96
 
    exit 1
97
 
fi
98
 
 
99
 
if [ -z "$KEYTYPE" ]; then
100
 
    echo "Empty key type" >&2
101
 
    exit 1
102
 
fi
103
 
 
104
 
if [ -z "$KEYNAME" ]; then
105
 
    echo "Empty key name" >&2
106
 
    exit 1
107
 
fi
108
 
 
109
 
if [ -z "$KEYLENGTH" ] || [ "$KEYLENGTH" -lt 512 ]; then
110
 
    echo "Invalid key length" >&2
111
 
    exit 1
112
 
fi
113
 
 
114
 
if [ -z "$KEYEXPIRE" ]; then
115
 
    echo "Empty key expiration" >&2
116
 
    exit 1
117
 
fi
118
 
 
119
 
# Make FORCE be 0 or 1
120
 
case "$FORCE" in
121
 
    [Yy][Ee][Ss]|[Tt][Rr][Uu][Ee]) FORCE=1;;
122
 
    [Nn][Oo]|[Ff][Aa][Ll][Ss][Ee]|*) FORCE=0;;
123
 
esac
124
 
 
125
 
if { [ -e "$SECKEYFILE" ] || [ -e "$PUBKEYFILE" ]; } \
126
 
    && [ "$FORCE" -eq 0 ]; then
127
 
    echo "Refusing to overwrite old key files; use --force" >&2
128
 
    exit 1
129
 
fi
130
 
 
131
 
# Set lines for GnuPG batch file
132
 
if [ -n "$KEYCOMMENT" ]; then
133
 
    KEYCOMMENTLINE="Name-Comment: $KEYCOMMENT"
134
 
fi
135
 
if [ -n "$KEYEMAIL" ]; then
136
 
    KEYEMAILLINE="Name-Email: $KEYEMAIL"
137
 
fi
138
 
 
139
 
# Create temp files
140
 
BATCHFILE="`mktemp -t mandos-gpg-batch.XXXXXXXXXX`"
141
 
SECRING="`mktemp -t mandos-gpg-secring.XXXXXXXXXX`"
142
 
PUBRING="`mktemp -t mandos-gpg-pubring.XXXXXXXXXX`"
 
126
if [ ! -r "$KEYDIR" ]; then
 
127
    echo "Directory $KEYDIR not readable" >&2
 
128
    exit 1
 
129
fi
 
130
 
 
131
if [ "$mode" = keygen ]; then
 
132
    if [ ! -w "$KEYDIR" ]; then
 
133
        echo "Directory $KEYDIR not writeable" >&2
 
134
        exit 1
 
135
    fi
 
136
    if [ -z "$KEYTYPE" ]; then
 
137
        echo "Empty key type" >&2
 
138
        exit 1
 
139
    fi
 
140
    
 
141
    if [ -z "$KEYNAME" ]; then
 
142
        echo "Empty key name" >&2
 
143
        exit 1
 
144
    fi
 
145
    
 
146
    if [ -z "$KEYLENGTH" ] || [ "$KEYLENGTH" -lt 512 ]; then
 
147
        echo "Invalid key length" >&2
 
148
        exit 1
 
149
    fi
 
150
    
 
151
    if [ -z "$KEYEXPIRE" ]; then
 
152
        echo "Empty key expiration" >&2
 
153
        exit 1
 
154
    fi
 
155
    
 
156
    # Make FORCE be 0 or 1
 
157
    case "$FORCE" in
 
158
        [Yy][Ee][Ss]|[Tt][Rr][Uu][Ee]) FORCE=1;;
 
159
        [Nn][Oo]|[Ff][Aa][Ll][Ss][Ee]|*) FORCE=0;;
 
160
    esac
 
161
    
 
162
    if [ \( -e "$SECKEYFILE" -o -e "$PUBKEYFILE" \) \
 
163
        -a "$FORCE" -eq 0 ]; then
 
164
        echo "Refusing to overwrite old key files; use --force" >&2
 
165
        exit 1
 
166
    fi
 
167
    
 
168
    # Set lines for GnuPG batch file
 
169
    if [ -n "$KEYCOMMENT" ]; then
 
170
        KEYCOMMENTLINE="Name-Comment: $KEYCOMMENT"
 
171
    fi
 
172
    if [ -n "$KEYEMAIL" ]; then
 
173
        KEYEMAILLINE="Name-Email: $KEYEMAIL"
 
174
    fi
 
175
    
 
176
    # Create temporary gpg batch file
 
177
    BATCHFILE="`mktemp -t mandos-keygen-batch.XXXXXXXXXX`"
 
178
fi
 
179
 
 
180
if [ "$mode" = password ]; then
 
181
    # Create temporary encrypted password file
 
182
    SECFILE="`mktemp -t mandos-keygen-secfile.XXXXXXXXXX`"
 
183
fi
 
184
 
 
185
# Create temporary key ring directory
 
186
RINGDIR="`mktemp -d -t mandos-keygen-keyrings.XXXXXXXXXX`"
143
187
 
144
188
# Remove temporary files on exit
145
189
trap "
146
 
set +e
147
 
rm --force $PUBRING $BATCHFILE;
148
 
shred --remove $SECRING;
149
 
stty echo
 
190
set +e; \
 
191
test -n \"$SECFILE\" && shred --remove \"$SECFILE\"; \
 
192
shred --remove \"$RINGDIR\"/sec*;
 
193
test -n \"$BATCHFILE\" && rm --force \"$BATCHFILE\"; \
 
194
rm --recursive --force \"$RINGDIR\";
 
195
stty echo; \
150
196
" EXIT
151
197
 
152
 
# Create batch file for GnuPG
153
 
cat >"$BATCHFILE" <<EOF
154
 
Key-Type: $KEYTYPE
155
 
Key-Length: $KEYLENGTH
156
 
#Key-Usage: encrypt,sign,auth
157
 
Name-Real: $KEYNAME
158
 
$KEYCOMMENTLINE
159
 
$KEYEMAILLINE
160
 
Expire-Date: $KEYEXPIRE
161
 
%pubring $PUBRING
162
 
%secring $SECRING
163
 
%commit
164
 
EOF
165
 
 
166
 
umask 027
167
 
 
168
 
# Generate a new key in the key rings
169
 
gpg --no-random-seed-file --quiet --batch --no-tty \
170
 
    --no-default-keyring --no-options --batch \
171
 
    --secret-keyring "$SECRING" --keyring "$PUBRING" \
172
 
    --gen-key "$BATCHFILE"
173
 
rm --force "$BATCHFILE"
174
 
 
175
 
# Backup any old key files
176
 
if cp --backup=numbered --force "$SECKEYFILE" "$SECKEYFILE" \
177
 
    2>/dev/null; then
178
 
    shred --remove "$SECKEYFILE"
179
 
fi
180
 
if cp --backup=numbered --force "$PUBKEYFILE" "$PUBKEYFILE" \
181
 
    2>/dev/null; then
182
 
    rm --force "$PUBKEYFILE"
183
 
fi
184
 
 
185
 
FILECOMMENT="Mandos client key for $KEYNAME"
186
 
if [ "$KEYCOMMENT" != "$KEYCOMMENT_ORIG" ]; then
187
 
    FILECOMMENT="$FILECOMMENT ($KEYCOMMENT)"
188
 
fi
189
 
 
190
 
if [ -n "$KEYEMAIL" ]; then
191
 
    FILECOMMENT="$FILECOMMENT <$KEYEMAIL>"
192
 
fi
193
 
 
194
 
# Export keys from key rings to key files
195
 
gpg --no-random-seed-file --quiet --batch --no-tty --armor \
196
 
    --no-default-keyring --no-options --secret-keyring "$SECRING" \
197
 
    --keyring "$PUBRING" --export-options export-minimal \
198
 
    --comment "$FILECOMMENT" --output "$SECKEYFILE" \
199
 
    --export-secret-keys
200
 
gpg --no-random-seed-file --quiet --batch --no-tty --armor \
201
 
    --no-default-keyring --no-options --secret-keyring "$SECRING" \
202
 
    --keyring "$PUBRING" --export-options export-minimal \
203
 
    --comment "$FILECOMMENT" --output "$PUBKEYFILE" \
204
 
    --export
 
198
umask 077
 
199
 
 
200
if [ "$mode" = keygen ]; then
 
201
    # Create batch file for GnuPG
 
202
    cat >"$BATCHFILE" <<-EOF
 
203
        Key-Type: $KEYTYPE
 
204
        Key-Length: $KEYLENGTH
 
205
        #Key-Usage: encrypt,sign,auth
 
206
        Subkey-Type: $SUBKEYTYPE
 
207
        Subkey-Length: $SUBKEYLENGTH
 
208
        #Subkey-Usage: encrypt,sign,auth
 
209
        Name-Real: $KEYNAME
 
210
        $KEYCOMMENTLINE
 
211
        $KEYEMAILLINE
 
212
        Expire-Date: $KEYEXPIRE
 
213
        #Preferences: <string>
 
214
        #Handle: <no-spaces>
 
215
        #%pubring pubring.gpg
 
216
        #%secring secring.gpg
 
217
        %commit
 
218
        EOF
 
219
    
 
220
    if tty --quiet; then
 
221
        cat <<-EOF
 
222
        Note: Due to entropy requirements, key generation could take
 
223
        anything from a few minutes to SEVERAL HOURS.  Please be
 
224
        patient and/or supply the system with more entropy if needed.
 
225
        EOF
 
226
        echo -n "Started: "
 
227
        date
 
228
    fi
 
229
    
 
230
    # Generate a new key in the key rings
 
231
    gpg --quiet --batch --no-tty --no-options --enable-dsa2 \
 
232
        --homedir "$RINGDIR" --trust-model always \
 
233
        --gen-key "$BATCHFILE"
 
234
    rm --force "$BATCHFILE"
 
235
    
 
236
    if tty --quiet; then
 
237
        echo -n "Finished: "
 
238
        date
 
239
    fi
 
240
    
 
241
    # Backup any old key files
 
242
    if cp --backup=numbered --force "$SECKEYFILE" "$SECKEYFILE" \
 
243
        2>/dev/null; then
 
244
        shred --remove "$SECKEYFILE"
 
245
    fi
 
246
    if cp --backup=numbered --force "$PUBKEYFILE" "$PUBKEYFILE" \
 
247
        2>/dev/null; then
 
248
        rm --force "$PUBKEYFILE"
 
249
    fi
 
250
    
 
251
    FILECOMMENT="Mandos client key for $KEYNAME"
 
252
    if [ "$KEYCOMMENT" != "$KEYCOMMENT_ORIG" ]; then
 
253
        FILECOMMENT="$FILECOMMENT ($KEYCOMMENT)"
 
254
    fi
 
255
    
 
256
    if [ -n "$KEYEMAIL" ]; then
 
257
        FILECOMMENT="$FILECOMMENT <$KEYEMAIL>"
 
258
    fi
 
259
    
 
260
    # Export key from key rings to key files
 
261
    gpg --quiet --batch --no-tty --no-options --enable-dsa2 \
 
262
        --homedir "$RINGDIR" --armor --export-options export-minimal \
 
263
        --comment "$FILECOMMENT" --output "$SECKEYFILE" \
 
264
        --export-secret-keys
 
265
    gpg --quiet --batch --no-tty --no-options --enable-dsa2 \
 
266
        --homedir "$RINGDIR" --armor --export-options export-minimal \
 
267
        --comment "$FILECOMMENT" --output "$PUBKEYFILE" --export
 
268
fi
 
269
 
 
270
if [ "$mode" = password ]; then
 
271
    # Import key into temporary key rings
 
272
    gpg --quiet --batch --no-tty --no-options --enable-dsa2 \
 
273
        --homedir "$RINGDIR" --trust-model always --armor \
 
274
        --import "$SECKEYFILE"
 
275
    gpg --quiet --batch --no-tty --no-options --enable-dsa2 \
 
276
        --homedir "$RINGDIR" --trust-model always --armor \
 
277
        --import "$PUBKEYFILE"
 
278
    
 
279
    # Get fingerprint of key
 
280
    FINGERPRINT="`gpg --quiet --batch --no-tty --no-options \
 
281
        --enable-dsa2 --homedir \"$RINGDIR\" --trust-model always \
 
282
        --fingerprint --with-colons \
 
283
        | sed --quiet \
 
284
        --expression='/^fpr:/{s/^fpr:.*:\\([0-9A-Z]*\\):\$/\\1/p;q}'`"
 
285
    
 
286
    test -n "$FINGERPRINT"
 
287
    
 
288
    FILECOMMENT="Encrypted password for a Mandos client"
 
289
    
 
290
    if [ -n "$PASSFILE" ]; then
 
291
        cat "$PASSFILE"
 
292
    else
 
293
        stty -echo
 
294
        echo -n "Enter passphrase: " >&2
 
295
        first="$(head --lines=1 | tr --delete '\n')"
 
296
        echo -n -e "\nRepeat passphrase: " >&2
 
297
        second="$(head --lines=1 | tr --delete '\n')"
 
298
        echo >&2
 
299
        stty echo
 
300
        if [ "$first" != "$second" ]; then
 
301
            echo -e "Passphrase mismatch" >&2
 
302
            touch "$RINGDIR"/mismatch
 
303
        else
 
304
            echo -n "$first"
 
305
        fi
 
306
    fi | gpg --quiet --batch --no-tty --no-options --enable-dsa2 \
 
307
        --homedir "$RINGDIR" --trust-model always --armor --encrypt \
 
308
        --sign --recipient "$FINGERPRINT" --comment "$FILECOMMENT" \
 
309
        > "$SECFILE"
 
310
    if [ -e "$RINGDIR"/mismatch ]; then
 
311
        rm --force "$RINGDIR"/mismatch
 
312
        exit 1
 
313
    fi
 
314
    
 
315
    cat <<-EOF
 
316
        [$KEYNAME]
 
317
        host = $KEYNAME
 
318
        fingerprint = $FINGERPRINT
 
319
        secret =
 
320
        EOF
 
321
    sed --quiet --expression='
 
322
        /^-----BEGIN PGP MESSAGE-----$/,/^-----END PGP MESSAGE-----$/{
 
323
            /^$/,${
 
324
                # Remove 24-bit Radix-64 checksum
 
325
                s/=....$//
 
326
                # Indent four spaces
 
327
                /^[^-]/s/^/    /p
 
328
            }
 
329
        }' < "$SECFILE"
 
330
fi
205
331
 
206
332
trap - EXIT
207
333
 
 
334
set +e
 
335
# Remove the password file, if any
 
336
if [ -n "$SECFILE" ]; then
 
337
    shred --remove "$SECFILE"
 
338
fi
208
339
# Remove the key rings
209
 
shred --remove "$SECRING"
210
 
rm --force "$PUBRING"
 
340
shred --remove "$RINGDIR"/sec*
 
341
rm --recursive --force "$RINGDIR"