sssd-ldap 5 Формати файлів та правила sssd-ldap Модуль надання даних LDAP SSSD На цій сторінці довідника описано налаштування доменів LDAP для sssd 8 . Щоб дізнатися більше про синтаксис налаштування, зверніться до розділу «ФОРМАТ ФАЙЛА» сторінки довідника sssd.conf 5 . Ви можете налаштувати SSSD на використання декількох доменів LDAP. LDAP back end supports id, auth, access and chpass providers. If you want to authenticate against an LDAP server either TLS/SSL or LDAPS is required. sssd does not support authentication over an unencrypted channel. Even if the LDAP server is used only as an identity provider, an encrypted channel is strongly recommended. Please refer to ldap_access_filter config option for more information about using LDAP as an access provider. Всі загальні параметри налаштування, які стосуються доменів SSSD, також стосуються і доменів LDAP. Зверніться до розділу «РОЗДІЛИ ДОМЕНІВ» сторінки підручника sssd.conf 5 , щоб дізнатися більше. Зауважте, що атрибути прив'язки до LDAP SSSD описано на сторінці підручника щодо sssd-ldap-attributes 5 . ldap_uri, ldap_backup_uri (рядок) Визначає список адрес серверів LDAP, відокремлених комами, з якими SSSD має встановлювати з’єднання у порядку пріоритету. Зверніться до розділу «РЕЗЕРВ», щоб дізнатися більше про перемикання на резервні ресурси та додаткові сервери. Якщо не вказано, буде використано автоматичне виявлення служб. Докладніші відомості можна знайти у розділі «ПОШУК СЛУЖБ». Формат адреси має відповідати формату, що визначається RFC 2732: ldap[s]://<вузол>[:порт] У явних адресах IPv6 <вузол> має бути вказано у квадратних дужках, [] приклад: ldap://[fc00::126:25]:389 ldap_chpass_uri, ldap_chpass_backup_uri (рядок) Визначає список адрес серверів LDAP, відокремлених комами, з якими SSSD має встановлювати з’єднання у порядку пріоритету для зміни пароля користувача. Зверніться до розділу «РЕЗЕРВ», щоб дізнатися більше про перемикання на резервні ресурси та додаткові сервери. Для того, щоб уможливити визначення служб, слід встановити значення параметра ldap_chpass_dns_service_name. Типове значення: порожнє, тобто використовується ldap_uri. ldap_search_base (рядок) Типова базова назва домену, яку слід використовувати для виконання дій від імені користувача LDAP. Починаючи з SSSD 1.7.0, у SSSD передбачено підтримку визначення декількох основ для пошуку за допомогою таких синтаксичних конструкцій: основа_пошуку[?діапазон?[фільтр][?основа_пошуку?діапазон?[фільтр]]*] Діапазоном може бути одне зі значень, «base» (основа), «onelevel» (окремий рівень) або «subtree» (піддерево). Фільтром має бути коректний запис фільтрування LDAP, відповідно до специфікації http://www.ietf.org/rfc/rfc2254.txt Приклади: ldap_search_base = dc=example,dc=com (еквівалентне до) ldap_search_base = dc=example,dc=com?subtree? ldap_search_base = cn=host_specific,dc=example,dc=com?subtree?(host=thishost)?dc=example.com?subtree? Зауваження: підтримки визначення декількох основ пошуку з посиланням на об’єкти з однаковими назвами (наприклад груп з однаковою назвою у двох різних основах пошуку) не передбачено. Такі визначення можуть призвести до непередбачуваних результатів на клієнтських комп’ютерах. Типове значення: якщо значення не встановлено, буде використано значення атрибута defaultNamingContext або namingContexts з RootDSE сервера LDAP. Якщо запису defaultNamingContext не існує або цей запис має порожнє значення, буде використано namingContexts. Для роботи системи потрібно, щоб атрибут namingContexts має єдине значення DN бази пошуку сервера LDAP. Підтримки визначення декількох значень не передбачено. ldap_schema (рядок) Визначає тип схеми, що використовується на сервері LDAP призначення. Відповідно до вибраної схеми, типові назви атрибутів, отриманих з сервера, можуть бути різними. Спосіб обробки атрибутів також може бути різним. У поточній версії передбачено підтримку чотирьох типів схем: rfc2307 rfc2307bis IPA AD Основною відмінністю між цими типами схем є спосіб запису даних щодо участі у групах на сервері. Відповідно до rfc2307, список учасників груп впорядковується за користувачами у атрибуті memberUid. Відповідно до rfc2307bis і IPA, список учасників груп впорядковується за назвою домену (DN) і зберігається у атрибуті member. Відповідно до типу схеми AD, встановлюється відповідність зі значеннями Active Directory 2008r2. Типове значення: rfc2307 ldap_pwmodify_mode (рядок) Визначає дію, яку буде здійснено для зміни пароля користувача. У поточній версії передбачено два режими: exop — розширена дія зі зміни пароля (RFC 3062) ldap_modify — безпосереднє внесення змін до userPassword (не рекомендуємо). Зауваження: спочатку буде встановлено нове з'єднання для перевірки поточного пароля шляхом прив'язування до системи від імені користувача, від якого надійшов запит щодо зміни пароля. Якщо з'єднання вдасться встановити, його буде використано для зміни пароля, тому у користувача має бути доступ до запису атрибута userPassword. Типове значення: exop ldap_default_bind_dn (рядок) Типова назва домену прив’язки, яку слід використовувати для виконання дій LDAP. ldap_default_authtok_type (рядок) Тип розпізнавання для типової назви сервера прив’язки. У поточній версії передбачено підтримку двох механізмів: password obfuscated_password Типове значення: password Щоб дізнатися більше, ознайомтеся зі сторінкою підручника щодо sss_obfuscate 8 . ldap_default_authtok (рядок) Лексема розпізнавання типової назви сервера прив’язки. ldap_force_upper_case_realm (булеве значення) Деякі з серверів каталогів, наприклад Active Directory, можуть надавати частину області адреси UPN лише малими літерами (літерами нижнього регістру), що може призвести до невдалої спроби розпізнавання. Встановіть ненульове значення цього параметра, якщо ви бажаєте використовувати назву області у верхньому регістрі. Типове значення: false ldap_enumeration_refresh_timeout (ціле число) Визначає кількість секунд, протягом яких SSSD має очікувати до оновлення свого кешу нумерованих записів. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 300 ldap_purge_cache_timeout (ціле число) Визначає частоту пошуків у кеші неактивних записів (зокрема груп без учасників та користувачів, які ніколи не входили до системи) та вилучення цих записів з метою економії місця. Встановлення нульового значення цього параметра вимикає дію з очищення кешу. Будь ласка, зауважте, що якщо увімкнено нумерацію, дія з очищення є необхідною з метою виявлення записів, вилучених із сервера, її не можна вимикати. Типово, дія з очищення, якщо увімкнено нумерацію, виконується кожні 3 години. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 0 (вимкнено) ldap_group_nesting_level (ціле число) Якщо ldap_schema встановлено у значення формату схеми, у якому передбачено підтримку вкладеності груп (наприклад RFC2307bis), цей параметр визначає кількість рівнів вкладеності, які оброблятимуться SSSD. Значення цього параметра буде проігноровано, якщо використано схему RFC2307. Зауваження: за допомогою цього параметра визначається гарантований рівень вкладеності груп для обробки під час будь-якого пошуку. Втім, може бути повернуто і групи із більшим рівнем вкладеності, якщо під час попередніх пошуків відбувалася обробка вищих рівнів вкладеності. Крім того, послідовні пошуки інших груп можуть розширити набір результатів початкового пошуку, якщо запити щодо пошуку надходять повторно. Якщо значенням ldap_group_nesting_level є 0, вкладені групи взагалі не оброблятимуться. Втім, якщо з’єднання встановлено з Active-Directory Server 2008 та новішими версіями з використанням id_provider=ad, слід також вимкнути використання груп реєстраційних записів (Token-Groups) встановленням для параметра ldap_use_tokengroups значення false з метою обмеження вкладеності у групах. Типове значення: 2 ldap_use_tokengroups За допомогою цього параметра можна увімкнути або вимкнути використання атрибута Token-Groups під час виконання initgroup для користувачів Active Directory Server 2008 та новіших версій. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: True для AD і IPA, інакше False. ldap_host_search_base (рядок) Необов’язковий. Використати вказаний рядок як основу пошуку об’єктів вузлів. Ознайомтеся з розділом щодо «ldap_search_base», щоб дізнатися більше про налаштування декількох основ пошуку. Типове значення: значення ldap_search_base ldap_service_search_base (рядок) ldap_iphost_search_base (рядок) ldap_ipnetwork_search_base (рядок) ldap_search_timeout (ціле число) Визначає час очікування на дані (у секундах) для виконання пошуків ldap, перш ніж пошук буде скасовано з поверненням кешованих даних (і переходом до автономного режиму роботи) Зауваження: роботу цього параметра буде змінено у наступних версіях SSSD. Ймовірно, його буде колись замінено на послідовність часів очікування для окремих типів пошуків. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 6 ldap_enumeration_search_timeout (ціле число) Визначає час очікування на дані (у секундах) для виконання пошуків номерів користувачів та груп у ldap, перш ніж пошук буде скасовано з поверненням кешованих даних (і переходом до автономного режиму роботи) Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 60 ldap_network_timeout (ціле число) Визначає час очікування (у секундах), після завершення якого poll 2 / select 2 з наступним connect 2 повертається до стану бездіяльності. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 6 ldap_opt_timeout (ціле число) Визначає час очікування (у секундах), після завершення якого виклики до синхронних програмних інтерфейсів LDAP буде перервано, якщо не буде отримано відповіді. Також керує часом очікування під час обміну даними з KDC у випадку прив’язки SASL, часом очікування на дію з прив’язування LDAP, розширеної операції зі зміни пароля та дії StartTLS. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 8 ldap_connection_expire_timeout (ціле значення) Визначає час очікування (у секундах), протягом якого підтримуватиметься з’єднання з сервером LDAP. По завершенню цього часу буде зроблено спробу повторно встановити з’єднання. У разі використання паралельно до SASL/GSSAPI буде використано перше за часом значення (це значення або значення строку дії TGT). Якщо з'єднання є бездіяльним (жодна дія у ньому не виконується активно) протягом ldap_opt_timeout секунд завершення строку дії, його буде передчасно розірвано, щоб новий запит не міг потребувати, щоб з'єднання лишалося відкритим після завершення його строку дії. Неявним чином, це означає, що з'єднання завжди розриватимуться негайно і не використовуватимуться повторно, якщо ldap_connection_expire_timeout <= ldap_opt_timout Цей час очікування може бути подовжено випадковим значенням, яке вказано параметром ldap_connection_expire_offset Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 900 (15 хвилин) ldap_connection_expire_offset (ціле число) Випадковий зсув від 0 до налаштованого значення, який буде додано до ldap_connection_expire_timeout. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 0 ldap_connection_idle_timeout (ціле значення) Визначає час очікування (у секундах), протягом якого підтримуватиметься бездіяльне з’єднання з сервером LDAP. Якщо з'єднання лишатиметься бездіяльним понад цей час, з'єднання буде розірвано. Ви можете вимкнути цей час очікування, встановивши значення 0. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 900 (15 хвилин) ldap_page_size (ціле число) Визначити кількість записів, які слід отримати з LDAP у відповідь на один запит. На деяких серверах LDAP визначено обмеження максимальної кількості на один запит. Типове значення: 1000 ldap_disable_paging (булеве значення) Вимикає контроль сторінок LDAP. Цим параметром слід скористатися, якщо сервер LDAP повідомляє про підтримку контролю сторінок LDAP у своєму RootDSE, але цю підтримку не увімкнено або вона не працює належним чином. Приклад: сервери OpenLDAP з модулем контролю сторінок, встановленим на сервері, але не увімкненим, повідомляють про підтримку у RootDSE, але цією підтримкою не можна скористатися. Приклад: 389 DS має ваду, пов’язану з тим, що здатен підтримувати лише один процес контролю сторінок для одного з’єднання. У разі значного навантаження це може призвести до відмови у виконанні запитів. Типове значення: False ldap_disable_range_retrieval (булеве значення) Вимкнути отримання діапазону Active Directory. У Active Directory за допомогою правила MaxValRange (типове значення 1500 записів) обмежується кількість записів, які може бути отримано під час пошуку. Якщо у певній групі міститься більше записів учасників, до відповіді буде включено специфічне для AD розширення діапазону. За допомогою цього параметра можна вимкнути обробку розширення діапазону, отже великі групи буде представлено як такі, у яких немає учасників. Типове значення: False ldap_sasl_minssf (ціле значення) Під час обміну даними з сервером LDAP за допомогою SASL визначає мінімальний рівень захисту, потрібний для встановлення з’єднання. Значення цього параметра визначається OpenLDAP. Типове значення: типове для системи значення (зазвичай, визначається у ldap.conf) ldap_sasl_maxssf (ціле число) Під час обміну даними з сервером LDAP за допомогою SASL визначає максимальний рівень захисту, потрібний для встановлення з’єднання. Значення цього параметра визначається OpenLDAP. Типове значення: типове для системи значення (зазвичай, визначається у ldap.conf) ldap_deref_threshold (ціле число) Вказує кількість учасників групи, записів яких має не вистачати у зовнішньому кеші для запуску загального пошуку з розіменуванням. Якщо пропущених записів буде менше за вказану кількість, пошук для них виконуватиметься окремо. Ви можете повністю вимкнути запити щодо розіменувань встановленням значення 0. Будь ласка, зауважте, що у коді SSSD, зокрема засобу надання даних HBAC IPA, є інструкції, які реалізовано лише з використанням викликів щодо розіменування, тому навіть явне вимикання розіменувань не призведе до вимикання розіменувань у цих частинах коду, якщо на сервері передбачено підтримку розіменувань і оголошено про керування розіменуваннями у об'єкті rootDSE. Пошук з розіменуванням — це отримання всіх записів учасників групи за одним викликом LDAP. У різних серверах LDAP може бути передбачено різні способи розіменування. У поточній версії передбачено підтримку серверів 389/RHDS, OpenLDAP та Active Directory. Зауваження: якщо у одній з основ пошуку визначається фільтр пошуку, покращення швидкодії фільтрів розіменування буде вимкнено, незалежно від використання цього параметра. Типове значення: 10 ldap_ignore_unreadable_references (булеве значення) Ігнорувати непридатні до читання записи LDAP, на які посилається атрибут учасника групи. Якщо для цього параметра встановлено значення «false», буде повернуто повідомлення про помилку, а дія завершиться помилкою, замість простого ігнорування непридатного до читання запису. Цей параметр може бути корисним, якщо використано надавач даних AD, і обліковий запис комп'ютера, який sssd використовує для встановлення з'єднання із AD, не має доступу до певного запису або піддерева LDAP з міркувань безпеки. Типове значення: False ldap_tls_reqcert (рядок) Визначає перелік перевірок, які слід виконати для сертифікатів серверів у сеансі TLS, якщо такі перевірки слід виконувати. Може бути визначено одне з таких значень: never = клієнт не надсилатиме запиту і не перевірятиме жодних сертифікатів сервера. allow = надіслати запит щодо сертифіката сервера. Якщо сертифікат не буде надано, продовжити сеанс у звичайному режимі. Якщо буде надано помилковий сертифікат, ігнорувати і продовжити сеанс у звичайному режимі. try = надіслати запит щодо сертифіката сервера. Якщо сертифікат не буде надано, продовжити сеанс у звичайному режимі. Якщо буде надано помилковий сертифікат, негайно перервати сеанс. demand = надіслати запит щодо сертифіката сервера. Якщо сертифікат не буде надано або буде надано помилковий сертифікат, негайно перервати сеанс. hard = те саме, що і demand Типове значення: hard ldap_tls_cacert (рядок) Визначає файл, який містить сертифікати для всіх служб сертифікації, які розпізнаються sssd. Типове значення: використовувати типові параметри OpenLDAP, що зберігаються у /etc/openldap/ldap.conf ldap_tls_cacertdir (рядок) Визначає шлях до каталогу, де у окремих файлах містяться сертифікати служб сертифікації (CA). Типовими назвами файлів є хеші сертифікатів з додаванням «.0». Для створення відповідних назв можна скористатися cacertdir_rehash, якщо ця програма є доступною. Типове значення: використовувати типові параметри OpenLDAP, що зберігаються у /etc/openldap/ldap.conf ldap_tls_cert (рядок) Визначає файл, який містить сертифікат для ключа клієнта. Типове значення: not set ldap_tls_key (рядок) Визначає файл, у якому міститься ключ клієнта. Типове значення: not set ldap_tls_cipher_suite (рядок) Визначає прийнятні комплекти програм для шифрування. Записи у типовому списку слід відокремлювати комами. З форматом можна ознайомитися на сторінці довідника до ldap.conf 5. Типове значення: використовувати типові параметри OpenLDAP, що зберігаються у /etc/openldap/ldap.conf ldap_id_use_start_tls (булеве значення) Specifies that the id_provider connection must also use tls to protect the channel. true is strongly recommended for security reasons. Типове значення: false ldap_id_mapping (булеве значення) Визначає, що SSSD має намагатися встановити відповідність ідентифікаторів користувача і групи на основі атрибутів ldap_user_objectsid та ldap_group_objectsid, замість атрибутів ldap_user_uid_number та ldap_group_gid_number. У поточній версії у цій можливості передбачено підтримку лише встановлення відповідності objectSID у ActiveDirectory. Типове значення: false ldap_min_id, ldap_max_id (ціле число) На відміну від прив’язування ідентифікаторів на основі SID, яке використовується, якщо параметр ldap_id_mapping має значення true, діапазон дозволених ідентифікаторів для ldap_user_uid_number і ldap_group_gid_number є необмеженим. У конфігураціях з піддоменами та довіреними доменами це може призвести до конфліктів ідентифікаторів. Щоб уникнути конфліктів, можна встановити значення ldap_min_id і ldap_max_id для обмеження дозволеного діапазону ідентифікаторів, які буде прочитано безпосередньо з сервера. Після цього піддомени можуть вибирати інші діапазони для прив’язування ідентифікаторів. Типове значення: не встановлено (обидва параметри встановлено у значення 0) ldap_sasl_mech (рядок) Визначає механізм SASL, який слід використовувати. У поточній версії перевірено і передбачено підтримку лише механізмів GSSAPI та GSS-SPNEGO. Якщо у модулі обробки передбачено підтримку піддоменів, значення для піддоменів ldap_sasl_mech буде автоматично успадковано від домену. Якщо для якогось піддомену потрібне інше значення, його можна перезаписати встановленням ldap_sasl_mech для цього піддомену окремо. Докладніший опис можна знайти у розділі щодо довірених доменів у підручнику з sssd.conf 5. Типове значення: not set ldap_sasl_authid (рядок) Визначає ідентифікатор уповноваження SASL, яким слід скористатися. Якщо використовується GSSAPI/GSS-SPNEGO, цим ідентифікатором є реєстраційні дані Kerberos, які використовуються для розпізнавання при доступі до каталогу. Цей параметр може містити або повні реєстраційні дані (наприклад host/myhost@EXAMPLE.COM) або просто назву реєстраційного запису (наприклад host/myhost). Типово, значення не встановлено і використовуються такі реєстраційні записи: hostname@REALM netbiosname$@REALM host/hostname@REALM *$@REALM host/*@REALM host/* Якщо жоден з них не буде знайдено, буде повернуто перший реєстраційний запис у таблиці ключів. Типове значення: вузол/назва_вузла@ОБЛАСТЬ ldap_sasl_realm (рядок) Визначає область SASL, яку слід використовувати. Якщо не вказано значення, типовим значенням цього параметра є значення krb5_realm. Якщо ldap_sasl_authid також містить запис області, цей параметр буде проігноровано. Типове значення: значення krb5_realm. ldap_sasl_canonicalize (булеве значення) Якщо встановлено значення true (1), бібліотека LDAP виконувати зворотній пошук з метою переведення назв вузлів у канонічну форму під час прив’язки до SASL. Типове значення: false; ldap_krb5_keytab (рядок) Визначає таблицю ключів, яку слід використовувати разом з SASL/GSSAPI/GSS-SPNEGO. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: системна таблиця ключів, зазвичай /etc/krb5.keytab ldap_krb5_init_creds (булеве значення) Визначає, що id_provider має ініціалізувати реєстраційні дані Kerberos (TGT). Цю дію буде виконано, лише якщо використовується SASL і вибрано механізм GSSAPI або GSS-SPNEGO. Типове значення: true ldap_krb5_ticket_lifetime (ціле число) Визначає строк дії (у секундах) TGT, якщо використовується GSSAPI або GSS-SPNEGO. Цей параметр також може бути встановлено для окремого піддомену або успадковано за допомогою subdomain_inherit. Типове значення: 86400 (24 години) krb5_server, krb5_backup_server (рядок) Визначає список IP-адрес або назв вузлів, відокремлених комами, серверів Kerberos, з якими SSSD має встановлювати з’єднання. Список має бути впорядковано за пріоритетом. Докладніше про резервування та додаткові сервери можна дізнатися з розділу «РЕЗЕРВ». До адрес або назв вузлів може бути додано номер порту (перед номером слід вписати двокрапку). Якщо параметр матиме порожнє значення, буде увімкнено виявлення служб. Докладніше про виявлення служб можна дізнатися з розділу «ПОШУК СЛУЖБ». Під час використання виявлення служб для серверів KDC або kpasswd SSSD спочатку намагається знайти записи DNS, у яких визначається протокол _udp. Використання протоколу _tcp відбувається, лише якщо таких записів не вдасться знайти. У попередніх випусках SSSD цей параметр мав назву «krb5_kdcip». У поточній версії передбачено розпізнавання цієї застарілої назви, але користувачам варто перейти на використання «krb5_server» у файлах налаштувань. krb5_realm (рядок) Вказати область Kerberos (для розпізнавання за SASL/GSSAPI/GSS-SPNEGO). Типове значення: типове значення системи, див. /etc/krb5.conf krb5_canonicalize (булеве значення) Визначає, чи слід перетворювати реєстраційний запис вузла у канонічну форму під час встановлення з’єднання з сервером LDAP. Цю можливість передбачено з версії MIT Kerberos >= 1.7 Типове значення: false krb5_use_kdcinfo (булеве значення) Визначає, чи слід SSSD вказувати бібліотекам Kerberos, яку область і які значення KDC слід використовувати. Типово, дію параметра увімкнено. Якщо ви вимкнете його, вам слід налаштувати бібліотеку Kerberos за допомогою файла налаштувань krb5.conf 5 . Див. сторінку підручника (man) sssd_krb5_locator_plugin 8 , щоб дізнатися більше про додаток пошуку. Типове значення: true ldap_pwd_policy (рядок) Визначає правил оцінки строку дії пароля на боці клієнта. Можна використовувати такі значення: none — не використовувати перевірки на боці клієнта. У разі використання цього варіанта перевірку на боці сервера вимкнено не буде. shadow — використовувати атрибути у стилі shadow 5 для визначення того, чи чинним є пароль. mit_kerberos — використовувати атрибути MIT Kerberos для визначення завершення строку дії пароля. У разі зміни пароля скористайтеся chpass_provider=krb5 для оновлення цих атрибутів. Типове значення: none Зауваження: якщо правила поводження з паролями налаштовано на боці сервера, ці правила мають пріоритет над правилами, встановленими за допомогою цього параметра. ldap_referrals (булеве значення) Визначає, чи має бути увімкнено автоматичне визначення напрямків пошуку. Зауважте, що sssd підтримує визначення напрямків, лише якщо систему зібрано з версією OpenLDAP 2.4.13 або новішою версією. Перехід за спрямуваннями може призвести до значних втрат швидкодії у середовищах, де такі спрямування використовуються широко. Прикладом такого середовища може бути Microsoft Active Directory. Якщо у вашому середовищі спрямування не є обов’язковими, встановлення для цього параметра значення «false» може значно пришвидшити роботу. Отже, встановлення для цього параметра значення false рекомендоване у випадку, коли надавач даних LDAP SSSD використовується разом із модулем обробки Microsoft Active Directory. Навіть якщо SSSD зможе переходити за посиланнями до іншого AD DC, додаткові дані виявляться недоступними. Типове значення: true ldap_dns_service_name (рядок) Визначає назву служби, яку буде використано у разі вмикання визначення служб. Типове значення: ldap ldap_chpass_dns_service_name (рядок) Визначає назву служби, яку буде використано для пошуку сервера LDAP, який уможливлює зміну паролів, у разі вмикання визначення служб. Типове значення: не встановлено, тобто пошук служб вимкнено ldap_chpass_update_last_change (булеве значення) Визначає, чи слід оновлювати атрибут ldap_user_shadow_last_change даними щодо кількості днів з часу виконання дії зі зміни пароля. Рекомендуємо встановити цей параметр явним чином, якщо використано "ldap_pwd_policy = shadow", щоб дати SSSD знати, оновлюватиме LDAP атрибут shadowLastChange автоматично після зміни пароля чи SSSD має зробити це окремо. Типове значення: False ldap_access_filter (рядок) Якщо використовується access_provider = ldap та ldap_access_order = filter (типова поведінка), цей параметр є обов’язковим. Він вказує критерії фільтрування LDAP, яким має задовольняти запис користувача для надання доступу до цього вузла. Якщо визначено access_provider = ldap та ldap_access_order = filter, а цей параметр не встановлено, доступ буде заборонено всім користувачам. Щоб змінити таку типову поведінку системи, скористайтеся параметром access_provider = permit. Будь ласка, зауважте, що цей фільтр застосовуватиметься лише до запису користувача LDAP, отже фільтрування, засноване на вкладених групах може не працювати (наприклад, атрибут memberOf для записів AD вказує лише на безпосередні батьківські записи). Якщо вам потрібне фільтрування, засноване на вкладених групах, будь ласка, скористайтеся параметром sssd-simple5 . Приклад: access_provider = ldap ldap_access_filter = (employeeType=admin) У прикладі доступ до цього вузла обмежено користувачами, чий атрибут employeeType встановлено у значення «admin». Автономне кешування для цієї можливості обмежено визначенням того, чи було надано користувачеві під час попередньої спроби увійти до системи з мережі права доступу. Якщо під час останньої спроби увійти такі права було надано, система продовжуватиме надавати права доступу у автономному режимі. Якщо ж таких прав не було надано, у автономному режимі їх також не буде надано. Типове значення: порожній рядок ldap_account_expire_policy (рядок) За допомогою цього параметра може бути увімкнено визначення атрибутів керування доступом на боці клієнта. Будь ласка, зауважте, що завжди варто використовувати керування доступом на боці сервера, тобто сервер LDAP має відмовляти у запитах щодо прив’язування з відповідним кодом помилки, навіть якщо вказано правильний пароль. Можна використовувати такі значення: shadow: це значення ldap_user_shadow_expire допомагає визначити, чи завершено строк дії облікового запису. ad: скористатися значенням 32-бітового поля ldap_user_ad_user_account_control і дозволити доступ, якщо другий біт має нульове значення. Якщо атрибут не буде знайдено, доступ буде дозволено. Також буде перевірено, чи не вичерпано строк дії облікового запису. rhds, ipa, 389ds: використовувати для перевірки доступу значення ldap_ns_account_lock. nds: для перевірки доступу використовувати значення ldap_user_nds_login_allowed_time_map, ldap_user_nds_login_disabled і ldap_user_nds_login_expiration_time. Якщо не буде виявлено жодного з цих атрибутів, надати доступ. Будь ласка, зауважте, що параметр налаштування ldap_access_order має включати expire, щоб можна було користуватися параметром ldap_account_expire_policy. Типове значення: порожній рядок ldap_access_order (рядок) Список відокремлених комами параметрів керування доступом. Можливі значення списку: filter: використовувати ldap_access_filter lockout: використовувати блокування облікових записів. Якщо встановлено, цей параметр забороняє доступ, якщо існує атрибут ldap «pwdAccountLockedTime» і його значенням є «000001010000Z». Будь ласка, ознайомтеся із документацією до параметра ldap_pwdlockout_dn. Зауважте, що для працездатності цієї можливості слід встановити «access_provider = ldap». Будь ласка, зауважте, що цей параметр має нижчий пріоритет за параметр «ppolicy», його може бути вилучено у наступних випусках. ppolicy: використовувати блокування облікових записів. Якщо встановлено, забороняє доступ у випадку наявності атрибута ldap «pwdAccountLockedTime» рівного «000001010000Z» або такого, що відповідає моменту часу у минулому. Значення атрибута «pwdAccountLockedTime» має завершуватися на «Z», що позначає часовий пояс UTC. Підтримки інших часових поясів у поточній версії не передбачено, їхнє використання призводитиме до появи повідомлення про заборону доступу, коли користувачі намагатимуться увійти до системи. Докладніший опис можна знайти у розділі щодо параметра ldap_pwdlockout_dn. Будь ласка, зауважте, що для працездатності цього параметра слід встановити значення «access_provider = ldap». expire: використовувати ldap_account_expire_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. Будь ласка, зауважте, що для того, щоб цим можна було скористатися, слід встановити «access_provider = ldap». Крім того, слід встановити для параметра «ldap_pwd_policy» відповідні правила поводження із паролями. authorized_service: використовувати для визначення можливості доступу атрибут authorizedService host: за допомогою цього атрибута вузла можна визначити права доступу rhost: використовувати атрибут rhost для визначення того, чи матиме віддалений вузол доступ Будь ласка, зауважте, що значення поля rhost у pam встановлюється програмою. Варто перевірити, що програма надсилає pam, перш ніж вмикати цей варіант керування доступом. Типове значення: filter Зауважте, що програма повідомить про помилку, якщо одне значення було використано декілька разів. ldap_pwdlockout_dn (рядок) За допомогою цього параметра визначається DN запису правил поводження із паролями на сервері LDAP. Будь ласка, зауважте, що те, що цього параметра не буде у sssd.conf, у випадку увімкненого блокування облікових записів призведе до заборони доступу, оскільки атрибути ppolicy на сервері LDAP не можна буде перевірити належним чином. Приклад: cn=ppolicy,ou=policies,dc=example,dc=com Типове значення: cn=ppolicy,ou=policies,$ldap_search_base ldap_deref (рядок) Визначає спосіб виконання розіменовування псевдонімів під час виконання пошуку. Можливі такі варіанти: never: ніколи не виконувати розіменування псевдонімів. searching: розіменування псевдонімів відбувається у межах основного об’єкта, а не на основі визначення місця основного об’єкта пошуку. finding: розіменування псевдонімів відбувається лише під час визначення місця основного об’єкта пошуку. always: розіменування псевдонімів відбувається як під час пошуку, так і під час визначення місця основного об’єкта пошуку. Типове значення: не встановлено (обробка бібліотеками LDAP клієнта за сценарієм never) ldap_rfc2307_fallback_to_local_users (булеве значення) Надає змогу зберігати локальних користувачів як учасників групи LDAP для серверів, у яких використовується схема RFC2307. У деяких середовищах, де використовується схема RFC2307, локальних користувачів можна зробити учасниками груп LDAP додаванням імен цих користувачів до атрибута memberUid. Узгодженість домену може бути скомпрометовано, якщо буде виконано подібне додавання учасника, тому SSSD за звичайних умов вилучає записи користувачів, яких «не вистачає», з кешованих даних щодо участі у групах, щойно nsswitch спробує отримати дані щодо користувачів за допомогою виклику getpw*() або initgroups(). У разі використання цього параметра програма повертається до перевірки посилань на локальних користувачів і кешує їх так, що наступні виклики initgroups() розширюватимуть список локальних користувачів додатковими групами LDAP. Типове значення: false wildcard_limit (ціле число) Визначає верхню межу для кількості записів, які отримуватимуться під час пошуку з використанням символів-замінників. У поточній версії пошук із використанням символів-замінників передбачено лише для відповідача InfoPipe. Типове значення: 1000 (часто розмір однієї сторінки) ldap_library_debug_level (ціле число) Вмикає діагностику libldap із вказаним рівнем. Діагностичні повідомлення libldap буде записано незалежно від загального debug_level. OpenLDAP використовує бітову карту для вмикання діагностики для певних компонентів, -1 увімкне повне виведення діагностичних даних. Типове значення: 0 (діагностику libldap вимкнено) Докладні настанов щодо налаштовування sudo_provider можна знайти на сторінці довідника (man) sssd-sudo 5 . ldap_sudo_full_refresh_interval (ціле число) Проміжок часу у секундах між послідовними повними оновленнями правил sudo SSSD у автоматичному режимі. Під час таких оновлень буде отримано повний набір правил, що зберігаються на сервері. Це значення має перевищувати значення ldap_sudo_smart_refresh_interval Ви можете вимкнути повне оновлення встановленням для цього параметра значення 0. Втім, обов'язково має бути увімкнено або кмітливе або повне оновлення. Типове значення: 21600 (6 годин) ldap_sudo_smart_refresh_interval (ціле число) Проміжок часу у секундах між послідовними кмітливими оновленнями правил sudo SSSD у автоматичному режимі. Під час таких оновлень буде отримано всі дані правил, USN яких перевищує найбільше значення сервера USN, яке відоме SSSD. Якщо підтримки атрибутів USN на сервері не передбачено, буде використано дані атрибута modifyTimestamp. Зауваження: набільше значення USN можна оновити у три способи: 1) повним і кмітливим оновленням sudo (якщо виявлено оновлені правила), 2) нумеруванням користувачів і груп (якщо виявлено увімкнені і оновлені записи користувачів або груп) і 3) повторним з'єднанням із сервером (типово, кожні 15 хвилин, див. ldap_connection_expire_timeout). Ви можете вимкнути кмітливе оновлення встановленням для цього параметра значення 0. Втім, обов'язково має бути увімкнено або кмітливе або повне оновлення. Типове значення: 900 (15 хвилин) ldap_sudo_random_offset (ціле число) Випадковий зсув від 0 до налаштованого значення, який буде додано до кмітливого і повного періодів оновлення кожного разу під час планування регулярного завдання. Значення у секундах. Зауважте, що цей випадковий зсув буде також застосовано під час першого запуску SSSD, що затримає перше оновлення правил sudo. Затримка збільшує час, протягом якого правила sudo є недоступними для використання. Ви можете вимкнути цей зсув, встановивши значення 0. Типове значення: 0 (вимкнено) ldap_sudo_use_host_filter (булеве значення) Якщо визначено значення true, SSSD отримуватиме лише правила, що стосуються цього комп’ютера (на основі адрес вузла або мережі у форматах IPv4 і IPv6 та назв вузлів). Типове значення: true ldap_sudo_hostnames (рядок) Список назв вузлів або повних доменних назв, відокремлених пробілами, для фільтрування списку правил. Якщо значення цього параметра є порожнім, SSSD намагатиметься визначити назву вузла та повну назву комп’ютера у домені у автоматичному режимі. Якщо для ldap_sudo_use_host_filter встановлено значення false, цей параметр ні на що не впливатиме. Типове значення: не вказано ldap_sudo_ip (рядок) Список адрес вузлів або мереж у форматах IPv4 і IPv6 для фільтрування списку правил. Якщо значення цього параметра є порожнім, SSSD намагатиметься визначити адресу у автоматичному режимі. Якщо для ldap_sudo_use_host_filter встановлено значення false, цей параметр ні на що не впливатиме. Типове значення: не вказано ldap_sudo_include_netgroups (булеве значення) Якщо вказано значення true, SSSD отримуватиме всі правила, що містять мережеву групу (netgroup) у атрибуті sudoHost. Якщо для ldap_sudo_use_host_filter встановлено значення false, цей параметр ні на що не впливатиме. Типове значення: true ldap_sudo_include_regexp (булеве значення) Якщо вказано значення true, SSSD отримуватиме всі правила, що містять шаблон заміни у атрибуті sudoHost. Якщо для ldap_sudo_use_host_filter встановлено значення false, цей параметр ні на що не впливатиме. Використання символів-замінників є дуже обчислювально вартісною операцією для сервера LDAP! Типове значення: false На цій сторінці довідника наведено дані щодо відповідності назв атрибутів. Докладний опис семантики атрибутів, пов’язаних з sudo, можна знайти у довідці з sudoers.ldap5 . Деякі типові значення параметрів, описаних нижче, залежать від бази даних LDAP. ldap_autofs_map_master_name (рядок) Назва основної карти автоматичного монтування у LDAP. Типове значення: auto.master Підтримку цих параметрів передбачено доменами LDAP, але користуватися ними слід обережно. Будь ласка, використовуйте їх у налаштуваннях, лише якщо вам відомі наслідки ваших дій. ldap_netgroup_search_base (рядок) ldap_user_search_base (рядок) ldap_group_search_base (рядок) Якщо увімкнено параметр ldap_use_tokengroups, пошуки в Active Directory не буде обмежено — він повертатиме усі дані щодо участі у групах, навіть без прив'язки до GID. Рекомендуємо вимкнути цю можливість, якщо назви груп показуються неправильно. ldap_sudo_search_base (рядок) ldap_autofs_search_base (рядок) У наведеному нижче прикладі припускається, що SSSD налаштовано належним чином, а LDAP встановлено на один з доменів з розділу [domains]. [domain/LDAP] id_provider = ldap auth_provider = ldap ldap_uri = ldap://ldap.mydomain.org ldap_search_base = dc=mydomain,dc=org ldap_tls_reqcert = demand cache_credentials = true У наведеному нижче прикладі припускається, що SSSD налаштовано належним чином і використано ldap_access_order=lockout. [domain/LDAP] id_provider = ldap auth_provider = ldap access_provider = ldap ldap_access_order = lockout ldap_pwdlockout_dn = cn=ppolicy,ou=policies,dc=mydomain,dc=org ldap_uri = ldap://ldap.mydomain.org ldap_search_base = dc=mydomain,dc=org ldap_tls_reqcert = demand cache_credentials = true Описи деяких з параметрів налаштування на цій сторінці підручника засновано на даних сторінки підручника (man) ldap.conf 5 з пакунка OpenLDAP 2.4.