Справка по SSSD
sssd-ipa
5
Форматы файлов и рекомендации
sssd-ipa
Поставщик данных IPA SSSD
ОПИСАНИЕ
На этой справочной странице представлено описание настройки поставщика
данных IPA для sssd
8 . Подробные сведения о синтаксисе
доступны в разделе ФОРМАТ ФАЙЛА
справочной страницы
sssd.conf
5 .
Поставщик данных IPA — это внутренний сервер, который используется для
подключения к серверу IPA. (Сведения о серверах IPA доступны на веб-сайте
freeipa.org.) Для работы этого поставщика требуется, чтобы компьютер был
присоединён к домену IPA; настройка почти полностью автоматизирована,
получение её данных выполняется непосредственно с сервера.
Поставщик данных IPA позволяет SSSD использовать поставщика данных
идентификации sssd-ldap
5 и поставщика данных проверки
подлинности sssd-krb5
5 с оптимизацией для сред
IPA. Поставщик данных IPA принимает те же параметры, которые используются
поставщиками sssd-ldap и sssd-krb5 providers, за некоторыми исключениями. Но
установка этих параметров не является ни необходимой, ни рекомендуемой.
Поставщик данных IPA в основном копирует стандартные параметры традиционных
поставщиков данных ldap и krb5, за некоторыми исключениями. Список различий
доступен в разделе ИЗМЕНЁННЫЕ СТАНДАРТНЫЕ ПАРАМЕТРЫ
.
As an access provider, the IPA provider has a minimal configuration (see
ipa_access_order
) as it mainly uses HBAC (host-based access
control) rules. Please refer to freeipa.org for more information about HBAC.
Если в sssd.conf указано auth_provider=ipa
или
access_provider=ipa
, параметр id_provider тоже необходимо
установить в значение ipa
.
Поставщик данных IPA будет использовать ответчик PAC, если билеты Kerberos
пользователей из доверенных областей содержат PAC. Для упрощения настройки
запуск ответчика PAC выполняется автоматически, если настроен поставщик
идентификаторов IPA.
ПАРАМЕТРЫ КОНФИГУРАЦИИ
Сведения о конфигурации домена SSSD доступны в разделе РАЗДЕЛЫ
ДОМЕНА
справочной страницы
sssd.conf 5
.
ipa_domain (строка)
Позволяет указать имя домена IPA. Это необязательно. Если имя не указано,
используется имя домена в конфигурации.
ipa_server, ipa_backup_server (строка)
Разделённый запятыми список IP-адресов или имён узлов серверов IPA, к
которым SSSD следует подключаться в порядке приоритета. Дополнительные
сведения об отработке отказа и избыточности сервера доступны в разделе
ОТРАБОТКА ОТКАЗА
. Этот параметр является необязательным, если
включено автоматическое обнаружение служб. Дополнительные сведения об
обнаружении служб доступны в разделе ОБНАРУЖЕНИЕ СЛУЖБ
.
ipa_hostname (строка)
Необязательный параметр. Может быть указан на компьютерах, где hostname(5)
не содержит полное имя, которое используется для идентификации этого узла в
домене IPA. Имя узла должно быть полным.
dyndns_update (логическое значение)
Необязательный параметр. Этот параметр указывает SSSD автоматически
обновлять на сервере DNS, встроенном во FreeIPA, IP-адрес клиента. Защита
обновления обеспечивается с помощью GSS-TSIG. Для обновления будет
использован IP-адрес LDAP-соединения IPA, если с помощью параметра
dyndns_iface
не указано иное.
ПРИМЕЧАНИЕ: на устаревших системах (например, RHEL 5) для корректной работы
в этом режиме необходимо надлежащим образом задать стандартную область
Kerberos в /etc/krb5.conf
ПРИМЕЧАНИЕ: прежнее имя параметра, ipa_dyndns_update,
всё ещё можно использовать, но пользователям рекомендуется перейти на
использование нового имени, dyndns_update, в файле
конфигурации.
По умолчанию: false
dyndns_ttl (целое число)
Значение TTL, которое применяется при обновлении записи DNS клиента. Если
параметр dyndns_update установлен в значение «false», этот параметр ни на
что не влияет. Если администратором установлено значение TTL на стороне
сервера, оно будет переопределено этим параметром.
ПРИМЕЧАНИЕ: прежнее имя параметра, ipa_dyndns_ttl, всё
ещё можно использовать, но пользователям рекомендуется перейти на
использование нового имени, dyndns_ttl, в файле
конфигурации.
По умолчанию: 1200 (секунд)
dyndns_iface (строка)
Необязательный параметр. Применимо только тогда, когда параметр
dyndns_update установлен в значение «true». Выберите интерфейс или список
интерфейсов, IP-адреса которых должны использоваться для динамических
обновлений DNS. Специальное значение *
подразумевает, что
следует использовать IP-адреса всех интерфейсов.
ПРИМЕЧАНИЕ: прежнее имя параметра, ipa_dyndns_iface,
всё ещё можно использовать, но пользователям рекомендуется перейти на
использование нового имени, dyndns_iface, в файле
конфигурации.
По умолчанию: использовать IP-адреса интерфейса, который используется для
подключения LDAP IPA
Пример: dyndns_iface = em1, vnet1, vnet2
dyndns_auth (строка)
Следует ли утилите nsupdate использовать проверку подлинности GSS-TSIG для
защищённых обновлений сервера DNS. Незащищённые отправления можно
отправлять, установив этот параметр в значение «none».
По умолчанию: GSS-TSIG
dyndns_auth_ptr (строка)
Следует ли утилите nsupdate использовать проверку подлинности GSS-TSIG для
защищённых обновлений PTR сервера DNS. Незащищённые отправления можно
отправлять, установив этот параметр в значение «none».
По умолчанию: то же, что и dyndns_auth
ipa_enable_dns_sites (логическое значение)
Включить сайты DNS — обнаружение служб по расположению.
Если параметр установлен в значение «true» и включено обнаружение служб
(смотрите абзац об обнаружении служб в нижней части справочной страницы),
SSSD сначала будет пробовать выполнить обнаружение на основе расположения с
помощью запроса, который содержит «_location.hostname.example.com», а затем
перейдёт к традиционному обнаружению SRV. Если обнаружение на основе
расположения будет выполнено успешно, серверы IPA, обнаруженные с помощью
обнаружения на основе расположения, будут считаться основными, а серверы
IPA, обнаруженные с помощью традиционного обнаружения SRV, будут
использоваться в качестве резервных
По умолчанию: false
dyndns_refresh_interval (целое число)
Как часто внутреннему серверу следует выполнять периодическое обновление DNS
в дополнение к автоматическому обновлению, которое выполняется при переходе
внутреннего сервера в сетевой режим. Этот параметр является необязательным и
применяется только тогда, когда параметр dyndns_update установлен в значение
«true».
По умолчанию: 0 (отключено)
dyndns_update_ptr (логическое значение)
Следует ли также явно обновлять запись PTR при обновлении записей DNS
клиента. Применимо только тогда, когда параметр dyndns_update установлен в
значение «true».
Этот параметр должен быть установлен в значение «False» в большинстве
развёрнутых систем IPA, так как сервер IPA генерирует записи PTR
автоматически при смене записей перенаправления.
Note that dyndns_update_per_family parameter does not
apply for PTR record updates. Those updates are always sent separately.
По умолчанию: false (отключено)
dyndns_force_tcp (логическое значение)
Должна ли утилита nsupdate по умолчанию использовать TCP для обмена данными
с сервером DNS.
По умолчанию: false (разрешить nsupdate выбрать протокол)
dyndns_server (строка)
Сервер DNS, который следует использовать для выполнения обновления DNS. В
большинстве конфигураций рекомендуется не устанавливать значение для этого
параметра.
Установка этого параметра имеет смысл для сред, в которых сервер DNS
отличается от сервера данных идентификации.
Обратите внимание, что этот параметр используется только для резервной
попытки, которая выполняется тогда, когда предыдущая попытка с
использованием автоматически определённых параметров завершилась неудачей.
По умолчанию: none (разрешить nsupdate выбрать сервер)
dyndns_update_per_family (логическое значение)
По умолчанию обновление DNS выполняется за два шага: обновление IPv4, а
затем обновление IPv4. В некоторых случаях может быть желательно выполнить
обновление IPv4 и IPv6 за один шаг.
По умолчанию: true
ipa_access_order (string)
Разделённый запятыми список параметров управления доступом. Допустимые
значения:
expire: use IPA's account expiration policy.
pwd_expire_policy_reject, pwd_expire_policy_warn,
pwd_expire_policy_renew: эти параметры полезны, если
пользователям нужно предупреждение о том, что срок действия пароля истекает,
и для проверки подлинности используются не пароли, а, например, ключи SSH.
The difference between these options is the action taken if user password is
expired:
pwd_expire_policy_reject - user is denied to log in,
pwd_expire_policy_warn - user is still able to log in,
pwd_expire_policy_renew - user is prompted to change their password
immediately.
Please note that 'access_provider = ipa' must be set for this feature to
work.
ipa_deskprofile_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска
объектов, связанных с профилями рабочего стола.
По умолчанию: использовать base DN
ipa_subid_ranges_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска
объектов, связанных с подчиненными диапазонами объектов.
По умолчанию: значение cn=subids,%basedn
ipa_hbac_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска
объектов, связанных с HBAC.
По умолчанию: использовать base DN
ipa_host_search_base (строка)
Не рекомендуется. Используйте ldap_host_search_base.
ipa_selinux_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска карт
пользователей SELinux.
Сведения о настройке нескольких баз поиска доступны в описании параметра
ldap_search_base
.
По умолчанию: значение ldap_search_base
ipa_subdomains_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска
доверенных доменов.
Сведения о настройке нескольких баз поиска доступны в описании параметра
ldap_search_base
.
По умолчанию: значение cn=trusts,%basedn
ipa_master_domain_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска
объекта главного домена.
Сведения о настройке нескольких баз поиска доступны в описании параметра
ldap_search_base
.
По умолчанию: значение cn=ad,cn=etc,%basedn
ipa_views_search_base (строка)
Необязательный параметр. Использовать указанную строку как базу поиска
контейнеров просмотра.
Сведения о настройке нескольких баз поиска доступны в описании параметра
ldap_search_base
.
По умолчанию: значение cn=views,cn=accounts,%basedn
krb5_realm (строка)
Имя области Kerberos. Это необязательный параметр, по умолчанию он имеет
значение ipa_domain
.
Имя области Kerberos имеет особое значение в IPA — оно преобразуется в base
DN, которое следует использовать для выполнения действий LDAP.
krb5_confd_path (строка)
Абсолютный путь к каталогу, в котором SSSD следует размещать фрагменты
конфигурации Kerberos.
Чтобы отключить создание фрагментов конфигурации, установите этот параметр в
значение «none».
По умолчанию: не задано (подкаталог krb5.include.d каталога pubconf SSSD)
ipa_deskprofile_refresh (целое число)
Временной интервал между сеансами поиска правил профилей рабочего стола на
сервере IPA. Это сократит задержки и нагрузку на сервер IPA, когда за
короткое время поступает много запросов на профили рабочего стола.
По умолчанию: 5 (секунд)
ipa_deskprofile_request_interval (целое число)
Временной интервал между сеансами поиска правил профилей рабочего стола на
сервере IPA, если при последнем запросе не было возвращено ни одного
правила.
По умолчанию: 60 (минут)
ipa_hbac_refresh (целое число)
Временной интервал между сеансами поиска правил HBAC на сервере IPA. Это
сократит задержки и нагрузку на сервер IPA, когда за короткое время
поступает много запросов на управление доступом.
По умолчанию: 5 (секунд)
ipa_hbac_selinux (целое число)
Временной интервал между сеансами поиска карт SELinux на сервере IPA. Это
сократит задержки и нагрузку на сервер IPA, когда за короткое время
поступает много запросов на вход пользователей.
По умолчанию: 5 (секунд)
ipa_server_mode (логическое значение)
Значение этого параметра будет задано автоматически установщиком IPA
(ipa-server-install). Оно определяет, работает SSSD на сервере IPA или нет.
На сервере IPA SSSD выполняет поиск пользователей и групп из доверенных
доменов напрямую, но на клиенте SSSD отправит запрос серверу IPA.
ПРИМЕЧАНИЕ: необходимо соблюсти несколько условий, если SSSD работает на
сервере IPA.
Параметр ipa_server
должен быть настроен так, чтобы он
указывал на сам сервер IPA. Такое стандартное значение уже задано
установщиком IPA, поэтому вносить изменения вручную не требуется.
Параметр full_name_format
не должен быть настроен таким
образом, чтобы отображались только краткие имена пользователей из доверенных
доменов.
По умолчанию: false
ipa_automount_location (строка)
Расположение автоматического монтирования, которое будет использовать этот
клиент IPA
По умолчанию: расположение с именем «default»
ПРЕДСТАВЛЕНИЯ И ПЕРЕОПРЕДЕЛЕНИЯ
SSSD может обрабатывать представления и переопределения, которые
предоставляет FreeIPA версии 4.1 и выше. Так как все пути и классы объектов
зафиксированы на стороне сервера, в целом нет необходимости в дополнительной
настройке. Для полноты картины далее перечислены соответствующие параметры и
их стандартные значения.
ipa_view_class (строка)
Класс объектов контейнера просмотра.
По умолчанию: nsContainer
ipa_view_name (строка)
Имя атрибута, в котором хранится имя представления.
По умолчанию: cn
ipa_override_object_class (строка)
Объектный класс переопределяемых объектов.
По умолчанию: ipaOverrideAnchor
ipa_anchor_uuid (строка)
Имя атрибута, содержащего ссылку на исходный объект в удалённом домене.
По умолчанию: ipaAnchorUUID
ipa_user_override_object_class (строка)
Имя класса объектов для переопределений пользователя. Используется для того,
чтобы определить, связан ли найденный объект переопределения с пользователем
или группой.
Переопределения пользователя могут содержать атрибуты, указанные с помощью
ldap_user_name
ldap_user_uid_number
ldap_user_gid_number
ldap_user_gecos
ldap_user_home_directory
ldap_user_shell
ldap_user_ssh_public_key
По умолчанию: ipaUserOverride
ipa_group_override_object_class (строка)
Имя класса объектов для переопределений группы. Используется для того, чтобы
определить, связан ли найденный объект переопределения с пользователем или
группой.
Переопределения группы могут содержать атрибуты, указанные с помощью
ldap_group_name
ldap_group_gid_number
По умолчанию: ipaGroupOverride
ПОСТАВЩИК ДАННЫХ ПОДДОМЕНОВ
В зависимости от того, настроен ли поставщик данных поддоменов IPA явным или
неявным образом, его поведение будет немного отличаться.
Если в разделе домена sssd.conf найден параметр «subdomains_provider = ipa»,
поставщик данных поддоменов IPA настроен в явном виде, и при необходимости
все запросы поддоменов отправляются серверу IPA.
Если в разделе домена sssd.conf не задан параметр «subdomains_provider», но
имеется параметр «id_provider = ipa», поставщик данных поддоменов IPA
настроен в неявном виде. В этом случае, если происходит ошибка запроса к
поддомену, которая указывает на то, что сервер не поддерживает поддомены, то
есть на нём не настроены отношения доверия, поставщик данных поддоменов IPA
будет отключён. Через час или после того, как поставщик данных IPA выходит в
сеть, поставщик данных поддоменов включается снова.
КОНФИГУРАЦИЯ ДОВЕРЕННЫХ ДОМЕНОВ
Для доверенного домена также можно задать некоторые параметры
конфигурации. Настройку доверенного домена можно выполнить с помощью
подраздела доверенного домена, как показано в примере ниже. Либо можно
воспользоваться параметром subdomain_inherit
в родительском
домене.
[domain/ipa.domain.com/ad.domain.com]
ad_server = dc.ad.domain.com
Дополнительные сведения доступны на справочной странице
sssd.conf 5
.
Для доверенного домена можно выполнить тонкую настройку различных параметров
конфигурации в соответствии с тем, где настраивается SSSD: на сервере IPA
или на клиенте IPA.
ПАРАМЕТРЫ, КОТОРЫЕ МОЖНО НАСТРОИТЬ НА ОСНОВНЫХ СЕРВЕРАХ IPA
В разделе поддомена на основном сервере IPA можно настроить следующие
параметры:
ad_server
ad_backup_server
ad_site
ldap_search_base
ldap_user_search_base
ldap_group_search_base
use_fully_qualified_names
ПАРАМЕТРЫ, КОТОРЫЕ МОЖНО НАСТРОИТЬ НА КЛИЕНТАХ IPA
В разделе поддомена на клиенте IPA можно настроить следующие параметры:
ad_server
ad_site
Обратите внимание: если заданы оба параметра, учитывается только
ad_server
.
Так как любой запрос идентификационных данных пользователя или группы из
доверенного домена, который активирован клиентом IPA, разрешается сервером
IPA, параметры ad_server
и ad_site
влияют
только на то, на каком контроллере домена AD DC будет выполняться проверка
подлинности. В частности, полученные из этих списков адреса будут записаны в
файлы kdcinfo
, чтение которых выполняет модуль локатора
Kerberos. Дополнительные сведения о модуле локатора Kerberos доступны на
справочной странице
sssd_krb5_locator_plugin
8 .
ПРИМЕР
В следующем примере предполагается, что конфигурация SSSD корректна и что
example.com — один из доменов в разделе [sssd]. В
примере показаны только параметры, относящиеся к поставщику данных IPA.
[domain/example.com]
id_provider = ipa
ipa_server = ipaserver.example.com
ipa_hostname = myhost.example.com