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. Проверьте имя и тип базы данных (hdb, mdb, и т.п.) с помощью команды:
    sudo slapcat -n0

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

  3. Разрешите доступ через брандмауэр с помощью команды:

    sudo firewall-cmd --add-service=ldap
  4. Сгенерируйте шифрованное значение пароля для учетной записи администратора LDAP с помощью команды:

    slappasswd

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

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

Применение схем для создания УЗ администратора и политик контроля доступа

Перейдите к каталогу /opt/Automiq/Alpha.Security. Здесь для настройки OpenLDAP нужно применить LDIF-файлы, один из которых поставляется в составе дистрибутива, а еще два необходимо создать самостоятельно.

  1. Создайте и примените LDIF-файл config.ldif, который используется для задания пароля учетной записи администратора LDAP (olcRootPW).

    1. Создайте файл командой:
      sudo nano config.ldif
    2. Добавьте в файл следующее:

      dn: olcDatabase={0}config,cn=config
      changetype: modify
      add: olcRootPW
      olcRootPW: {SSHA}строка_символов
      • olcDatabase – указывает конкретное имя экземпляра базы данных и обычно находится в /etc/ldap/slapd.d/cn=config;
      • cn=config – указывает глобальные параметры конфигурации;
      • {SSHA}строка_символов – шифрованное значение пароля администратора, полученное ранее.
    3. Примените файл командой:
      sudo ldapadd -Y EXTERNAL -H ldapi:/// -f config.ldif

      В случае успешного завершения операции должно появиться следующее сообщение:

  2. Создайте и примените LDIF-файл db.ldif, который используется для добавления учетной записи администратора LDAP (olcRootDN).

    1. Создайте файл командой:

      sudo nano db.ldif
    2. Добавьте в файл следующее:

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

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

    3. Примените созданный файл командой:
      sudo ldapadd -Y EXTERNAL -H ldapi:/// -f db.ldif

      В случае успешного завершения операции должно появиться следующее сообщение:

  3. Примените LDIF-файл access.ldif, поставляемый в составе дистрибутива Alpha.Security для применения политик контроля доступа, командой:

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

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

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

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

    В случае успешного завершения операции должно появиться следующее сообщение:

Применение схем OpenLDAP

Теперь необходимо применить файлы-схемы, поставляемые вместе с OpenLDAP.

  1. Перейдите к папке, где хранятся файлы.
    cd /etc/openldap/schema/
  2. Затем примените файлы-схемы в том порядке, в котором они перечислены ниже. Обратите внимание, что в РЕД ОС версии 8.0 отсутствует файл /etc/openldap/schema/ppolicy.ldif, применять его не нужно.
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f collective.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f corba.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f cosine.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f duaconf.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f dyngroup.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f inetorgperson.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f java.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f misc.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f nis.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f openldap.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f pmi.ldif
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f ppolicy.ldif
  3. После выполнения каждой команды должно появляться сообщение об успешном применении схемы:

Применение схемы Alpha.Security

Далее необходимо применить схему, поставляемую вместе с дистрибутивом Alpha.Security.

  1. Вернитесь в каталог установки агента безопасности.
    cd /opt/Automiq/Alpha.Security
  2. Примените здесь файл-схему alpha.security.ldif.
    sudo ldapadd -Q -Y EXTERNAL -H ldapi:/// -f alpha.security.ldif

Применение схемы домена

Теперь необходимо создать и применить файл-схему, где будет указан так называемый домен, в котором функционирует агент безопасности.

  1. Перейдите к каталогу на уровень выше.
    cd /opt/Automiq
  2. Создайте файл-схему empty.ldif.
    sudo nano empty.ldif

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

    dn: dc=maxcrc,dc=com
    objectClass: domain
    objectClass: top
    dc: maxcrc
  3. Примените созданный файл командой:
    sudo ldapadd -x -D 'cn=admin,dc=maxcrc,dc=com' -w secret -H ldapi:/// -f empty.ldif

    где вместо admin следует указать логин администратора LDAP (admin – значение по умолчанию), а вместо secret – пароль администратора LDAP в незашифрованном виде.

Затем запустите сервис alpha.security.useractivity.service, как описано в разделе Запуск сервисов (для ОС Linux).

Укажите созданную выше учетную запись администратора LDAP в настройках агента безопасности. Как это сделать – описано в разделе Агент безопасности и его настройка, подраздел "Указать администратора LDAP".

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

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

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

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

    slappasswd

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

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

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

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

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

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

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

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

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

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

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

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

      где вместо {2}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={2}mdb,cn=config. Если база имеет тип, отличный от {2}mdb, то во всех файлах, создаваемых и применяемых в инструкции ниже, следует указывать правильный тип базы.

  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
  3. На время настройки резервирования остановите все резервируемые сервера OpenLDAP.

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

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

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

    1. Ознакомьтесь с файлом openldap-enable-syncrepl-consumer.ldif, устанавливаемым в составе Alpha.Security:
      dn: olcDatabase={2}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={2}mdb,cn=config
      changetype: modify
      #delete: olcUpdateRef
      add: olcUpdateRef
      olcUpdateRef: ldap://192.168.56.1

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

    2. Измените следующие строки:
      • dn: olcDatabase={2}mdb,cn=config – замените {2}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 на адрес сервера-поставщика данных.

      В файлах .ldif порядок и количество пробелов имеют важное значение.

    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={2}mdb,cn=config
      changetype: add
      objectClass: olcOverlayConfig
      objectClass: olcSyncProvConfig
      olcOverlay: syncprov
      olcSpNoPresent: TRUE
      olcSpCheckpoint: 100 10
      olcSpSessionlog: 100
      
      dn: olcDatabase={2}mdb,cn=config
      changetype: modify
      add: olcDbIndex
      olcDbIndex: entryCSN eq
      -
      add: olcDbIndex
      olcDbIndex: entryUUID eq
    2. Замените {2}mdb на текущий тип БД, если он отличается, в строках:
      • dn: olcOverlay=syncprov,olcDatabase={2}mdb,cn=config;
      • dn: olcDatabase={2}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={2}mdb,cn=config. Если база имеет тип, отличный от {2}mdb, во всех файлах, создаваемых и применяемых в инструкции ниже, следует указывать правильный тип базы.

  2. Отключите все возможные репликации баз и серверов.
  3. Убедитесь, что содержимое баз резервируемых серверов идентично.
  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. На любом из резервируемых серверов создайте файл конфигурации 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/lib64/openldap/
    olcModuleLoad: syncprov.la
    
    ##########################################################
    
    dn: olcOverlay=syncprov,olcDatabase={2}mdb,cn=config
    objectClass: olcOverlayConfig
    objectClass: olcSyncProvConfig
    olcOverlay: syncprov
    olcSpSessionLog: 100
    
    ##########################################################
    
    dn: cn=config
    changetype: modify
    replace: olcServerID
    olcServerID: 1
    
    dn: olcDatabase={2}mdb,cn=config
    changetype: modify
    add: olcSyncRepl
    olcSyncRepl:
      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
    olcSyncRepl:
      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
    -
    add: olcMirrorMode
    olcMirrorMode: TRUE
    
    dn: olcOverlay=syncprov,olcDatabase={2}mdb,cn=config
    changetype: add
    objectClass: olcOverlayConfig
    objectClass: olcSyncProvConfig
    olcOverlay: syncprov

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

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

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

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

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

    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. Подключитесь напрямую к каждой базе и убедитесь, что ошибок не возникло. Для проверки внесите изменения в конфигурацию на одном из серверов. Убедитесь, что эти изменения появились и на других серверах.