Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Настройка OpenLDAP для пользователей ОС семейства "Альт"

Ниже приведены инструкции по настройке и резервированию OpenLDAP для ОС семейства "Альт".

Все команды настройки OpenLDAP необходимо выполнять от имени суперпользователя root. Для этого перед вводом каждой команды введите sudo, либо, прежде чем вводить команды, перейдите в режим суперпользователя с помощью команды su.

При настройке OpenLDAP понадобится редактировать конфигурационные файлы. Для создания и редактирования текстовых файлов на ОС Linux предлагается использовать редактор NANO. Команда nano позволяет открыть существующий или создать новый файл с указанным именем. В результате вызова команды файл откроется в соответствующем редакторе.

Если используете редактор NANO, то:

  • чтобы сохранить файл, нажмите сочетание клавиш Ctrl + O;
  • чтобы выйти из редактора, нажмите сочетание клавиш Ctrl + X;
  • чтобы вызвать справку, нажмите сочетание клавиш Ctrl + G.

Текстовые файлы (файлы-схемы, LDIF-файлы), служащие для настройки OpenLDAP, формируются с учетом следующих правил:

  • пробелы и табуляция недопустимы перед ключевыми словами (overlay, index, syncrepl, updateref, и т.п.);
  • там, где пробелы используются для отступа в начале строки для улучшения читаемости текста, следует ставить два пробела подряд.

Будьте внимательны при копировании текстовых блоков из этого раздела (в нем правила формирования файлов учтены) и при редактировании файлов вручную.

Настройка OpenLDAP

Прежде чем перейти к настройке:

  1. Убедитесь, что установили пакеты, необходимые для доступа и изменения каталогов OpenLDAP, как описано в разделе Установка и удаление.
  2. Сгенерируйте шифрованное значение пароля для учетной записи администратора LDAP с помощью команды:

    slappasswd

    Шифрованное значение имеет вид {SSHA}строка_символов. Сохраните полученное значение для следующих шагов настройки.

Настройка сервера FTP (vsftpd)

  1. Установите сервер с помощью команды:
    sudo apt-get install vsftpd anonftp
  2. Перейдите к файлу /etc/xinetd.d/vsftpd. Установите disable = no.
  3. Перейдите к файлу /etc/xinetd.conf. Закомментируйте only_from = 127.0.0.1.
  4. Перезапустите сервис с помощью команды:
    sudo service xinetd restart

    либо

    sudo systemctl restart xinetd.service

    Затем разрешите запуск сервиса вместе с операционной системой с помощью команды:

    sudo chkconfig xinetd on

    либо

    sudo systemctl enable xinetd.service

Настройка и запуск сервиса OpenLDAP

Настройте и запустите OpenLDAP.

  1. Перейдите к файлу /etc/openldap/slapd.conf.
    1. Задайте уровень логирования выше установленного по умолчанию – вместо 0 установите 5: loglevel 5.
    2. Убедитесь, что в файле не закомментирована следующая строка: include /etc/openldap/slapd-mdb-db01.conf. Она подключает содержимое указанного файла.
  2. Создайте директорию для хранения баз данных с помощью команды:
    sudo mkdir /var/lib/ldap/bases/maxcrc.com
  3. Перейдите к файлу /etc/openldap/slapd-mdb-db01.conf. Измените в нём следующие строки:
    • suffix "dc=example,dc=com" замените на suffix "dc=maxcrc,dc=com";
    • убедитесь, что rootdn "cn=admin,dc=maxcrc,dc=com";
    • directory /var/lib/ldap/bases/example.com замените на directory /var/lib/ldap/bases/maxcrc.com;
    • rootpw secret замените на rootpw {SSHA}строка_символов, где {SSHA}строка_символов – шифрованное значение пароля администратора, полученное ранее;
    • конструкцию

      access to attrs=userPassword
      by self write
      by anonymous auth
      by * none

      замените на

      access to *
      by anonymous read
      by users write
    • добавьте конструкцию в зависимости от версии операционной системы:

      • для Alt Linux 10 добавьте конструкцию:

        database monitor
        access to dn.subtree="cn=Monitor"
        by dn.exact="cn=admin,dc=maxcrc,dc=com" write
        by users write
        by * none
      • для Alt Linux 11 добавьте конструкцию:

        database monitor
        access to dn.subtree="cn=Monitor"
        by dn.exact="cn=admin,dc=maxcrc,dc=com" write
        by dn.regex="^uid=([^,]+),ou=Users,ou=([^,]+)Security,dc=maxcrc,dc=com$" write
        by self write
        by anonymous none
  4. Перейдите к файлу /etc/sysconfig/ldap. Далее порядок действий зависит от версии операционной системы:

    • для Alt Linux 10 раскомментируйте в файле строку SLAPDURLLIST="'ldapi:/// ldap:/// ldaps:///'".
    • для Alt Linux 11 раскомментируйте в файле строку SLAPDURLLIST и удалите из нее двойные кавычки, получится: SLAPDURLLIST='ldapi:/// ldap:/// ldaps:///'.
  5. Примените файл схемы security.schema, поставляемый при установке OpenLDAP на Windows, в директорию /etc/openldap/schema. В ОС Windows файл можно найти в папке C:\Program Files\OpenLDAP\schema. Также файл можно скачать здесь.
    1. Предоставьте всем пользователям права на чтение скопированного файла схемы с помощью команды:
      sudo chmod a+r /etc/openldap/schema/security.schema
    2. Затем перейдите к файлу /etc/openldap/slapd.conf. Откройте его в режиме редактирования. В конец списка подключаемых схем добавьте строку, подключающую скопированный файл схемы: include /etc/openldap/schema/security.schema.
  6. Запустите сервис slapd и разрешите ему запускаться после перезагрузки операционной системы с помощью команд:
    sudo systemctl start slapd
    sudo systemctl enable slapd

    Убедиться в том, что сервис запущен, и ему разрешено запускаться после перезагрузки ОС, можно с помощью команд:

    sudo systemctl status slapd
    sudo journalctl -xeu slapd
  7. Создайте еще один файл схемы entry.ldif. Добавьте в него следующие строки:
    dn: dc=maxcrc,dc=com
    objectClass: organization
    objectClass: dcObject
    dc: maxcrc
    o: com

    Сохраните и закройте файл. Примените созданный файл схемы с помощью команды:

    sudo ldapadd -x -f entry.ldif -H ldap:/// -D cn=admin,dc=maxcrc,dc=com -w secret

    где вместо secret следует указать пароль администратора LDAP в незашифрованном виде. В результате успешного выполнения команды в терминале должна появиться строка:

    adding new entry "dc=maxcrc,dc=com".

Завершение настроек и создание каталога на LDAP-сервере

По завершении всех описанных выше действий перезапустите сервисы агента безопасности и OpenLDAP для применения новых настроек.

Теперь сервер OpenLDAP настроен и запущен. Чтобы начать создавать учетные записи пользователей, объединять их в группы и наделять правами, нужно создать каталог на LDAP-сервере, в котором будет храниться создаваемая конфигурация. Сделать это можно с помощью программ SecurityConfigurator и Alpha.HMI.SecurityConfigurator: 

  • SecurityConfigurator поставляется вместе с дистрибутивом Alpha.Security и может быть установлен только в ОС Windows.

    Процесс создания нового каталога на LDAP-сервере и подключения к нему описан в разделе Подключение к LDAP-серверу из SecurityConfigurator. Обратите внимание, что в таком случае оба компьютера – с конфигуратором на Windows и с LDAP-сервером на Linux – должны быть объединены в сеть Alpha.Net. Подробнее о том, как объединить компьютеры в сеть, можно прочитать в разделе Организация кластерного рабочего места или в документации на Alpha.Domain.

  • Alpha.HMI.SecurityConfigurator является кроссплатформенным решением, и может быть установлен как в ОС Windows, так и в ОС Linux.

    При первом подключении этого конфигуратора к агенту безопасности каталог будет создан автоматически (название каталога указано в конфигурационном файла агента безопасности). Учетные данные администратора каталога – логин administrator и пароль secret. Подробнее о том, как использовать этот конфигуратор и создавать в нем каталоги, читайте в документации на Alpha.HMI.SecurityConfigurator.

Резервирование LDAP-сервера

Резервирование LDAP-сервера позволяет синхронизировать конфигурации двух и более серверов. Для ОС семейства "Альт" пока описана только инструкция по настройке разнонаправленного резервирования, при котором синхронизируются конфигурации нескольких серверов.

Прежде чем перейти к настройкам резервирования:

  1. Остановите сервис slapd на всех серверах, которые будут участвовать в резервировании, с помощью команды:

    sudo systemctl stop slapd

    Также следует остановить все остальные службы, взаимодействующие с OpenLDAP.

  2. Растиражируйте базу одного из резервируемых серверов на остальные сервера, чтобы содержимое баз резервируемых серверов было идентично. База сервера представляет собой файл DB_CONFIG, расположенный в папке /var/lib/ldap/bases/maxcrc.com.

Затем на каждом резервируемом сервере:

  1. Перейдите к файлу /etc/openldap/slapd.conf. В разделе ##Overlays добавьте или раскомментируйте строку moduleload<---->syncprov.la.
  2. Перейдите к файлу /etc/openldap/slapd-mdb-db01.conf. Сразу после раздела, описывающего настройки репликации (раздел начинается строкой # Replication setup for this database, и заканчивается строкой ## Replication setup - end), редактируйте файл следующим образом:
    1. Добавьте строку с ID текущего сервера:

      serverid 1

      ID может быть любым, главное, чтобы в пределах группы резервируемых серверов он был уникальным (например, если у вас два резервируемых сервера, на одном можно указать serverid 1, на другом – serverid 2).

    2. Сделайте отступ в одну строку и добавьте приведенную ниже конструкцию syncrepl. Эта конструкция будет описывать один из серверов, резервирующих текущий сервер. Таких конструкций нужно добавить столько, сколько серверов резервируют текущий сервер (например, если в группе всего три сервера, здесь будет две конструкции syncrepl):

      serverid 1
      
      syncrepl
        rid=001
        provider=ldap://102.108.50.102:389
        bindmethod=simple
        binddn="cn=admin,dc=maxcrc,dc=com"
        credentials="secret"
        searchbase="dc=maxcrc,dc=com"
        scope=sub
        schemachecking=on
        type=refreshAndPersist
        retry="30 5 300 3"
        interval=00:00:05:00
      syncrepl
        rid=002
        provider=ldap://102.108.50.103:389
        bindmethod=simple
        binddn="cn=admin,dc=maxcrc,dc=com"
        credentials="secret"
        searchbase="dc=maxcrc,dc=com"
        scope=sub
        schemachecking=on
        type=refreshAndPersist
        retry="30 5 300 3"
        interval=00:00:05:00

      Здесь, в рамках каждой конструкции syncrepl, нужно указать:

      • Уникальный в пределах текущего файла rid для описываемого сервера (в строке rid=001).
      • IP-адрес описываемого сервера (в строке provider=ldap://102.108.50.102:389).
      • Логин учетной записи администратора описываемого сервера (в строке binddn="cn=admin,dc=maxcrc,dc=com" – вместо admin).
      • Пароль учетной записи администратора описываемого сервера в незашифрованном виде (в строке credentials="secret").

      Если же вам необходимо скрыть пароль администратора, то настройка этого блока будет отличаться: перейдите к подразделу Настройка резервирования без указания пароля администратора.

    3. После того, как с помощью конструкций syncrepl опишете все сервера, резервирующие текущий сервер, снова сделайте отступ в одну строку и добавьте следующий блок:

      mirrormode TRUE
      overlay syncprov
      syncprov-checkpoint 100 1
      syncprov-sessionlog 100
      index entryCSN eq
      index entryUUID eq
    4. Сохраните и закройте файл.

После того, как отредактируете оба файла на всех резервируемых серверах, запустите сервис slapd каждого из них с помощью команды:

sudo systemctl start slapd

Также следует запустить все остальные службы, взаимодействующие с OpenLDAP. Затем можно подключиться напрямую к каждой базе, чтобы убедиться, что ошибок не возникло. Для проверки внесите изменения в конфигурацию на одном из серверов. Убедитесь, что эти изменения появились и на других серверах.

Настройка резервирования без указания пароля администратора

Для того, чтобы не указывать пароль администратора в файле /etc/openldap/slapd-mdb-db01.conf при настройке резервирования, используйте решение с использованием сертификатов OpenSSL и защищенного соединения. Необходимо выполнить следующие шаги по порядку:

  1. Включить защищенное соединение.
  2. Обновить сертификаты безопасности.
  3. Настроить резервирование серверов.

Включить защищенное соединение

Для того, чтобы использовать защищенное соединение при подключении к OpenLDAP, выполните следующие шаги:

  1. В файле /etc/sysconfig/ldap раскомментируйте строку:
    SLAPDURLLIST="'ldapi:/// ldap:/// ldaps:///'"
  2. В файле /etc/openldap/slapd.conf раскомментируйте следующие строки:
    TLSCipherSuite HIGH:MEDIUM:+SSLv2
    TLSCACertificateFile /var/lib/ssl/cert.pem
    TLSCACertificatePath /var/lib/ssl/certs
    TLSCertificateFile /var/lib/ssl/certs/slapd.cert
    TLSCertificateKeyFile /var/lib/ssl/private/slapd.key

    Строку #TLSVerifyClient never при этом следует оставить закомментированной.

  3. Перезапустите сервис slapd:
    sudo systemctl restart slapd

Теперь при подключении к OpenLDAP можно использовать защищенное соединение. Если есть возможность, попробуйте подключиться к LDAP-серверу с помощью SecurityConfigurator, установленном на Windows. В окне подключения установите галочку напротив выбранного протокола безопасности, а адрес LDAP-сервера укажите в виде 102.108.50.101:xxx, где вместо 102.108.50.101 следует указать IP-адрес OpenLDAP, а вместо xxx – порт подключения:

  • 636 – если выбрали протокол SSL;
  • 389 – если выбрали протокол TLS.

Потребуется установить сертификат безопасности. Подробнее об этом – в разделе Подключение к LDAP-серверу из SecurityConfigurator.

Обновить сертификаты безопасности

Если вам необходимо использовать новые сертификаты вместо тех, что предоставляются сервисом slapd автоматически, необходимо выполнить следующие действия:

  1. Измените хостовые имена компьютеров с резервируемыми LDAP-серверами. Сделать это можно, отредактировав файл /etc/hostname, или выполнив команду:

    sudo hostnamectl set-hostname name

    где name – хостовое имя.

    Для примера далее будут использованы имена двух резервируемых серверов: host-1 и host-2.

    Убедитесь, что компьютеры доступны друг для друга, с помощью команды ping name, без использования IP-адресов.

  2. Перегенерируйте сертификат, автоматически предоставляемый сервисом slapd. Для этого удалите файлы /var/lib/ssl/certs/slapd.cert, /var/lib/ssl/private/slapd.key и /var/lib/ssl/certs/slapd.csr, затем перезапустите сервис slapd. Новый сертификат будет автоматически создан и использован сервисом slapd. Убедитесь, что созданы новые файлы вместо удаленных.
  3. Затем на всех компьютерах скопируйте сгенерированный сертификат (содержимое файла /var/lib/ssl/certs/slapd.cert) в конец файла /var/lib/ssl/cert.pem. То же самое проделайте с сертификатами остальных компьютеров домена, если они будут взаимодействовать с использованием TLS/SSL.
  4. Если по какой-то причине необходимо вручную создать собственный сертификат, следует отключить вызов ExecStartPre=/usr/bin/cert-sh ... в юнит-файле /lib/systemd/system/slapd.service, а затем выполнить генерацию и подключение сертификата. Здесь эта процедура не описана, т.к. для резервирования в большинстве случае достаточно сертификатов slapd.

В ОС семейства "Альт" при запуске сервиса slapd из юнит-файла службы запускается скрипт /usr/bin/cert-sh, который выполняет другой скрипт – /usr/bin/cert-sh-functions. В нем выполняется проверка истечения срока действия сгенерированного им же ранее сертификата, и, если срок истекает или сертификат отсутствует, то скрипт создает новый сертификат для slapd. В файле /usr/bin/cert-sh-functions есть параметр, задающий срок действия сертификата (в сутках). Этот срок можно увеличить.

Настроить резервирование серверов

Чтобы настроить резервирование:

  1. На каждом сервере измените значение TLSVerifyClient в файлах slapd.conf:
    TLSVerifyClient allow

    Здесь же задайте уровень loglevel 5 или больше (до 32767), чтобы видеть сообщения о попытках выполнения резервирования.

  2. На каждом сервере добавьте сертификаты всех резервируемых серверов (содержимое файлов ldapd.cert), в конец файла /var/lib/ssl/cert.pem. Проверьте доступность соседнего сервера для каждого сервера с помощью команды ldapsearch. Так, например, на сервере host-1 должно выполниться без ошибок:
    sudo ldapsearch -x -H ldap://host-2 -b "dc=maxcrc,dc=com" -ZZ uid=admin
    sudo ldapsearch -x -H ldaps://host-2 -b "dc=maxcrc,dc=com" uid=admin

    а на сервере host-2 должно выполниться без ошибок:

    sudo ldapsearch -x -H ldap://host-1 -b "dc=maxcrc,dc=com" -ZZ uid=admin
    sudo ldapsearch -x -H ldaps://host-1 -b "dc=maxcrc,dc=com" uid=admin
  3. Теперь нужно проверить успешность репликации баз между серверами по протоколу ldap://. Измените блок настройки резервирования на все резервируемых серверах в файлах /etc/openldap/slapd-mdb-db01.conf в зависимости от выбранного метода шифрования:

    • Если используете TLS, для host-1 укажите:

      syncrepl
       rid=001
       provider=ldap://host-1:389
       bindmethod=simple
       binddn="cn=admin,dc=maxcrc,dc=com"
       credentials="secret"
       searchbase="dc=maxcrc,dc=com"
       scope=sub
       schemachecking=on
       type=refreshAndPersist
       retry="30 5 300 3"
       interval=00:00:05:00
       starttls=yes

      а для host-2 укажите:

      syncrepl
       rid=001
       provider=ldap://host-2:389
       bindmethod=simple
       binddn="cn=admin,dc=maxcrc,dc=com"
       credentials="secret"
       searchbase="dc=maxcrc,dc=com"
       scope=sub
       schemachecking=on
       type=refreshAndPersist
       retry="30 5 300 3"
       interval=00:00:05:00
       starttls=yes

      Обратите внимание на то, что имена host-1 и host-2 должны точно совпадать с содержащимися в сгенерированных и подключенных сертификатах. В противном случае в журнале возникнет ошибка инициализации TLS (-11) при установке соединения, и репликация не будет выполняться.

      После изменения этих блоков перезапустите сервис slapd обоих серверов и убедитесь, что репликация баз успешно выполняется.

    • Если используете SSL для host-1 укажите:

      syncrepl
       rid=001
       provider=ldaps://host-1:636
       bindmethod=simple
       binddn="cn=admin,dc=maxcrc,dc=com"
       credentials="secret"
       searchbase="dc=maxcrc,dc=com"
       scope=sub
       schemachecking=on
       type=refreshAndPersist
       retry="30 5 300 3"
       interval=00:00:05:00

      а для host-2 укажите:

      syncrepl
       rid=001
       provider=ldaps://host-2:636
       bindmethod=simple
       binddn="cn=admin,dc=maxcrc,dc=com"
       credentials="secret"
       searchbase="dc=maxcrc,dc=com"
       scope=sub
       schemachecking=on
       type=refreshAndPersist
       retry="30 5 300 3"
       interval=00:00:05:00

      Обратите внимание на то, что имена host-1 и host-2 должны точно совпадать с содержащимися в сгенерированных и подключенных сертификатах. В противном случае в журнале возникнет ошибка инициализации TLS/SSL (-11) при установке соединения, и репликация не будет выполняться.

  4. После изменения блоков syncrepl, как описано в пункте 3, на каждом сервере перезапустите сервис slapd и убедитесь, что репликация баз успешно выполняется.
  5. Вернитесь к редактированию файлов /etc/openldap/slapd-mdb-db01.conf на всех резервируемых серверах. В добавленных вами конструкциях syncrepl нужно вместо строк:

     bindmethod=simple
     credentials=secret

    указать:

     bindmethod=sasl
     saslmech=EXTERNAL
  6. Снова перезапустите сервис slapd на каждом сервере и убедитесь, что репликация баз успешно выполняется.