NEWS

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