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@';
74 my $db_file = 'dowkd.db';
80 warn "notice: creating database, please wait\n";
81 $db = tie
%db, 'DB_File', $db_file, O_RDWR
| O_CREAT
, 0777, $DB_BTREE
82 or die "error: could not open database: $!\n";
84 $db{''} = $db_version;
85 while (my $line = <DATA
>) {
86 next if $line =~ /^\**$/;
88 $line =~ /^[0-9a-f]{32}$/ or die "error: invalid data line";
89 $line =~ s/(..)/chr(hex($1))/ge;
98 $db = tie
%db, 'DB_File', $db_file, O_RDONLY
, 0777, $DB_BTREE
99 or die "error: could not open database: $!\n";
100 my $stored_version = $db{''};
101 $stored_version && $stored_version eq $db_version or create_db
;
108 sub safe_backtick
(@
) {
111 open $fh, '-|', @args
112 or die "error: failed to spawn $args[0]: $!\n";
118 @result = scalar(<$fh>);
121 $?
== 0 or return undef;
130 my $keys_vulnerable = 0;
133 print STDERR
"summary: keys found: $keys_found, weak keys: $keys_vulnerable\n";
136 sub check_hash
($$;$) {
137 my ($name, $hash, $descr) = @_;
139 if (exists $db{$hash}) {
141 $descr = $descr ?
" ($descr)" : '';
142 print "$name: weak key$descr\n";
146 sub ssh_fprint_file
($) {
148 my $data = safe_backtick qw
/ssh-keygen -l -f/, $name;
149 defined $data or return ();
150 my @data = $data =~ /^(\d+) ([0-9a-f]{2}(?::[0-9a-f]{2}){15})/;
151 return @data if @data == 2;
155 sub ssh_fprint_check
($$$$) {
156 my ($name, $type, $length, $hash) = @_;
157 $type =~ /^(?:rsa1?|dsa)\z/ or die;
158 if (($type eq 'rsa' && ($length == 1024 || $length == 2048))
159 || ($type eq 'dsa' && $length == 1024)
160 || ($type eq 'rsa1' && $length == 1024)) {
162 $hash =~ s/(..)/chr(hex($1))/ge;
163 check_hash
$name, $hash, "OpenSSH/$type/$length";
164 } elsif ($type eq 'dsa') {
165 print "$name: $length bits DSA key not recommended\n";
167 warn "$name: warning: no blacklist for $type/$length key\n";
173 seek $tmp, 0, 0 or die "seek: $!";
174 truncate $tmp, 0 or die "truncate: $!";
177 sub cleanup_ssh_auth_line
($) {
180 $line =~ /^(?:ssh-(?:rsa|dss)\s|\d+\s+\d+\s+\d)/ and return $line;
183 if ($line =~ /^\s+(.*)/) {
187 if ($line =~ /^"(.*)/) {
191 if ($line =~ /^\\.(.*)/) {
192 # It doesn't matter if we don't deal with \000 properly, we
193 # just need to defuse the backslash character.
197 if ($line =~ /^[a-zA-Z0-9_=+-]+(.*)/) {
198 # Skip multiple harmless characters in one go.
202 if ($line =~ /^.(.*)/) {
203 # Other characters are stripped one by one.
207 return undef; # empty string, no key found
210 if ($line =~ /^"(.*)/) {
214 if ($line =~ /^\\.(.*)/) {
215 # See above, defuse the backslash.
219 if ($line =~ /^[^\\"]+(.*)/) {
223 return undef; # missing closing double quote
226 $line =~ /^(?:ssh-(?:rsa|dss)\s|\d+\s+\d+\s+\d)/ and return $line;
230 sub derive_ssh_auth_type
($) {
232 $line =~ /^ssh-rsa\s/ and return 'rsa';
233 $line =~ /^ssh-dss\s/ and return 'dsa';
234 $line =~ /^\d+\s/ and return 'rsa1';
238 sub from_ssh_auth_line
($$$) {
239 my ($tmp, $name, $line) = @_;
241 return if $line =~ m/^\s*(#|$)/;
244 my $l = cleanup_ssh_auth_line
$line;
248 my $type = derive_ssh_auth_type
$line;
251 print $tmp "$line\n" or die "print: $!";
252 $tmp->flush or die "flush: $!";
253 my ($length, $hash) = ssh_fprint_file
"$tmp";
254 if ($length && $hash) {
255 ssh_fprint_check
"$name", $type, $length, $hash;
260 warn "$name: warning: unparsable line\n";
263 sub from_ssh_auth_file
($) {
266 unless (open $auth, '<', $name) {
267 warn "$name:0: error: open failed: $!\n";
271 my $tmp = new File
::Temp
;
272 while (my $line = <$auth>) {
273 from_ssh_auth_line
$tmp, "$name:$.", $line;
277 sub from_openvpn_key
($) {
280 unless (open $key, '<', $name) {
281 warn "$name:0: open failed: $!\n";
286 while (my $line = <$key>) {
288 if ($line =~ /^-----BEGIN OpenVPN Static key V1-----/) {
291 if ($line =~ /^([0-9a-f]{32})/) {
293 $line =~ s/(..)/chr(hex($1))/ge;
294 check_hash
"$name:$.", $line, "OpenVPN";
297 warn "$name:$.: warning: illegal OpenVPN file format\n";
304 sub openssl_modulus_check
($$) {
305 my ($name, $modulus) = @_;
307 if ($modulus =~ /^Modulus=([A-F0-9]+)$/) {
309 my $length = length($modulus) * 4;
310 if ($length == 1024 || $length == 2048) {
311 my $mod = substr $modulus, length($modulus) - 32;
313 my @mod = $mod =~ /(..)/g;
314 $mod = join('', map { chr(hex($_)) } reverse @mod);
315 check_hash
$name, $mod, "OpenSSL/RSA/$length";
317 warn "$name: warning: no blacklist for OpenSSL/RSA/$length key\n";
320 die "internal error: $modulus\n";
330 unless (open $src, '<', $name) {
331 warn "$name:0: open failed: $!\n";
335 while (my $line = <$src>) {
336 if ($line =~ /^-----BEGIN CERTIFICATE-----/) {
338 $tmp or $tmp = new File
::Temp
;
341 print $tmp $line or die "print: $!";
342 goto LAST
if $line =~ /^-----END CERTIFICATE-----/;
343 } while ($line = <$src>);
345 $tmp->flush or die "flush: $!";
346 my $mod = safe_backtick qw
/openssl x509 -noout -modulus -in/, $tmp;
348 openssl_modulus_check
"$name:$lineno", $mod;
351 warn "$name:$lineno: failed to parse certificate\n";
354 } elsif ($line =~ /^-----BEGIN RSA PRIVATE KEY-----/) {
356 $tmp or $tmp = new File
::Temp
;
359 print $tmp $line or die "print: $!";
360 goto LAST_RSA
if $line =~ /^-----END RSA PRIVATE KEY-----/;
361 } while ($line = <$src>);
363 $tmp->flush or die "flush: $!";
364 my $mod = safe_backtick qw
/openssl rsa -noout -modulus -in/, $tmp;
366 openssl_modulus_check
"$name:$lineno", $mod;
369 warn "$name:$lineno: failed to parse RSA private key\n";
378 sub from_ssh_host
(@
) {
382 my ($name,$aliases,$addrtype,$length,@addrs) = gethostbyname $_;
383 @addrs or warn "warning: host not found: $_\n";
388 push @lines, safe_backtick qw
/ssh-keyscan -t rsa/, @names;
389 push @lines, safe_backtick qw
/ssh-keyscan -t dsa/, @names;
391 my $tmp = new File
::Temp
;
392 for my $line (@lines) {
393 next if $line =~ /^#/;
394 my ($host, $data) = $line =~ /^(\S+) (.*)$/;
395 from_ssh_auth_line
$tmp, $host, $data;
401 my ($name,$passwd,$uid,$gid,
402 $quota,$comment,$gcos,$dir,$shell,$expire) = getpwnam($user);
404 warn "warning: user $user does not exist\n";
407 for my $name (qw
/authorized_keys authorized_keys2
408 known_hosts known_hosts2
409 id_rsa
.pub id_dsa
.pub identity
.pub
/) {
410 my $file = "$dir/.ssh/$name";
411 from_ssh_auth_file
$file if -r
$file;
415 sub from_user_all
() {
416 # This was one loop initially, but does not work with some Perl
420 while (my $name = getpwent) {
424 from_user
$_ for @names;
427 if (@ARGV && $ARGV[0] eq '-c') {
429 $db_file = shift @ARGV if @ARGV;
433 my $cmd = shift @ARGV;
434 if ($cmd eq 'file') {
435 for my $name (@ARGV) {
436 next if from_openvpn_key
$name;
437 next if from_pem
$name;
438 from_ssh_auth_file
$name;
440 } elsif ($cmd eq 'host') {
442 } elsif ($cmd eq 'user') {
444 from_user
$_ for @ARGV;
448 } elsif ($cmd eq 'help') {
451 } elsif ($cmd eq 'version') {
452 print "dowkd $program_version (database $db_version)\n";
455 die "error: invalid command, use \"help\" to get help\n";