Alpha.Community

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

Настройка OpenLDAP для пользователей DEB-систем

Ниже приведены инструкции по настройке и резервированию OpenLDAP для Ubuntu и Astra Linux.

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

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

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

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

Для настройки LDAP-сервера необходимо последовательно выполнить все шаги, описанные в данном разделе. Инструкция описана для Ubuntu 16.04. Настройка для Astra Linux может отличаться.

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

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

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

Настройка OpenLDAP

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

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

    slappasswd

    Шифрованное значение имеет вид {SSHA}строка_символов.

    Сохраните полученное значение для следующих шагов настройки.

Затем последовательно выполните действия, описанные в подразделах ниже.

Создать учетную запись администратора LDAP-сервера

Если при установке OpenLDAP учетная запись была создана, и для нее нужно было придумать пароль, этот шаг можно пропустить и перейти к следующему пункту Переименовать домен базы данных LDAP.

  1. Создайте файл-схему ldaprootpasswd.ldif, который используется для добавления учетной записи администратора в каталог LDAP:
    sudo nano ldaprootpasswd.ldif

    Добавьте в файл следующее:

    dn: olcDatabase={0}config,cn=config
    changetype: modify
    add: olcRootPW
    olcRootPW: {SSHA}строка_символов

    где {SSHA}строка_символов – шифрованное значение пароля, полученное выше.

  2. Примените файл-схему, созданный выше:
    sudo ldapadd -Y EXTERNAL -H ldapi:/// -f ldaprootpasswd.ldif

Переименовать домен базы данных LDAP

При установке OpenLDAP в качестве имени домена по умолчанию используется значение nodomain. Значение имени домена по умолчанию для компонентов Alpha.Security – maxcrc.com. Эту настройку обязательно нужно выполнить.

Чтобы изменить имя домена, используйте команду:

sudo dpkg-reconfigure slapd

В открывшемся окне на вопрос Не выполнять настройку сервера OpenLDAP? ответьте No. Запустится конфигуратор LDAP-сервера. В конфигураторе:

  • в качестве имени домена задайте строку maxcrc.com;
  • название организации укажите произвольное;
  • затем укажите пароль администратора дважды;
  • оставьте значение типа папки /var/lib/ldap по умолчанию – mdb;
  • оставьте протокол по умолчанию – ldap.v3;
  • на вопрос Удалять базу данных при удалении slapd? ответьте так, как считаете нужным;
  • на вопрос Переместить старую базу данных? ответьте Да, если есть файлы старой базы данных.

Затем перезапустите сервис slapd:

sudo systemctl restart slapd

Определить структуру каталогов на LDAP-сервере

После установки OpenLDAP структура каталогов на сервере еще не определена. Эту настройку обязательно нужно выполнить.

Чтобы сформировать структуру данных внутри каталогов LDAP, нужно применить файлы схемы. Необходимые файлы схемы alpha.security.ldif и shell-скрипт alpha.security.schema.export.sh устанавливаются вместе с пакетом Alpha.Security.

  1. Для применения схемы выполните следующие команды:
    cd /opt/Automiq/Alpha.Security
    sudo sh ./alpha.security.schema.export.sh

    Примененную схему можно увидеть по команде:

    sudo ls -la /etc/ldap/slapd.d/cn=config/cn=schema/
  2. Перезапустите сервис slapd:
    sudo systemctl restart slapd
  3. Для проверки можно подключиться к OpenLDAP из программы LdapAdmin.exe. При подключении укажите следующие параметры:
    • Host: 127.0.0.1 (либо укажите нужный IP-адрес сервера), Port: 389, Version: 3.
    • Base: dc=maxcrc,dc=com.
    • Установите галочку на Simple authentication, остальные снимите.
    • Account Username: cn=admin,dc=maxcrc,dc=com.
    • Password: secret (либо указанный при установке).

Применить шаблон политики контроля доступа

Чтобы содержимое каталогов можно было просматривать и редактировать, нужно настроить политики контроля доступа. Для этого следует применить файл-схему с описанием прав доступа к OpenLDAP, поставляемый в составе дистрибутива Alpha.Security. Файл для анонимных пользователей делает доступным чтение, для зарегистрированных пользователей – редактирование каталогов.

Перейдите к каталогу /opt/Automiq/Alpha.Security и примените файл-схему командой:

sudo ldapadd -Y EXTERNAL -H ldapi:/// -f access.ldif

Проверьте содержимое файла access.ldif. Оно должно выглядеть следующим образом:

dn: olcDatabase={1}mdb,cn=config
changetype: modify
replace: olcAccess
olcAccess: {0}to * by users write by * read

На месте {1}mdb должен быть указан тип вашей базы. Проверить имя и тип базы данных (hdb, mdb, и т.п.) с помощью команды:

sudo slapcat -n0

Пример искомого значения: dn: olcDatabase={1}mdb,cn=config.

Импортировать настройки модуля мониторинга

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

  1. Перейдите в папку установки Alpha.Security:
    cd /opt/Automiq/Alpha.Security
  2. Примените настройки модуля с помощью команды:
    sudo sh ./monitor.export.sh

Запустить службы после выполнения настройки

После выполнения всех настроек запустите сервис slapd и разрешите ему запускаться после перезагрузки операционной системы с помощью команд:

sudo systemctl start slapd
sudo systemctl enable slapd

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

sudo systemctl status slapd
sudo journalctl -xeu slapd

Создать каталог на LDAP-сервере

Чтобы начать создавать учетные записи пользователей, объединять их в группы и наделять правами, нужно создать каталог на 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. Сгенерируйте шифрованное значение нового пароля для учетной записи администратора LDAP с помощью команды:

    slappasswd

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

  2. Проверьте имя и тип базы данных (hdb, mdb, и т.п.) с помощью команды:
    slapcat -n0

    Пример искомого значения: dn: olcDatabase={1}mdb,cn=config.

  3. Создайте файл-схему change-rootdn.ldif. Добавьте в файл текст в зависимости от того, какие данные нужно изменить:

    • Если нужно изменить только логин администратора, добавьте в файл следующее:

      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      replace: olcRootDN
      olcRootDN: cn=newadmin,dc=maxcrc,dc=com

      где вместо {1}mdb нужно указать тип вашей базы, определенный на шаге 2, а вместо newadmin – новый логин администратора.

    • Если нужно изменить только пароль администратора, добавьте в файл следующее:

      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      replace: olcRootPW
      olcRootPW: {SSHA}строка_символов

      где вместо {1}mdb нужно указать тип вашей базы, определенный на шаге 2, а вместо {SSHA}строка_символов – новый логин администратора.

    • Если нужно изменить и логин, и пароль администратора, добавьте в файл следующее:

      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      replace: olcRootDN
      olcRootDN: cn=newadmin,dc=maxcrc,dc=com
      -
      replace: olcRootPW
      olcRootPW: {SSHA}строка_символов

      где вместо {1}mdb нужно указать тип вашей базы, определенный на шаге 2, вместо newadmin – новый логин администратора, а вместо {SSHA}строка_символов – новый логин администратора.

  4. Примените созданный файл-схему и перезапустите сервис slapd (команды должны выполняться без ошибок):

    sudo ldapadd -Y EXTERNAL -H ldapi:/// -f change-rootdn.ldif
    sudo systemctl restart slapd

Пароль администратора LDAP будет изменен.

Обратите внимание, что логин и пароль администратора LDAP нужно указывать в конфигурационном файле агента безопасности, подробнее об этом – в разделе Агент безопасности и его настройка, подраздел Указать администратора LDAP.

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

Резервирование (репликация) LDAP-сервера позволяет синхронизировать конфигурации двух и более серверов. Резервирование может быть:

  • однонаправленным – в этом случае конфигурация одного сервера (поставщика) тиражируется на другие сервера (приемники);
  • разнонаправленным – в этом случае синхронизируются конфигурации нескольких серверов.

Однонаправленное резервирование

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

  1. Убедитесь, что типы баз данных всех серверов – mdb, с помощью команды:
    sudo slapcat -n0

    Пример искомого значения: dn: olcDatabase={1}mdb,cn=config. Если тип БД отличается, то во всех файлах, создаваемых и применяемых в инструкции ниже, следует указывать правильный тип базы.

  2. Сделайте бэкап конфигурации и БД сервера-поставщика в текущей папке с помощью команды:
    cd /opt/Automiq/Alpha.Security
    sudo sh ./openldap-conf-and-data-backup.sh

    Для восстановления конфигурации и БД OpenLDAP в случае ошибок резервирования, выполните команды:

    cd /opt/Automiq/Alpha.Security
    sudo sh ./openldap-conf-and-data-restore.sh

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

  1. Определите, какой из LDAP-серверов будет поставщиком, а какие – приемниками.
  2. Настройте сервера-приемники:

    Описанные в пункте действия выполните на каждом из серверов-приемников.

    1. Ознакомьтесь с файлом openldap-enable-syncrepl-consumer.ldif, устанавливаемым в составе Alpha.Security:
      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      #delete: olcSyncrepl
      add: olcSyncrepl
      olcSyncrepl:
        rid=001
        provider=ldap://192.168.56.1
        binddn="cn=admin,dc=maxcrc,dc=com"
        bindmethod=simple
        credentials="secret"
        searchbase="dc=maxcrc,dc=com"
        type=refreshAndPersist
        timeout=0
        network-timeout=0
        retry="60 +"
      
      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      #delete: olcUpdateRef
      add: olcUpdateRef
      olcUpdateRef: ldap://192.168.56.1

      Обратите внимание, что отступ в каждой строке внутри конструкции olcSyncRepl обязательно должен содержать по два пробела.

    2. Измените следующие строки:
      • dn: olcDatabase={1}mdb,cn=config – замените {1}mdb на текущий тип БД, если он отличается;
      • provider=ldap://192.168.56.1 – замените значение по умолчанию 192.168.56.1 на адрес сервера-поставщика данных;
      • credentials="secret" – если меняли пароль администратора OpenLDAP, замените secret на актуальное значение;
      • olcUpdateRef: ldap://192.168.56.1 – замените значение по умолчанию 192.168.56.1 на адрес сервера-поставщика данных.
    3. Для применения внесенных изменений выполните команды:
      cd /opt/Automiq/Alpha.Security
      sudo sh ./openldap-enable-syncrepl-consumer.sh
    4. Перезапустите сервис slapd:
      sudo systemctl restart slapd
  3. Настройте сервер-поставщик:
    1. Ознакомьтесь с файлом openldap-enable-syncrepl-provider.ldif, устанавливаемым в составе Alpha.Security:
      dn: cn=module{0},cn=config
      changetype: modify
      add: olcModuleLoad
      olcModuleLoad: syncprov.la
      
      dn: olcOverlay=syncprov,olcDatabase={1}mdb,cn=config
      changetype: add
      objectClass: olcOverlayConfig
      objectClass: olcSyncProvConfig
      olcOverlay: syncprov
      olcSpNoPresent: TRUE
      olcSpCheckpoint: 100 10
      olcSpSessionlog: 100
      
      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      add: olcDbIndex
      olcDbIndex: entryCSN eq
      -
      add: olcDbIndex
      olcDbIndex: entryUUID eq
    2. Замените {1}mdb на текущий тип БД, если он отличается, в строках:
      • dn: olcOverlay=syncprov,olcDatabase={1}mdb,cn=config;
      • dn: olcDatabase={1}mdb,cn=config,
    3. Для применения внесенных изменений выполните команды:
      cd /opt/Automiq/Alpha.Security
      sudo sh ./openldap-enable-syncrepl-provider.sh
    4. Перезапустите сервис slapd:
      sudo systemctl restart slapd
  4. Настройте Агент Alpha.Security:
    1. Перейдите к файлу конфигурации alpha.security.agent.xml, расположенному в /opt/Automiq/Alpha.Security. Добавьте в секцию элемента <LdapHosts /> строки с IP-адресами и портами всех резервируемых серверов:
      <LdapHosts>
      	<LDAPServer Address="127.0.0.1" Port="389"/>
      	<LDAPServer Address="172.16.13.167" Port="389"/>
      </LdapHosts>

      В данном примере:

      • 127.0.0.1 – адрес локального сервера (поставщика);
      • 172.16.13.167 – пример адреса сервера-приемника (укажите нужный адрес).
    2. Перезапустите сервис агента безопасности:
      sudo systemctl restart alpha.security.service

Разнонаправленное резервирование

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

  1. Убедитесь, что типы баз данных всех серверов – mdb, с помощью команды:
    sudo slapcat -n0

    Пример искомого значения: dn: olcDatabase={1}mdb,cn=config. Если тип БД отличается, то во всех файлах, создаваемых и применяемых в инструкции ниже, следует указывать правильный тип базы.

  2. Отключите все возможные репликации баз и серверов. Исключите вероятность подключения клиентских приложений к агенту безопасности, а агента безопасности – к резервируемым серверам.
  3. Убедитесь, что содержимое баз резервируемых серверов идентично. Чтобы синхронизировать содержимое баз данных, можно БД одного из серверов скопировать на все резервируемые сервера путем копирования файлов базы.

    Обратите внимание, что резервная копия базы, созданная с помощью Alpha.HMI.SecurityConfigurator, не подходит для синхронизации содержимого баз данных. Выполните действия, описанные ниже.

    1. Скопируйте базу, расположенную в каталоге /var/lib/ldap на выбранном сервере. Пусть скопированная база считается эталонной.
    2. На резервируемом сервере, на котором нужно заменить базу на эталонную:
      1. Проверьте владельца файлов БД с помощью команды: 

        ps aux | grep openldap

        Нужная строка с владельцем выглядит следующим образом:

        /usr/sbin/slapd -h ldap:/// ldaps:/// ldapi:/// -g openldap -u openldap -F /etc/ldap/slapd.d

        Владелец по умолчанию – openldap.

      2. Замените файлы в папке /var/lib/ldap, на эталонные, скопированные ранее.
      3. Переназначьте владельца у скопированных файлов с помощью команды:

        chown -R openldap:openldap /var/lib/ldap
      4. Перезапустите сервис slapd.
  4. Сделайте бэкап конфигурации с помощью команды:
    cd /opt/Automiq/Alpha.Security
    sudo sh ./openldap-conf-and-data-backup.sh

    Для восстановления конфигурации и БД OpenLDAP в случае ошибок резервирования, выполните команды:

    cd /opt/Automiq/Alpha.Security
    sudo sh ./openldap-conf-and-data-restore.sh
  5. Остановите все программы, взаимодействующие с серверами OpenLDAP.
  6. Убедитесь, что системное время резервируемых серверов одинаковое, иначе синхронизация изменений будет работать в одну сторону.
  7. На время настройки резервирования одного из серверов остановите остальные резервируемые сервера OpenLDAP.

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

  1. На любом из резервируемых серверов создайте файл конфигурации резервирования.

    Можно не создавать и тиражировать файл, а воспользоваться шаблонами файлов для двух резервируемых серверов, поставляемыми в составе дистрибутива Alpha.Security:

    • openldap-enable-syncrepl-multiprovider-server-1.ldif;
    • openldap-enable-syncrepl-multiprovider-server-1.sh;
    • openldap-enable-syncrepl-multiprovider-server-2.ldif;
    • openldap-enable-syncrepl-multiprovider-server-2.sh.

    Файлы необходимо редактировать так, как описано ниже.

    Назовите файл openldap-enable-syncrepl-multiprovider-server.ldif, добавьте в него следующее:

    ##########################################################
    # Check/modify database type (bdb/hdb/mbd/...), server ID (unique number), 
    # address of provider, binddn, credentials, searchbase.
    ##########################################################
    
    dn: cn=module,cn=config
    objectClass: olcModuleList
    cn: module
    olcModulePath: /usr/lib/ldap
    olcModuleLoad: syncprov.la
    
    ##########################################################
    
    dn: olcOverlay=syncprov,olcDatabase={1}mdb,cn=config
    objectClass: olcOverlayConfig
    objectClass: olcSyncProvConfig
    olcOverlay: syncprov
    olcSpSessionLog: 100
    
    ##########################################################
    
    dn: cn=config
    changetype: modify
    replace: olcServerID
    olcServerID: 1
    
    dn: olcDatabase={1}mdb,cn=config
    changetype: modify
    add: olcSyncRepl
    olcSyncRepl:
      rid=001
      provider=ldap://192.168.56.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
    -
    add: olcMirrorMode
    olcMirrorMode: TRUE

    Обратите внимание, что отступ в каждой строке внутри конструкции olcSyncRepl обязательно должен содержать по два пробела.

  2. Измените файл конфигурации следующим образом:
    1. В строке olcServerID: 1 придумайте и укажите идентификатор сервера;

      olcServerID должен быть уникальным для каждого резервируемого сервера.

    2. Замените {1}mdb на текущий тип БД, если он отличается, в строках:
      • dn: olcDatabase={1}mdb,cn=config;
      • dn: olcOverlay=syncprov,olcDatabase={1}mdb,cn=config
    3. Добавьте столько конструкций olcSyncRepl, сколько серверов резервируют текущий сервер. Каждая конструкция olcSyncRepl описывает один из резервируемых серверов.

      Внутри одного сервера параметры rid разных конструкций olcSyncRepl должны иметь уникальные значения.

      Например, если текущий сервер резервируют сразу два сервера, конструкций olcSyncRepl в файле будет две. Пример:

      ##########################################################
      # Check/modify database type (bdb/hdb/mbd/...), server ID (unique number), 
      # address of provider, binddn, credentials, searchbase.
      ##########################################################
      
      dn: cn=module,cn=config
      objectClass: olcModuleList
      cn: module
      olcModulePath: /usr/lib/ldap
      olcModuleLoad: syncprov.la
      
      ##########################################################
      
      dn: olcOverlay=syncprov,olcDatabase={1}mdb,cn=config
      objectClass: olcOverlayConfig
      objectClass: olcSyncProvConfig
      olcOverlay: syncprov
      olcSpSessionLog: 100
      
      ##########################################################
      
      dn: cn=config
      changetype: modify
      replace: olcServerID
      olcServerID: 1
      
      dn: olcDatabase={1}mdb,cn=config
      changetype: modify
      add: olcSyncRepl
      olcSyncRepl:
        rid=001
        provider=ldap://192.168.56.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
      olcSyncRepl:
        rid=002
        provider=ldap://192.168.57.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
      -
      add: olcMirrorMode
      olcMirrorMode: TRUE
    4. В каждой конструкции olcSyncRepl укажите IP-адрес и порт сервера, который она описывает, в строке параметра provider.
  3. Для применения внесенных изменений выполните команду:
    sudo ldapadd -Y EXTERNAL -H ldapi:/// -f openldap-enable-syncrepl-multiprovider-server.ldif
  4. Перезапустите сервис slapd:
    sudo systemctl restart slapd
  5. Повторите все описанные действия на каждом из резервируемых серверов.
  6. Настройте Агент Alpha.Security:
    1. Перейдите к файлу конфигурации alpha.security.agent.xml, расположенному в /opt/Automiq/Alpha.Security. Добавьте в секцию элемента <LdapHosts /> строки с IP-адресами и портами всех резервируемых серверов:
      <LdapHosts>
      	<LDAPServer Address="127.0.0.1" Port="389"/>
      	<LDAPServer Address="172.16.13.167" Port="389"/>
      </LdapHosts>

      В данном примере:

      • 127.0.0.1 – адрес локального сервера (поставщика);
      • 172.16.13.167 – пример адреса сервера-приемника (укажите нужный адрес).
    2. Перезапустите сервис агента безопасности:
      sudo systemctl restart alpha.security.service

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