Skip to content

Commit bb225ef

Browse files
sumit-bosealexey-tikhonov
authored andcommitted
man: add details about 'an2ln'
With a recent security fix the 'an2ln' module was disabled in SSSD's configuration snippet for the localauth configuration of libkrb5. With this patch the related man page is update accordingly. Reviewed-by: Alexey Tikhonov <atikhono@redhat.com> Reviewed-by: Justin Stephenson <jstephen@redhat.com> (cherry picked from commit bcd9998)
1 parent 4a7245c commit bb225ef

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

src/man/sssd_krb5_localauth_plugin.8.xml

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,13 +55,31 @@
5555
<programlisting>
5656
[plugins]
5757
localauth = {
58+
disable = an2ln
5859
module = sssd:/usr/lib64/sssd/modules/sssd_krb5_localauth_plugin.so
5960
}
6061
</programlisting>
6162
automatically in the SSSD's public Kerberos configuration snippet
6263
directory. If this directory is included in the local Kerberos
6364
configuration the plugin will be enabled automatically.
6465
</para>
66+
<para>
67+
This configuration snippet also disables the
68+
<command>an2ln</command> module provided by MIT Kerberos if SSSD is
69+
configured to use the AD or IPA provider. In those environments
70+
<command>sssd_krb5_localauth_plugin</command> can reliably map the
71+
system user names to Kerberos principals. A fallback to
72+
<command>an2ln</command> might cause issues in environments where
73+
users have the privilege to create Kerberos principals on their own
74+
which might collide with names of other users used in the system.
75+
Other modules provided by MIT Kerberos, e.g.
76+
<command>k5login</command> are not affected.
77+
</para>
78+
<para>
79+
Note: If using <quote>auth_provider = krb5</quote> then
80+
<command>sssd_krb5_localauth_plugin</command> is not used, therefore
81+
the above text is not applicable.
82+
</para>
6583
</refsect1>
6684

6785
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/seealso.xml" />

0 commit comments

Comments
 (0)