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 $db{''} = $db_version;
89 while (my $line = <DATA
>) {
90 next if $line =~ /^\**$/;
92 $line =~ /^[0-9a-f]{32}$/ or die "error: invalid data line";
93 $line =~ s/(..)/chr(hex($1))/ge;
102 $db = tie
%db, 'DB_File', $db_file, O_RDONLY
, 0777, $DB_BTREE
103 or die "error: could not open database: $!\n";
104 my $stored_version = $db{''};
105 $stored_version && $stored_version eq $db_version or create_db
;
112 sub safe_backtick
(@
) {
115 open $fh, '-|', @args
116 or die "error: failed to spawn $args[0]: $!\n";
122 @result = scalar(<$fh>);
125 $?
== 0 or return undef;
134 my $keys_vulnerable = 0;
137 print STDERR
"summary: keys found: $keys_found, weak keys: $keys_vulnerable\n";
140 sub check_hash
($$;$) {
141 my ($name, $hash, $descr) = @_;
143 if (exists $db{$hash}) {
145 $descr = $descr ?
" ($descr)" : '';
146 print "$name: weak key$descr\n";
150 sub ssh_fprint_file
($) {
152 my $data = safe_backtick qw
/ssh-keygen -l -f/, $name;
153 defined $data or return ();
154 my @data = $data =~ /^(\d+) ([0-9a-f]{2}(?::[0-9a-f]{2}){15})/;
155 return @data if @data == 2;
159 sub ssh_fprint_check
($$$$) {
160 my ($name, $type, $length, $hash) = @_;
161 $type =~ /^(?:rsa1?|dsa)\z/ or die;
163 && ($length == 1024 || $length == 2048 || $length == 4096))
164 || ($type eq 'dsa' && $length == 1024)
165 || ($type eq 'rsa1' && $length == 1024)) {
167 $hash =~ s/(..)/chr(hex($1))/ge;
168 check_hash
$name, $hash, "OpenSSH/$type/$length";
169 } elsif ($type eq 'dsa') {
170 print "$name: $length bits DSA key not recommended\n";
172 warn "$name: warning: no blacklist for $type/$length key\n";
178 seek $tmp, 0, 0 or die "seek: $!";
179 truncate $tmp, 0 or die "truncate: $!";
182 sub cleanup_ssh_auth_line
($) {
185 $line =~ /^(?:ssh-(?:rsa|dss)\s|\d+\s+\d+\s+\d)/ and return $line;
188 if ($line =~ /^\s+(.*)/) {
192 if ($line =~ /^"(.*)/) {
196 if ($line =~ /^\\.(.*)/) {
197 # It doesn't matter if we don't deal with \000 properly, we
198 # just need to defuse the backslash character.
202 if ($line =~ /^[a-zA-Z0-9_=+-]+(.*)/) {
203 # Skip multiple harmless characters in one go.
207 if ($line =~ /^.(.*)/) {
208 # Other characters are stripped one by one.
212 return undef; # empty string, no key found
215 if ($line =~ /^"(.*)/) {
219 if ($line =~ /^\\.(.*)/) {
220 # See above, defuse the backslash.
224 if ($line =~ /^[^\\"]+(.*)/) {
228 return undef; # missing closing double quote
231 $line =~ /^(?:ssh-(?:rsa|dss)\s|\d+\s+\d+\s+\d)/ and return $line;
235 sub derive_ssh_auth_type
($) {
237 $line =~ /^ssh-rsa\s/ and return 'rsa';
238 $line =~ /^ssh-dss\s/ and return 'dsa';
239 $line =~ /^\d+\s/ and return 'rsa1';
243 sub from_ssh_auth_line
($$$) {
244 my ($tmp, $name, $line) = @_;
246 return if $line =~ m/^\s*(#|$)/;
249 my $l = cleanup_ssh_auth_line
$line;
253 my $type = derive_ssh_auth_type
$line;
256 print $tmp "$line\n" or die "print: $!";
257 $tmp->flush or die "flush: $!";
258 my ($length, $hash) = ssh_fprint_file
"$tmp";
259 if ($length && $hash) {
260 ssh_fprint_check
"$name", $type, $length, $hash;
265 warn "$name: warning: unparsable line\n";
268 sub from_ssh_auth_file
($) {
271 unless (open $auth, '<', $name) {
272 warn "$name:0: error: open failed: $!\n";
276 my $tmp = new File
::Temp
;
277 while (my $line = <$auth>) {
278 from_ssh_auth_line
$tmp, "$name:$.", $line;
282 sub from_openvpn_key
($) {
285 unless (open $key, '<', $name) {
286 warn "$name:0: open failed: $!\n";
291 while (my $line = <$key>) {
293 if ($line =~ /^-----BEGIN OpenVPN Static key V1-----/) {
296 if ($line =~ /^([0-9a-f]{32})/) {
298 $line =~ s/(..)/chr(hex($1))/ge;
299 check_hash
"$name:$.", $line, "OpenVPN";
302 warn "$name:$.: warning: illegal OpenVPN file format\n";
309 sub openssl_modulus_check
($$) {
310 my ($name, $modulus) = @_;
312 if ($modulus =~ /^Modulus=([A-F0-9]+)$/) {
314 my $length = length($modulus) * 4;
315 if ($length == 1024 || $length == 2048) {
316 my $mod = substr $modulus, length($modulus) - 32;
318 my @mod = $mod =~ /(..)/g;
319 $mod = join('', map { chr(hex($_)) } reverse @mod);
320 check_hash
$name, $mod, "OpenSSL/RSA/$length";
322 warn "$name: warning: no blacklist for OpenSSL/RSA/$length key\n";
325 die "internal error: $modulus\n";
335 unless (open $src, '<', $name) {
336 warn "$name:0: open failed: $!\n";
340 while (my $line = <$src>) {
341 if ($line =~ /^-----BEGIN CERTIFICATE-----/) {
343 $tmp or $tmp = new File
::Temp
;
346 print $tmp $line or die "print: $!";
347 goto LAST
if $line =~ /^-----END CERTIFICATE-----/;
348 } while ($line = <$src>);
350 $tmp->flush or die "flush: $!";
351 my $mod = safe_backtick qw
/openssl x509 -noout -modulus -in/, $tmp;
353 openssl_modulus_check
"$name:$lineno", $mod;
356 warn "$name:$lineno: failed to parse certificate\n";
359 } elsif ($line =~ /^-----BEGIN RSA PRIVATE KEY-----/) {
361 $tmp or $tmp = new File
::Temp
;
364 print $tmp $line or die "print: $!";
365 goto LAST_RSA
if $line =~ /^-----END RSA PRIVATE KEY-----/;
366 } while ($line = <$src>);
368 $tmp->flush or die "flush: $!";
369 my $mod = safe_backtick qw
/openssl rsa -noout -modulus -in/, $tmp;
371 openssl_modulus_check
"$name:$lineno", $mod;
374 warn "$name:$lineno: failed to parse RSA private key\n";
383 sub from_ssh_host
(@
) {
387 my ($name,$aliases,$addrtype,$length,@addrs) = gethostbyname $_;
388 @addrs or warn "warning: host not found: $_\n";
393 push @lines, safe_backtick qw
/ssh-keyscan -t rsa/, @names;
394 push @lines, safe_backtick qw
/ssh-keyscan -t dsa/, @names;
396 my $tmp = new File
::Temp
;
397 for my $line (@lines) {
398 next if $line =~ /^#/;
399 my ($host, $data) = $line =~ /^(\S+) (.*)$/;
400 from_ssh_auth_line
$tmp, $host, $data;
406 my ($name,$passwd,$uid,$gid,
407 $quota,$comment,$gcos,$dir,$shell,$expire) = getpwnam($user);
409 warn "warning: user $user does not exist\n";
412 for my $name (qw
/authorized_keys authorized_keys2
413 known_hosts known_hosts2
414 id_rsa
.pub id_dsa
.pub identity
.pub
/) {
415 my $file = "$dir/.ssh/$name";
416 from_ssh_auth_file
$file if -r
$file;
420 sub from_user_all
() {
421 # This was one loop initially, but does not work with some Perl
425 while (my $name = getpwent) {
429 from_user
$_ for @names;
432 if (@ARGV && $ARGV[0] eq '-c') {
434 $db_file = shift @ARGV if @ARGV;
438 my $cmd = shift @ARGV;
439 if ($cmd eq 'file') {
440 for my $name (@ARGV) {
441 next if from_openvpn_key
$name;
442 next if from_pem
$name;
443 from_ssh_auth_file
$name;
445 } elsif ($cmd eq 'host') {
447 } elsif ($cmd eq 'user') {
449 from_user
$_ for @ARGV;
453 } elsif ($cmd eq 'help') {
456 } elsif ($cmd eq 'version') {
457 print "dowkd $program_version (database $db_version)\n\n$changelog";
460 die "error: invalid command, use \"help\" to get help\n";