3 # Debian/OpenSSL Weak Key Detector
5 # Copyright (C) 2008, Florian Weimer <fw@deneb.enyo.de>
7 # Permission to use, copy, modify, and distribute this software for
8 # any purpose with or without fee is hereby granted, provided that the
9 # above copyright notice and this permission notice appear in all
12 # THE SOFTWARE IS PROVIDED "AS IS" AND FLORIAN WEIMER AND HIS
13 # CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
14 # INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
15 # NO EVENT SHALL FLORIAN WEIMER OR HIS CONTRIBUTORS BE LIABLE FOR ANY
16 # SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
17 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
18 # AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
19 # OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
22 # Blacklist data has been provided by Kees Cook, Peter Palfrader and
25 # Patches and comments are welcome. Please send them to
26 # <fw@deneb.enyo.de>, and use "dowkd" in the subject line.
33 usage: $0 [OPTIONS...] COMMAND [ARGUMENTS...]
37 file: examine files on the command line for weak keys
38 host: examine the specified hosts for weak SSH keys
39 user: examine user SSH keys for weakness; examine all users if no
41 help: show this help screen
42 version: show version information
46 -c FILE: set the database cache file name (default: dowkd.db)
48 dowkd currently handles the following OpenSSH host and user keys,
49 provided they have been generated on a little-endian architecture
50 (such as i386 or amd64): RSA/1024 (both rsa1 and rsa format), RSA/2048
51 and DSA/1024. (The relevant OpenSSH versions in Debian do not support
52 DSA key generation with other sizes.)
54 OpenVPN shared also detected on little-endian architecture.
56 Unencrypted RSA private keys and PEM certificate files generated by
57 OpenSSL are detected, provided they use key lengths of 1024 or 2048
60 Note that the blacklist by dowkd may be incomplete; it is only
61 intended as a quick check.
71 my $db_version = '@DB_VERSION@';
72 my $program_version = '@PROGRAM_VERSION@';
73 my $changelog = <<'EOF';
78 my $db_file = 'dowkd.db';
84 warn "notice: creating database, please wait\n";
85 $db = tie
%db, 'DB_File', $db_file, O_RDWR
| O_CREAT
, 0777, $DB_BTREE
86 or die "error: could not open database: $!\n";
88 while (my $line = <DATA
>) {
89 next if $line =~ /^\**$/;
91 $line =~ /^[0-9a-f]{32}$/ or die "error: invalid data line";
92 $line =~ s/(..)/chr(hex($1))/ge;
96 # Set at the end so that no incomplete database is left behind.
97 $db{''} = $db_version;
104 $db = tie
%db, 'DB_File', $db_file, O_RDONLY
, 0777, $DB_BTREE
105 or die "error: could not open database: $!\n";
106 my $stored_version = $db{''};
107 $stored_version && $stored_version eq $db_version or create_db
;
114 sub safe_backtick
(@
) {
117 open $fh, '-|', @args
118 or die "error: failed to spawn $args[0]: $!\n";
124 @result = scalar(<$fh>);
127 $?
== 0 or return undef;
136 my $keys_vulnerable = 0;
139 print STDERR
"summary: keys found: $keys_found, weak keys: $keys_vulnerable\n";
142 sub check_hash
($$;$) {
143 my ($name, $hash, $descr) = @_;
145 if (exists $db{$hash}) {
147 $descr = $descr ?
" ($descr)" : '';
148 print "$name: weak key$descr\n";
152 sub ssh_fprint_file
($) {
154 my $data = safe_backtick qw
/ssh-keygen -l -f/, $name;
155 defined $data or return ();
156 my @data = $data =~ /^(\d+) ([0-9a-f]{2}(?::[0-9a-f]{2}){15})/;
157 return @data if @data == 2;
161 sub ssh_fprint_check
($$$$) {
162 my ($name, $type, $length, $hash) = @_;
163 $type =~ /^(?:rsa1?|dsa)\z/ or die;
165 && ($length == 1024 || $length == 2048 || $length == 4096))
166 || ($type eq 'dsa' && $length == 1024)
167 || ($type eq 'rsa1' && $length == 1024)) {
169 $hash =~ s/(..)/chr(hex($1))/ge;
170 check_hash
$name, $hash, "OpenSSH/$type/$length";
171 } elsif ($type eq 'dsa') {
172 print "$name: $length bits DSA key not recommended\n";
174 warn "$name: warning: no blacklist for $type/$length key\n";
180 seek $tmp, 0, 0 or die "seek: $!";
181 truncate $tmp, 0 or die "truncate: $!";
184 sub cleanup_ssh_auth_line
($) {
187 $line =~ /^(?:ssh-(?:rsa|dss)\s|\d+\s+\d+\s+\d)/ and return $line;
190 if ($line =~ /^\s+(.*)/) {
194 if ($line =~ /^"(.*)/) {
198 if ($line =~ /^\\.(.*)/) {
199 # It doesn't matter if we don't deal with \000 properly, we
200 # just need to defuse the backslash character.
204 if ($line =~ /^[a-zA-Z0-9_=+-]+(.*)/) {
205 # Skip multiple harmless characters in one go.
209 if ($line =~ /^.(.*)/) {
210 # Other characters are stripped one by one.
214 return undef; # empty string, no key found
217 if ($line =~ /^"(.*)/) {
221 if ($line =~ /^\\.(.*)/) {
222 # See above, defuse the backslash.
226 if ($line =~ /^[^\\"]+(.*)/) {
230 return undef; # missing closing double quote
233 $line =~ /^(?:ssh-(?:rsa|dss)\s|\d+\s+\d+\s+\d)/ and return $line;
237 sub derive_ssh_auth_type
($) {
239 $line =~ /^ssh-rsa\s/ and return 'rsa';
240 $line =~ /^ssh-dss\s/ and return 'dsa';
241 $line =~ /^\d+\s/ and return 'rsa1';
245 sub from_ssh_auth_line
($$$) {
246 my ($tmp, $name, $line) = @_;
248 return if $line =~ m/^\s*(#|$)/;
251 my $l = cleanup_ssh_auth_line
$line;
255 my $type = derive_ssh_auth_type
$line;
258 print $tmp "$line\n" or die "print: $!";
259 $tmp->flush or die "flush: $!";
260 my ($length, $hash) = ssh_fprint_file
"$tmp";
261 if ($length && $hash) {
262 ssh_fprint_check
"$name", $type, $length, $hash;
267 warn "$name: warning: unparsable line\n";
270 sub from_ssh_auth_file
($) {
273 unless (open $auth, '<', $name) {
274 warn "$name:0: error: open failed: $!\n";
278 my $tmp = new File
::Temp
;
279 while (my $line = <$auth>) {
280 from_ssh_auth_line
$tmp, "$name:$.", $line;
284 sub from_openvpn_key
($) {
287 unless (open $key, '<', $name) {
288 warn "$name:0: open failed: $!\n";
293 while (my $line = <$key>) {
295 if ($line =~ /^-----BEGIN OpenVPN Static key V1-----/) {
298 if ($line =~ /^([0-9a-f]{32})/) {
300 $line =~ s/(..)/chr(hex($1))/ge;
301 check_hash
"$name:$.", $line, "OpenVPN";
304 warn "$name:$.: warning: illegal OpenVPN file format\n";
311 sub openssl_modulus_check
($$) {
312 my ($name, $modulus) = @_;
314 if ($modulus =~ /^Modulus=([A-F0-9]+)$/) {
316 my $length = length($modulus) * 4;
317 if ($length == 1024 || $length == 2048) {
318 my $mod = substr $modulus, length($modulus) - 32;
320 my @mod = $mod =~ /(..)/g;
321 $mod = join('', map { chr(hex($_)) } reverse @mod);
322 check_hash
$name, $mod, "OpenSSL/RSA/$length";
324 warn "$name: warning: no blacklist for OpenSSL/RSA/$length key\n";
327 die "internal error: $modulus\n";
337 unless (open $src, '<', $name) {
338 warn "$name:0: open failed: $!\n";
342 while (my $line = <$src>) {
343 if ($line =~ /^-----BEGIN CERTIFICATE-----/) {
345 $tmp or $tmp = new File
::Temp
;
348 print $tmp $line or die "print: $!";
349 goto LAST
if $line =~ /^-----END CERTIFICATE-----/;
350 } while ($line = <$src>);
352 $tmp->flush or die "flush: $!";
353 my $mod = safe_backtick qw
/openssl x509 -noout -modulus -in/, $tmp;
355 openssl_modulus_check
"$name:$lineno", $mod;
358 warn "$name:$lineno: failed to parse certificate\n";
361 } elsif ($line =~ /^-----BEGIN RSA PRIVATE KEY-----/) {
363 $tmp or $tmp = new File
::Temp
;
366 print $tmp $line or die "print: $!";
367 goto LAST_RSA
if $line =~ /^-----END RSA PRIVATE KEY-----/;
368 } while ($line = <$src>);
370 $tmp->flush or die "flush: $!";
371 my $mod = safe_backtick qw
/openssl rsa -noout -modulus -in/, $tmp;
373 openssl_modulus_check
"$name:$lineno", $mod;
376 warn "$name:$lineno: failed to parse RSA private key\n";
385 sub from_ssh_host
(@
) {
389 my ($name,$aliases,$addrtype,$length,@addrs) = gethostbyname $_;
390 @addrs or warn "warning: host not found: $_\n";
395 push @lines, safe_backtick qw
/ssh-keyscan -t rsa/, @names;
396 push @lines, safe_backtick qw
/ssh-keyscan -t dsa/, @names;
398 my $tmp = new File
::Temp
;
399 for my $line (@lines) {
400 next if $line =~ /^#/;
401 my ($host, $data) = $line =~ /^(\S+) (.*)$/;
402 from_ssh_auth_line
$tmp, $host, $data;
408 my ($name,$passwd,$uid,$gid,
409 $quota,$comment,$gcos,$dir,$shell,$expire) = getpwnam($user);
411 warn "warning: user $user does not exist\n";
414 for my $name (qw
/authorized_keys authorized_keys2
415 known_hosts known_hosts2
416 id_rsa
.pub id_dsa
.pub identity
.pub
/) {
417 my $file = "$dir/.ssh/$name";
418 from_ssh_auth_file
$file if -r
$file;
422 sub from_user_all
() {
423 # This was one loop initially, but does not work with some Perl
427 while (my $name = getpwent) {
431 from_user
$_ for @names;
434 if (@ARGV && $ARGV[0] eq '-c') {
436 $db_file = shift @ARGV if @ARGV;
440 my $cmd = shift @ARGV;
441 if ($cmd eq 'file') {
442 for my $name (@ARGV) {
443 next if from_openvpn_key
$name;
444 next if from_pem
$name;
445 from_ssh_auth_file
$name;
447 } elsif ($cmd eq 'host') {
449 } elsif ($cmd eq 'user') {
451 from_user
$_ for @ARGV;
455 } elsif ($cmd eq 'help') {
458 } elsif ($cmd eq 'version') {
459 print "dowkd $program_version (database $db_version)\n\n$changelog";
462 die "error: invalid command, use \"help\" to get help\n";