1 User-Visible krb5-strength Changes
3 krb5-strength 3.1 (unreleased)
5 A new configuration option, cracklib_maxlen, can be set to skip
6 CrackLib checks of passwords longer than that length. The CrackLib
7 rules were designed in a world in which most passwords were four to
8 eight characters long and tend to spuriously reject longer passwords.
9 SQLite dictionaries work better for checking longer passwords and
10 passphrases. Patch from Jorj Bauer.
12 The require_classes configuration option can now require a particular
13 number of character classes in the password (whatever those classes
14 are). Patch from Toby Blake.
16 Change the error messages returned for passwords that fail strength
17 checking to start with a capital letter. This appears to be more
18 consistent with the error message conventions used inside Heimdal.
20 Change the DB_File::Lock calling method in heimdal-history to work
21 properly with the (buggy) CPAN version of DB_File::Lock, instead of
22 relying on Debian's patched version. Thanks to Bernt Jernberg for the
25 Apply the SuSE patch for a buffer overflow when using duplicate rules
26 to the embedded CrackLib. No duplicating rules are used in the rule
27 set included with this package, and this package doesn't expose the
28 general API, so this was not exploitable, but best to close the latent
29 issue. (The other recent CrackLib vulnerability, CVE-2016-6318,
30 doesn't apply since all the GECOS manipulation code was removed from
31 the embedded CrackLib in this package.)
33 Patch the mkdict and packer in the embedded copy of CrackLib to force
34 C locale when sorting (avoiding a corrupted dictionary) and warn and
35 skip out-of-order words rather than creating a corrupted dictionary.
36 Patch from Mark Sirota.
38 Configuration instrutions are now in the heimdal-history and
39 heimdal-strength man pages and a new krb5-strength man page (which
40 documents configuration of the KDC plugin) instead of the README file
41 to make it more accessible after the software has been installed.
43 Update to rra-c-util 6.2:
45 * Use calloc in preference to malloc wherever appropriate.
46 * Use reallocarray in preference to realloc wherever appropriate.
47 * Suppress warnings from Kerberos headers under make warnings.
48 * Support the embedded Kerberos in Solaris 10 in library probes.
49 * Add missing va_end in xasprintf implementation.
50 * Fix logic in Test::RRA::Automake for new Automake dist checking.
51 * Fix all return-value checks for snprintf to avoid off-by-one error.
52 * Update warning flags for make warnings to GCC 6.1.0.
53 * Fix Test::RRA::Config for new "do" semantics in Perl 5.22.2.
54 * Add a new test for obsolete eyrie.org URLs.
55 * Require Test::Strict 0.25 or newer for Perl strictness checks.
57 Update to C TAP Harness 4.1:
59 * Replace all remaining uses of sprintf.
60 * Test lists may now have comments and blank lines.
61 * runtests -v will show the complete output from a test.
62 * Fix segfault in runtests when given an empty test list.
63 * Tests use C_TAP_SOURCE and C_TAP_BUILD instead of SOURCE and BUILD.
65 krb5-strength 3.0 (2014-03-25)
67 The krb5-strength plugin and heimdal-strength program now support a
68 SQLite password dictionary. This format of dictionary can detect any
69 password within edit distance one of a dictionary word, meaning that
70 the dictionary word can be formed by adding, removing, or changing a
71 single character in the password. A SQLite password dictionary can be
72 used alone or in combination with any of the other supported
73 dictionary types. SQLite dictionary support is based on work by David
76 cdbmake-wordlist has been renamed to krb5-strength-wordlist.
77 Generating CDB dictionaries now requires the -c option; see the
78 documentation for more information. A SQLite database of dictionary
79 words can now be created instead, using the -s option.
81 A password history implementation for Heimdal is now included. This
82 is a separate Perl program, heimdal-history, that stacks with the
83 external program implementation of strength checking. It is not
84 available in the form of a plugin, only as a Heimdal external password
85 quality check. (MIT Kerberos provides its own password history
86 mechanism.) This program has more extensive Perl module dependencies
87 than the other programs in this distribution.
89 A new configuration option, minimum_different, can be set to require
90 that passwords contain at least that many unique characters. This can
91 be used to reject long strings of identical characters or short
92 patterns, which may pass other checks but still be too easy to guess.
94 Update to rra-c-util 5.4:
96 * Fix portable/krb5.h build with a C++ compiler.
97 * Use Lancaster Consensus environment variables to control tests.
98 * Work around perltidy bug that leaves behind stray log files.
100 Update to C TAP Harness 3.0:
102 * Reopen standard input to /dev/null when running a test list.
103 * Don't leak extraneous file descriptors to tests.
105 krb5-strength 2.2 (2013-12-16)
107 More complex character class requirements can be specified with the
108 configuration option require_classes. This option lists the character
109 classes the password must contain. These restrictions may be
110 qualified with password length ranges, allowing the requirements to
111 change with the length of the password. See README for more details
112 and the option syntax.
114 cdbmake-wordlist now supports filtering out words based on maximum
115 length (-L) and arbitrary user-provided regular expressions (-x). It
116 also supports running in filter mode to produce a new wordlist instead
119 Close a file descriptor and memory leak in the included version of
120 CrackLib. This problem was already fixed in CrackLib 2.9.0.
122 Update to rra-c-util 4.12:
124 * Properly check the return status of snprintf and friends.
126 Update to C TAP Harness 2.3:
128 * Suppress lazy plans and test summaries if the test failed with bail.
129 * Add warn_unused_result gcc attributes to relevant functions.
131 krb5-strength 2.1 (2013-10-10)
133 Fix the package build when CDB support is disabled or TinyCDB was not
136 Some of the password rejection error messages have been changed to
137 make them more accurate or comprehensible to the user.
139 Passing --with-tinycdb to configure now correctly makes TinyCDB
140 support mandatory without adding bogus directories to the library and
141 include search paths.
143 krb5-strength 2.0 (2013-10-07)
145 Add support for the MIT Kerberos password quality plugin interface,
146 available in MIT Kerberos 1.9 and later, contributed by Greg Hudson
147 and MIT. Drop the patch for MIT Kerberos 1.4 (and hence support for
148 versions of MIT Kerberos prior to 1.9). A dictionary path set in
149 krb5.conf takes precedence over the dictionary path provided by MIT
150 Kerberos when the plugin is initialized, if both are set, to allow the
151 dict_path configuration setting to be used for other plugins while
152 using a separate dictionary for krb5-strength.
154 The default installation path for this plugin is now
155 /usr/local/lib/krb5/plugins/pwqual/strength.so (for both MIT and
156 Heimdal), assuming a --libdir setting of /usr/local/lib. This may
157 require updates to the Kerberos KDC configuration or moving the plugin
158 when upgrading from earlier versions.
160 Add support for building with TinyCDB and then checking passwords
161 against a CDB database. There is a new password_dictionary_cdb
162 krb5.conf configuration setting that configures a CDB directory to
163 use. The tests with a CDB dictionary are much simpler: passwords are
164 rejected if found in the dictionary either literally, with one or two
165 characters removed from the start or end, or with one character
166 removed from both the start and the end. Both a CrackLib and a CDB
167 dictionary can be specified to check both dictionaries. A new
168 cdbmake-wordlist utility (written in Perl) is included to ease the
169 process of creating a CDB database from a simple word list.
171 A minimum password length can now be enforced directly via the plugin
172 or external check program without relying on CrackLib. To set a
173 minimum password length, add a minimum_length setting to the
174 krb5-strength section of [appdefaults] in krb5.conf.
176 New boolean settings require_ascii_printable and require_non_letter
177 are supported in the krb5-strength setting of [appdefaults] in
178 krb5.conf. The former rejects passwords containing characters other
179 than printable ASCII characters (including space), and the latter
180 requires that passwords contain at least one character that is not a
181 letter (upper or lower case) or a space.
183 The plugin can now be configured without a dictionary, in which case
184 only checks for a password based on the principal and the simpler
185 checks available through the new configuration variables are done.
186 This mode is mostly useful for testing, since such simple checking can
187 more easily be done via less complex password strength configurations.
189 The check for passwords based on the principal now check for passwords
190 formed by reversing or adding numbers before and after each separate
191 component of the principal. This will catch passwords based on the
192 realm or components of the realm, which will often catch passwords
193 based on the name of the local institution.
195 The plugin now sets the Kerberos error message in the context to pass
196 error information, resulting in higher-quality error reporting in the
199 CrackLib checks for passwords where a character is a simple increment
200 or decrement of the previous character. In previous versions, the
201 embedded version of CrackLib allowed at most four such occurrences in
202 the entire password. This results in false positives on long
203 passphrases, since such accidental letter relationships aren't
204 uncommon in human languages. Change the embedded CrackLib to allow
205 one such simple increment for every three characters in the password,
206 which tightens the check somewhat for shorter passwords and loosens it
207 considerably for longer passwords.
209 Expect the Heimdal password strength checking plugin header in
210 kadm5/kadm5-pwcheck.h instead of outside of the kadm5 directory. This
211 is the path used by current versions of Heimdal. Drop support for
212 older versions of Heimdal that don't install this header file.
214 Update to rra-c-util 4.9:
216 * Probe for Kerberos headers using file checks instead of compiles.
217 * Improve probe for the Heimdal libroken library.
218 * Always build with large file support.
219 * Conditionally call AM_PROG_AR for portability to new Autotools.
221 Update to C TAP Harness 2.2:
223 * Allow more easily running single programs under tests/runtests.
224 * Flush the output from the test harness after each test.
226 krb5-strength 1.1 (2012-05-11)
228 Change the minimum password length in the embedded CrackLib to 8.
230 Reject passwords formed from the username portion of the principal
231 with digits appended.
233 In the embedded CrackLib, also check for a duplicated dictionary word.
235 Support linking with the system CrackLib instead of the embedded and
236 stricter copy by passing --with-cracklib to configure.
238 Fix variable sizes in the embedded CrackLib on 64-bit platforms. This
239 may fix interoperability problems with databases created on platforms
240 with a different native integer size. Thanks, Karl Lehnberger and
243 Stop using local in the test suite for portability to Solaris /bin/sh.
245 Update to rra-c-util 4.4:
247 * Use PATH_KRB5_CONFIG to override krb5-config location.
248 * Fix probing for ibm_svc/krb5_svc.h on AIX.
249 * Support Heimdal libraries without libroken, like OpenBSD.
250 * Fix manual Kerberos library probing without transitive dependencies.
251 * Support systems that only have krb5/krb5.h.
252 * Pass --deps to krb5-config in the non-reduced-dependencies case.
253 * Silence __attribute__ warnings on more compilers.
254 * Update warning flags for make warnings.
255 * Flesh out MAINTCLEANFILES to remove autogen results.
256 * Add notices to all files copied from rra-c-util.
258 Update to C TAP Harness 1.12:
260 * Drop is_double from the C TAP library to avoid requiring -lm.
261 * Avoid using local in the shell libtap.sh library.
262 * Silence __attribute__ warnings on more compilers.
263 * runtests now frees all allocated resources on exit.
264 * Fix runtests to still honor SOURCE and -s without BUILD and -b.
265 * Add tests/HOWTO documenting how to add new tests.
266 * Ensure correct output ordering in test results.
267 * Add -h and a better usage message to tests/runtests.
269 krb5-strength 1.0 (2010-02-16)
271 Add heimdal-strength, a program that checks password strength using
272 the protocol for a Heimdal external check program.
274 The shared module now also exports the interface expected by Heimdal's
275 dynamically loaded password strength checking API and can be used as a
276 Heimdal kadmin plugin.
278 Add a new plugin API for MIT Kerberos modelled after the plugin API
279 used for other MIT Kerberos plugins. Thanks to Marcus Watts for
280 substantial research and contributions to the interface design. This
281 work is incomplete in this release, missing the corresponding patch to
284 Fixed the data format written by the included packer program to add
285 enough nul bytes at the end of the data. Previously, there was not
286 enough trailing nul bytes for the expected input format, leading to
287 uninitialized memory reads in the password lookup.
289 Add a test suite using the driver and library from C TAP Harness 1.1.
291 Add portability code for platforms without a working snprintf or other
292 deficiencies and updated the code to take advantage of those
295 krb5-strength 0.5 (2007-07-18)
297 The check of the password against the principal checked against the
298 fully-qualified principal, which is not the usual problem.
299 Additionally check that the password doesn't match the principal with
300 the realm removed or the reverse of that (case-insensitive).
302 krb5-strength 0.4 (2007-03-28)
304 The patches directory was omitted from the distribution. Really
307 krb5-strength 0.3 (2007-03-23)
309 Initial public release. Includes a patch for MIT Kerberos, a slightly
310 modified version of CrackLib, and glue wrapped around CrackLib to make