Deprecation notice for BIND 9.20+: "tkey-gssapi-credential", "tkey-domain"
Michał Kępień
michal at isc.org
Wed Aug 13 16:53:14 UTC 2025
BIND users,
In line with our deprecation policy, we are notifying the mailing list
about our intent to deprecate two TKEY-related configuration
statements: "tkey-gssapi-credential" and "tkey-domain".
"tkey-gssapi-credential"
------------------------
Since the "tkey-gssapi-credential" statement acquires the specified GSS-API
credential from a Kerberos keytab, the "tkey-gssapi-keytab"
option should be used instead as such a setup is simpler, more reliable,
and easier to troubleshoot.
For configurations currently using a combination of both
"tkey-gssapi-keytab" and "tkey-gssapi-credential", the latter should be
dropped; the keytab pointed to by "tkey-gssapi-keytab" should only
contain the credential previously specified by "tkey-gssapi-credential".
These changes are intended to simplify GSS-TSIG configuration in
named.conf: using the "tkey-gssapi-keytab" statement will be the only way
to do that.
In BIND 9.18 & BIND 9.20, using the "tkey-gssapi-credential" statement
will cause a deprecation warning to be emitted, but it will continue
working.
In BIND 9.22, using the "tkey-gssapi-credential" statement will be a
fatal error.
"tkey-domain"
-------------
This statement is only used by code implementing TKEY Mode 2
(Diffie-Hellman), which has already been removed from BIND 9.20+.
In BIND 9.18, using the "tkey-domain" statement will cause a deprecation
warning to be emitted, but it will continue working with TKEY Mode 2.
In BIND 9.20, using the "tkey-domain" statement will cause a deprecation
warning to be emitted, but that statement will not influence server
behavior in any way.
In BIND 9.22, using the "tkey-domain" statement will be a fatal error.
This is tracked at:
https://gitlab.isc.org/isc-projects/bind9/-/issues/4204
Thanks,
--
Best regards,
Michał Kępień
More information about the bind-users
mailing list