NEWS

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