NEWS

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