/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 mandos-keygen

  • Committer: Teddy Hogeborn
  • Date: 2008-08-18 05:24:20 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080818052420-ab5eurrioz8n2qy6
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".

* mandos-keygen Bug fix: make the --expire option modify
                KEYEXPIRE, not KEYCOMMENT.  Use the "--no-options"
                option to gpg when exporting keys from the temporary
                key ring files.

* mandos-keygen.xml (EXIT STATUS): Filled in.
  (ENVIRONMENT): New section, documenting use of TMPDIR.
  (FILES): Document use of key files and /tmp.
  (BUGS): Filled in.
  (EXAMPLE): Added two examples.
  (SECURITY): Added some text.

* plugins.d/password-prompt.xml (NOTES): Removed, since this is
                                         created automatically for
                                         footnotes.
  (ENVIRONMENT, FILES): Added empty sections.
  (EXAMPLES): Renamed to "EXAMPLE", as per man-pages(7).

* plugins.d/password-request.xml: Reordered sections.
  (ENVIRONMENT): New empty section.
  (EXAMPLES): Renamed to "EXAMPLE", as per man-pages(7).

Show diffs side-by-side

added added

removed removed

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