'\" t
.\"     Title: sssd_krb5_locator_plugin
.\"    Author: Восходящий источник (\(Foапстрим\(Fc) SSSD \(em https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 12/17/2024
.\"    Manual: Справка по SSSD
.\"    Source: SSSD
.\"  Language: English
.\"
.TH "SSSD_KRB5_LOCATOR_PL" "8" "12/17/2024" "SSSD" "Справка по SSSD"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sssd_krb5_locator_plugin \- Модуль локатора Kerberos
.SH "ОПИСАНИЕ"
.PP
Модуль локатора Kerberos
\fBsssd_krb5_locator_plugin\fR
используется libkrb5 для поиска KDC для указанной области Kerberos\&. SSSD предоставляет этот модуль для направления всех клиентов Kerberos в системе в один KDC\&. В целом, не имеет значения, с каким KDC обменивается данными клиентский процесс\&. Но в некоторых случаях (например, после смены пароля) не все KDC находятся в одинаковом состоянии, поскольку для этого сначала необходимо выполнить репликацию новых данных\&. Чтобы избежать неожиданных сбоев проверки подлинности и, возможно, даже блокировки учётных записей, следует как можно дольше выполнять обмен данными с одним KDC\&.
.PP
libkrb5 выполнит поиск модуля локатора в подкаталоге libkrb5 каталога модулей Kerberos (см\&. plugin_base_dir в
\fBkrb5.conf\fR(5))\&. Модуль можно отключить, только удалив соответствующий файл модуля\&. В конфигурации Kerberos не предусмотрен параметр для его отключения\&. Но для отдельных команд модуль можно отключить с помощью переменной среды SSSD_KRB5_LOCATOR_DISABLE\&. Либо можно использовать параметр SSSD krb5_use_kdcinfo=False, чтобы не создавать данные, которые требуются для работы модуля\&. В этом случае модуль по\-прежнему будет вызываться, но не предоставит данные вызывающей стороне, поэтому libkrb5 перейдёт к использованию других методов, определённых в krb5\&.conf\&.
.PP
Модуль выполняет чтение информации о KDC указанной области из файла
kdcinfo\&.REALM\&. Этот файл должен содержать одно или несколько DNS\-имён или IP\-адресов (либо в десятичной записи IPv4, либо в шестнадцатеричной записи IPv6)\&. В конце можно (необязательно) добавить номер порта, отделив его двоеточием; в этом случае адрес IPv6 необходимо, как и обычно, заключить в квадратные скобки\&. Корректные записи:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
kdc\&.example\&.com
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
kdc\&.example\&.com:321
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
1\&.2\&.3\&.4
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
5\&.6\&.7\&.8:99
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
2001:db8:85a3::8a2e:370:7334
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
[2001:db8:85a3::8a2e:370:7334]:321
.RE
.sp
Поставщик данных проверки подлинности krb5 SSSD, который также используется поставщиками данных IPA и AD, добавляет в этот файл адрес текущего KDC или контроллера домена, который используется SSSD\&.
.PP
В средах с доступными только для чтения и доступными для чтения и записи KDC, где, как ожидается, клиенты будут использовать для общих операций экземпляры, доступные только для чтения, а для изменений конфигурации, таких как смена пароля, \(em только KDC, доступные для чтения и записи, также используется файл
kpasswdinfo\&.REALM
для идентификации доступных для чтения и записи KDC\&. Если этот файл существует для указанной области, его содержимое будет использовано модулем для ответа на запросы по серверу kpasswd или kadmin или определённому основному KDC MIT Kerberos\&. Если адрес содержит номер порта, для последнего будет использоваться стандартный порт KDC 88\&.
.SH "ПРИМЕЧАНИЯ"
.PP
Не все реализации Kerberos поддерживают использование модулей\&. Если в системе нет
\fBsssd_krb5_locator_plugin\fR, необходимо отредактировать файл /etc/krb5\&.conf в соответствии с используемой версией Kerberos\&.
.PP
Если переменная среды SSSD_KRB5_LOCATOR_DEBUG установлена в какое\-либо значение, сообщения отладки будут отправляться в stderr\&.
.PP
Если переменная среды SSSD_KRB5_LOCATOR_DISABLE установлена в какое\-либо значение, модуль отключён и просто вернёт вызывающей стороне KRB5_PLUGIN_NO_HANDLE\&.
.PP
Если переменная среды SSSD_KRB5_LOCATOR_IGNORE_DNS_FAILURES установлена в какое\-либо значение, модуль будет пытаться разрешить все DNS\-имена в файле kdcinfo\&. По умолчанию модуль возвращает вызывающей стороне KRB5_PLUGIN_NO_HANDLE сразу после первой неудачи при разрешении DNS\&.
.SH "СМ\&. ТАКЖЕ"
.PP
\fBsssd\fR(8),
\fBsssd.conf\fR(5),
\fBsssd-ldap\fR(5),
\fBsssd-ldap-attributes\fR(5),
\fBsssd-krb5\fR(5),
\fBsssd-simple\fR(5),
\fBsssd-ipa\fR(5),
\fBsssd-ad\fR(5),
\fBsssd-files\fR(5),
\fBsssd-sudo\fR(5),
\fBsssd-session-recording\fR(5),
\fBsss_cache\fR(8),
\fBsss_debuglevel\fR(8),
\fBsss_obfuscate\fR(8),
\fBsss_seed\fR(8),
\fBsssd_krb5_locator_plugin\fR(8),
\fBsss_ssh_authorizedkeys\fR(8), \fBsss_ssh_knownhostsproxy\fR(8),
\fBsssd-ifp\fR(5),
\fBpam_sss\fR(8)\&.
\fBsss_rpcidmapd\fR(5)
\fBsssd-systemtap\fR(5)
.SH "AUTHORS"
.PP
\fBВосходящий источник (\(Foапстрим\(Fc)
SSSD \(em https://github\&.com/SSSD/sssd/\fR
