| 1 |
User-Visible krb5-sync Changes |
| 2 |
|
| 3 |
krb5-sync 3.1 (2015-08-18) |
| 4 |
|
| 5 |
In krb5-sync-backend silent mode, fix the ignore regex for missing |
| 6 |
users and report unsuppressed errors properly with an ending newline. |
| 7 |
|
| 8 |
Update to rra-c-util 5.8: |
| 9 |
|
| 10 |
* Support the Solaris 10 embedded Kerberos implementation. |
| 11 |
* Use calloc or reallocarray instead of malloc. |
| 12 |
* Fix compilation with a C++ compiler. |
| 13 |
|
| 14 |
Update to C TAP Harness 3.4: |
| 15 |
|
| 16 |
* Display verbose test results with -v or C_TAP_VERBOSE. |
| 17 |
* Reopen standard input to /dev/null when running a test list. |
| 18 |
* Don't leak extraneous file descriptors to tests. |
| 19 |
|
| 20 |
krb5-sync 3.0 (2013-12-09) |
| 21 |
|
| 22 |
The default installed module name has been changed to sync.so from |
| 23 |
krb5_sync.so, since the krb5 part is redundant in the Kerberos plugin |
| 24 |
context. This will require configuration changes for existing users |
| 25 |
to load the new plugin path name. |
| 26 |
|
| 27 |
The meaning of the ad_ldap_base configuration option has changed, and |
| 28 |
it's now mandatory for status synchronization. This setting should |
| 29 |
now contain the full DN of the tree in Active Directory where account |
| 30 |
information is stored (such as cn=Accounts,dc=example,dc=com). |
| 31 |
Previously, the dc components should be omitted and were derived from |
| 32 |
the realm; this is no longer done. If this configuration option is |
| 33 |
not set, principal status will not be synchronized to Active |
| 34 |
Directory. |
| 35 |
|
| 36 |
Drop support for MIT Kerberos versions prior to 1.9. All major |
| 37 |
distributions are now shipping with a newer version of MIT Kerberos |
| 38 |
than this, and supporting older versions requires supporting patches |
| 39 |
and maintaining handicapped internal APIs. MIT Kerberos 1.9 and later |
| 40 |
do not require patches to use this module. Patches for Heimdal are |
| 41 |
still provided. |
| 42 |
|
| 43 |
Add a new string krb5.conf option, ad_base_instance, which, if set, |
| 44 |
changes the way that password synchronization is handled. When this |
| 45 |
option is set, the password for the principal formed by appending that |
| 46 |
instance to a base principal is propagated to Active Directory as the |
| 47 |
password for the base principal. For example, if this is set to the |
| 48 |
string "windows", the password of the principal "user/windows" is |
| 49 |
propagated to Active Directory as the password for the principal |
| 50 |
"user" and password changes for the principal "user" are ignored. |
| 51 |
This special behavior only happens if "user/windows" exists in the |
| 52 |
local Kerberos KDC database; if not, password propagation for the |
| 53 |
principal "user" happens normally, just as if this option weren't set. |
| 54 |
This allows the Active Directory principal to be treated as an |
| 55 |
instance rather than a main account for specific users without |
| 56 |
affecting behavior for other users. |
| 57 |
|
| 58 |
Add a new boolean krb5.conf option, ad_queue_only, which, if set to |
| 59 |
true, forces all changes to be queued even if there are no conflicting |
| 60 |
changes already queued. The changes can then be processed later with |
| 61 |
krb5-sync-backend. This can be useful if real-time updates to Active |
| 62 |
Directory cause performance issues in kadmind or kpasswdd. kpasswd |
| 63 |
clients in particular are often intolerant of delays. |
| 64 |
|
| 65 |
Add a new boolean krb5.conf option, syslog, which can be set to false |
| 66 |
to suppress syslog logging of the actions taken by the plugin and |
| 67 |
error messages leading to queuing the change. Always log the error |
| 68 |
that leads to queuing a status change. |
| 69 |
|
| 70 |
Any time an Active Directory password change fails, queue the change |
| 71 |
instead of failing it, rather than trying to distinguish between local |
| 72 |
errors that should fail the change and errors that should be queued. |
| 73 |
The previous logic was very Stanford-specific. |
| 74 |
|
| 75 |
krb5-sync-backend now requires the IPC::Run and Net::Remctl::Backend |
| 76 |
modules be installed. The former is available from CPAN, and the |
| 77 |
latter is available from the remctl package (version 3.4 or later). |
| 78 |
|
| 79 |
krb5-sync-backend supports a new flag, -d, which specifies the |
| 80 |
location of the queue directory, changing the default of |
| 81 |
/var/spool/krb5-sync. |
| 82 |
|
| 83 |
When processing events in krb5-sync-backend, skip event files which no |
| 84 |
longer exist by the time we get to them. This makes krb5-sync-backend |
| 85 |
more robust against multiple copies running at the same time. |
| 86 |
|
| 87 |
Update to rra-c-util 4.12: |
| 88 |
|
| 89 |
* Better error messages from xasprintf on failure to format output. |
| 90 |
* Check return status of vsnprintf properly. |
| 91 |
* Significant improvements to POD tests. |
| 92 |
* Avoid leaking a dummy symbol from the portability layer. |
| 93 |
* Probe for Kerberos headers with file existence checks. |
| 94 |
|
| 95 |
Update to C TAP Harness 2.3: |
| 96 |
|
| 97 |
* runtests now treats the command line as a list of tests by default. |
| 98 |
* The full test executable path can now be passed to runtests -o. |
| 99 |
* Improved harness output for tests with lazy plans. |
| 100 |
* Improved harness output to a terminal for some abort cases. |
| 101 |
* Flush harness output after each test even when not on a terminal. |
| 102 |
* bail and sysbail now exit with status 255 to match Test::More. |
| 103 |
* Suppress lazy plans and test summaries if the test failed with bail. |
| 104 |
* Add warn_unused_result gcc attributes to relevant functions. |
| 105 |
|
| 106 |
krb5-sync 2.3 (2012-09-18) |
| 107 |
|
| 108 |
When handling password changes from MIT Kerberos, quietly ignore |
| 109 |
changes where the password is NULL. These are key randomizations, |
| 110 |
such as from addprinc -randkey, which this module inherently can't do |
| 111 |
anything with. |
| 112 |
|
| 113 |
The plugin is now installed in a kadm5_hook subdirectory under |
| 114 |
krb5/plugins (under libdir in turn), matching the plugin layout used |
| 115 |
by MIT Kerberos. |
| 116 |
|
| 117 |
When krb5-sync-backend is running in silent mode, ignore "Operation |
| 118 |
not permitted" errors from krb5_set_password. Heimdal 1.5.2 returns |
| 119 |
this error from Active Directory when attempting to change the |
| 120 |
password of an account that does not exist. |
| 121 |
|
| 122 |
Properly pass Kerberos preprocessor flags to the compiler when |
| 123 |
building the plugin. |
| 124 |
|
| 125 |
Update to rra-c-util 4.6: |
| 126 |
|
| 127 |
* Pass --deps to krb5-config except with --enable-reduced-depends. |
| 128 |
* Do not assume string is nul-terminated in replacement strdup. |
| 129 |
* Avoid using local in the shell TAP library for Solaris portability. |
| 130 |
* Silence __attribute__ warnings on more compilers. |
| 131 |
|
| 132 |
Update to C TAP Harness 1.12: |
| 133 |
|
| 134 |
* Suppress plan and summary if bail is called before any tests run. |
| 135 |
* Only use feature-test macros when requested or built with gcc -ansi. |
| 136 |
* Drop is_double from the C TAP library to avoid requiring -lm. |
| 137 |
* Avoid using local in the shell libtap.sh library. |
| 138 |
* Silence __attribute__ warnings on more compilers. |
| 139 |
|
| 140 |
krb5-sync 2.2 (2012-01-10) |
| 141 |
|
| 142 |
The name of the plugin is now krb5_sync.so instead of passwd_update.so |
| 143 |
and is installed under /usr/local/lib/krb5/plugins by default. The |
| 144 |
KDC configuration for the name of the module to load will need to |
| 145 |
change accordingly. |
| 146 |
|
| 147 |
Add support for the new libkadm5 hooks provided by MIT Kerberos 1.9. |
| 148 |
With that version and later, no patch to MIT Kerberos is required to |
| 149 |
use this code. Thanks to Sam Hartman for the patch. |
| 150 |
|
| 151 |
Current MIT Kerberos calls the password change hook with a NULL |
| 152 |
password in the -randkey case, which neither the module nor the patch |
| 153 |
were prepared to handle. Pass a password of NULL and a length of 0 |
| 154 |
from the MIT patch to the plugin in this case and, for now, quietly |
| 155 |
skip -randkey key changes in the plugin since we cannot currently do |
| 156 |
anything sensible with them. Thanks, Dominic Hargreaves. |
| 157 |
|
| 158 |
krb5-sync-backend's password command now accepts the password on |
| 159 |
standard input in addition to accepting it as a command-line |
| 160 |
parameter. This is more secure since the password is not exposed to |
| 161 |
other users of the same system. |
| 162 |
|
| 163 |
In krb5-sync, diagnose an incomplete krb5.conf configuration and |
| 164 |
report an error indicating the missing setting rather than |
| 165 |
segfaulting. |
| 166 |
|
| 167 |
Fix the program name used by the plugin to load initial credential |
| 168 |
default flags on Heimdal to be krb5-sync, not k5start. |
| 169 |
|
| 170 |
Remove the patch for Stanford's patched MIT Kerberos 1.4.4 from the |
| 171 |
distribution. This has not been used at Stanford for years and is old |
| 172 |
enough that it's unlikely to be of interest to others. |
| 173 |
|
| 174 |
Add --with-ldap, --with-ldap-include, and --with-ldap-lib flags to |
| 175 |
configure to specify the locations of the OpenLDAP libraries if |
| 176 |
they're not on the standard search path. |
| 177 |
|
| 178 |
Add a basic test suite framework. This currently only tests |
| 179 |
documentation and low-level supporting libraries. |
| 180 |
|
| 181 |
Update to rra-c-util 4.1: |
| 182 |
|
| 183 |
* Build on systems where krb5/krb5.h exists but krb5.h does not. |
| 184 |
* Kerberos probes no longer assume transitive library dependencies. |
| 185 |
* Fix removal of /usr/include from Kerberos CPPFLAGS. |
| 186 |
* Include strings.h where present for more POSIX string functions. |
| 187 |
* Avoid passing a NULL context to krb5_get_error_message. |
| 188 |
* Fix a data type issue in the messages utility library. |
| 189 |
* Fix incorrect __attribute notations in the utility library. |
| 190 |
* Add replacement for a missing strndup (such as on Mac OS X). |
| 191 |
* Add krb5_appdefault_* replacement for AIX's bundled Kerberos. |
| 192 |
* Add notices to all files copied from rra-c-util. |
| 193 |
|
| 194 |
krb5-sync 2.1 (2010-08-26) |
| 195 |
|
| 196 |
Queue password changes on any failure to change the password in Active |
| 197 |
Directory, rather than only on failures returned as an error in the |
| 198 |
password change protocol. Heimdal 1.3.2 will return an error about a |
| 199 |
missing service location plugin instead of the last error from Active |
| 200 |
Directory, causing the plugin to fail the whole password change rather |
| 201 |
than queuing it as intended for unknown users. |
| 202 |
|
| 203 |
Fix suppression of some error messages in krb5-sync-backend when the |
| 204 |
-s flag was given. This was broken by adding the krb5-sync: prefix to |
| 205 |
error messages from krb5-sync. |
| 206 |
|
| 207 |
Suppress the Heimdal service_locator plugin error message in |
| 208 |
krb5-sync-backend when the -s flag was given. |
| 209 |
|
| 210 |
Add a version of the krb5-sync patch for MIT Kerberos 1.8.3. This is |
| 211 |
a simple forward-port of the 1.4.4 patch and doesn't use any of the |
| 212 |
new plugin capabilities or configuration. Thanks to Sam Hartman for |
| 213 |
the port. |
| 214 |
|
| 215 |
The Active Directory status manipulation code no longer uses |
| 216 |
deprecated OpenLDAP library functions. |
| 217 |
|
| 218 |
Update to rra-c-util 2.6: |
| 219 |
|
| 220 |
* Fix portability to bundled Heimdal on OpenBSD. |
| 221 |
* Fix portability for missing krb5_get_init_creds_opt_free. |
| 222 |
|
| 223 |
krb5-sync 2.0 (2010-02-15) |
| 224 |
|
| 225 |
Dropped support for AFS synchronization and all Kerberos v4 support. |
| 226 |
This package now only synchronizes with Active Directory. |
| 227 |
|
| 228 |
Add plugin support for the proposed kadmin hooks for Heimdal and |
| 229 |
ported the code to Heimdal as well as MIT Kerberos. Add a patch for |
| 230 |
Heimdal 1.3.1 to the patches directory. The implementation for |
| 231 |
Heimdal is preliminary and will change in later releases. |
| 232 |
|
| 233 |
Add an ad_ldap_base configuration option to specify the base DN for |
| 234 |
Active Directory. Patch from Andreas Johansson. |
| 235 |
|
| 236 |
Ignore connection timeouts from AD when running the queue with |
| 237 |
krb5-sync-backend in silent mode. |
| 238 |
|
| 239 |
Improve error reporting in the standalone krb5-sync utility. |
| 240 |
|
| 241 |
Enable Automake silent rules. For a quieter build, pass the |
| 242 |
--enable-silent-rules option to configure or build with make V=0. |
| 243 |
|
| 244 |
Add portability code for platforms without a working snprintf or other |
| 245 |
deficiencies and updated the code to take advantage of those |
| 246 |
guarantees. |
| 247 |
|
| 248 |
Update Kerberos Autoconf macros from rra-c-util 2.3: |
| 249 |
|
| 250 |
* Check for networking libraries before Kerberos libraries. |
| 251 |
* Sanity-check the results of krb5-config before proceeding. |
| 252 |
* Fall back on manual probing if krb5-config doesn't work. |
| 253 |
* Prefer KRB5_CONFIG from the environment. |
| 254 |
* If krb5-config isn't executable, don't use it. |
| 255 |
* Add --with-krb5-lib and --with-krb5-include configure options. |
| 256 |
|
| 257 |
krb5-sync 1.2 (2007-12-25) |
| 258 |
|
| 259 |
Don't call rx_Finalize after every synchronization with an AFS |
| 260 |
kaserver. This isn't correct and leaks threads. Only call |
| 261 |
rx_Finalize when shutting down the entire module. |
| 262 |
|
| 263 |
The AFS synchronization code is now only built if requested using the |
| 264 |
--with-afs flag to configure, allowing the package to be built at |
| 265 |
sites that don't use AFS. |
| 266 |
|
| 267 |
Add the purge command to krb5-sync-backend, which removes all queued |
| 268 |
actions last modified more than some number of days in the past. |
| 269 |
|
| 270 |
Use the new Kerberos error message APIs to retrieve error messages, |
| 271 |
giving more complete errors in current versions of Kerberos. This is |
| 272 |
also necessary in the long run for Heimdal support, although the |
| 273 |
package in general doesn't support Heimdal yet. |
| 274 |
|
| 275 |
krb5-sync 1.1 (2007-08-27) |
| 276 |
|
| 277 |
MIT Kerberos kadmind (at least in 1.4.4) doesn't always nul-terminate |
| 278 |
principal instances when processing kpasswd requests. The instance |
| 279 |
verification also didn't correctly handle some combinations of |
| 280 |
allowed instances. Rewrite the check routine to cope with all of |
| 281 |
these issues. |
| 282 |
|
| 283 |
krb5-sync 1.0 (2007-08-13) |
| 284 |
|
| 285 |
Add a new option to krb5-sync-backend to tell process to filter out |
| 286 |
successful messages from krb5-sync and common errors that mean the |
| 287 |
account doesn't exist in Active Directory. Also add support for the |
| 288 |
-h flag. |
| 289 |
|
| 290 |
Fix the logging output from Active Directory account status changes |
| 291 |
to not append the realm twice. |
| 292 |
|
| 293 |
Send krb5-sync logging to LOG_AUTH instead of LOG_AUTHPRIV to |
| 294 |
really match what kadmind does. |
| 295 |
|
| 296 |
krb5-sync 0.7 (2007-08-07) |
| 297 |
|
| 298 |
Log a message to syslog from the plugin when password changes fail |
| 299 |
and we have to queue. Otherwise, when the queuing is successful, |
| 300 |
we never log the original error. |
| 301 |
|
| 302 |
Work around the behavior of MIT Kerberos's Kerberos v4 compat |
| 303 |
libraries that left garbage in the instance field after parsing an |
| 304 |
unqualified principal with no instance. Only of interest to users |
| 305 |
doing AFS password propagation. |
| 306 |
|
| 307 |
Log krb5-sync operations to LOG_AUTHPRIV (LOG_AUTH if that doesn't |
| 308 |
exist) so that they go to the same place as the kadmind logs do by |
| 309 |
default. |
| 310 |
|
| 311 |
Rename the provided patch to document that it only applies over top |
| 312 |
of the krb5-strength patches and provide a patch that applies to a |
| 313 |
stock MIT Kerberos 1.4.4 tree. |
| 314 |
|
| 315 |
krb5-sync 0.6 (2007-07-13) |
| 316 |
|
| 317 |
Add support for propagating selected non-empty instances into the AFS |
| 318 |
and Active Directory environments rather than ignoring all principals |
| 319 |
with non-empty instances. |
| 320 |
|
| 321 |
Fix the Active Directory password change component to not overwrite |
| 322 |
the realm of the principal passed from kadmind so that logging of AFS |
| 323 |
password change attempts will contain the local realm instead of the |
| 324 |
AD realm. |
| 325 |
|
| 326 |
When enabling or disabling accounts in Active Directory, look them up |
| 327 |
by userPrincipalName instead of sAMAccountName. |
| 328 |
|
| 329 |
Correctly strip the realm for queuing even for principals containing |
| 330 |
escaped @ characters. |
| 331 |
|
| 332 |
Add Active Directory configuration instructions. Thanks, Ross |
| 333 |
Wilper. |
| 334 |
|
| 335 |
krb5-sync 0.5 (2007-03-22) |
| 336 |
|
| 337 |
Obtain new AFS tokens for each operation rather than reusing the |
| 338 |
existing token since ka_GetAdminToken isn't smart enough to realize |
| 339 |
that the old token has expired. |
| 340 |
|
| 341 |
Queue AD password changes rather than rejecting the change if the |
| 342 |
error message from the password change may indicate that the user |
| 343 |
doesn't exist in AD. |
| 344 |
|
| 345 |
Queue AD password changes if there is already an AD password change |
| 346 |
queued rather than rejecting the change. |
| 347 |
|
| 348 |
Include the username in status messages from the krb5-sync |
| 349 |
command-line utility. |
| 350 |
|
| 351 |
krb5-sync 0.4 (2007-01-23) |
| 352 |
|
| 353 |
The krb5-sync command-line utility now supports taking its actions |
| 354 |
from a file instead of the command-line. Those queue files can also |
| 355 |
specify changing the password only in Active Directory or only in an |
| 356 |
AFS kaserver. |
| 357 |
|
| 358 |
The plugin will now queue account status changes and AFS password |
| 359 |
changes if making the change fails or if a change of that type is |
| 360 |
already queued for that account. |
| 361 |
|
| 362 |
Add a new Perl script, krb5-sync-backend, which supports listing and |
| 363 |
processing the queue and queuing particular changes. |
| 364 |
|
| 365 |
krb5-sync 0.3 (2007-01-05) |
| 366 |
|
| 367 |
First publicly released version. Includes a patch for MIT Kerberos |
| 368 |
1.4.4, a plugin that can synchronize passwords to one Active Directory |
| 369 |
realm and/or one AFS kaserver realm and enabled flag changes to one |
| 370 |
Active Directory realm, and command-line utilities to perform the same |
| 371 |
actions as the plugin. |
| 372 |
|