NEWS

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