Alpha.Community

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

Решение распространенных проблем

В разделе представлены инструкции по устранению проблем, возникающих при настройке компонентов Alpha.Security, при редактировании конфигурации на LDAP-сервере с помощью SecurityConfigurator, и в процессе работы подсистемы безопасности в целом. Раздел находится в разработке и будет дополняться. Подзаголовки раздела совпадают с текстами ошибок:

  • в журнале приложений Windows;
  • в приложении EventLogViewer;
  • в диалоговых окнах приложения SecurityConfigurator.

Ошибки в системных журналах или в EventLogViewer

Служба 'SECURITYAGENT' не зарегистрирована

Эта ошибка возникает в тех случаях, когда Агент Alpha.Security не может запуститься. При этом служба Alpha.Security.Agent (alpha.security.service) может находиться в статусе "выполняется". В таких случаях в первую очередь стоит проверить, что конфигурационный файл alpha.security.agent.xml составлен правильно. Пример конфигурационного файла находится в Приложение A: Пример конфигурационного файла Агент Alpha.Security.

Ошибка при подключении к LDAP-серверу 'x.x.x.x:x'. Операция не удалась. Код ошибки: 34

В конфигурационном файле alpha.security.agent.xml каталог администратора LDAP указан в неправильном формате. Используйте формат указания каталогов, принятый для OpenLDAP: cn="логин-администратора",dc="домен-базы-данных".

Неправильно: <LdapUser value="Manager"/>

Правильно: <LdapUser value="cn=Manager,dc=maxcrc,dc=com"/>

Ошибка при подключении к LDAP-серверу 'x.x.x.x:x'. Неверное имя пользователя или пароль

В конфигурационном файле alpha.security.agent.xml указан неверный каталог администратора LDAP.

Каталог администратора LDAP зачастую создается на этапе установки OpenLDAP. Не меняйте значение, указанное в конфигурационном файле:

  • для ОС Windows – <LdapUser value="cn=Manager,dc=maxcrc,dc=com"/>;
  • для ОС Linux – <LdapUser value="cn=admin,dc=maxcrc,dc=com"/>.

Неправильный пароль для подключения к LDAP / Ошибка с кодом 53

Если пароль указан верно, а ошибка все равно возникает – убедитесь, что пароль указан в зашифрованном виде, например:

<LdapPassword value="U7y9IEVgu3Bg++VKHxkRv4baTM6CKpuosNlqFNVJs2GVYIBKHCyx
/9omgL3DJigUPjFmX10FoNRYPeg3ycHSYLBDlOn7XXJewvulXD837Y8aQbOBfxU35AowqUR+8
yjFYFqFPxn7/fpIheuz6iuot9cJvqtrOyiMgHkFuOiRIOE"/>

Чтобы зашифровать пароль, используйте приложение alpha.security.crypter.exe, расположенное в C:\Program Files\Automiq\Alpha.Security\Utils. Подробнее – в разделе Агент безопасности и его настройка, в пункте Указать администратора LDAP.

Сообщения вида "<= mdb_equality_candidates: (xxx) not indexed"

Сообщения появляются в системном журнале Linux, когда OpenLDAP не индексирует указанный атрибут (xxx) для более быстрого поиска. Чтобы устранить эту проблему, необходимо присвоить индекс следующим образом:

  1. В любом месте создайте файл filename.ldif со следующим содержимым:
    dn: olcDatabase={1}mdb,cn=config
    changetype: modify
    add: olcDbIndex
    olcDbIndex: xxx eq

    где вместо xxx следует указать атрибут из текста сообщения. Если сообщения возникают для разных атрибутов, каждый из них можно перечислить в отдельной строке вида olcDbIndex: xxx eq. Пример:

    dn: olcDatabase={1}mdb,cn=config
    changetype: modify
    add: olcDbIndex
    olcDbIndex: AQRef eq
    olcDbIndex: AQMemberID eq
    olcDbIndex: AQMemberRole eq
  2. Примените созданный файл с помощью команды:
    sudo ldapadd -Y EXTERNAL -H ldapi:/// -f filename.ldif

Не удалось отправить сообщение потребителю (сработало исключение ...)

Сообщение появляется в результате каждой неуспешной попытки агента безопасности записать сообщение аудита в сигнал Alpha.Server. Перепроверьте настройки аудита, описанные в разделе Аудит безопасности. Убедитесь в том, что в файле alpha.security.agent.xml:

  • в карте сигналов <SignalMap /> перечислены сигналы, существующие в текущей конфигурации Alpha.Server;
  • в атрибутах элемента <Server /> описан модуль-потребитель сообщений, подключенный к Alpha.Server.

Функцию аудита безопасности можно вовсе отключить, как – описано в разделе Аудит безопасности.

AP протокол: Не удалось получить ни одного активного подключенного соединения с сервером

Ошибка возникает в результате некорректной настройки аудита безопасности, когда неверно указан IP-адрес или порт Alpha.Server в файле alpha.security.agent.xml. Убедитесь, что IP-адрес, порт и тип сервера-потребителя сообщений указаны верно.

Функцию аудита безопасности можно вовсе отключить, как – описано в разделе Аудит безопасности.

Не удалось отправить уведомление об изменении конфигурации подписчику

Ошибка возникает в результате некорректной настройки аудита безопасности, когда неверно сформирована карта сигналов <SignalMap />.

Функцию аудита безопасности можно вовсе отключить, как – описано в разделе Аудит безопасности.

Ошибки в диалоговых окнах приложения SecurityConfigurator

Не удалось сохранить изменения на сервере: no write access to parent. У пользователя недостаточно прав

Встречается при подключении из SecurityConfigurator, установленного на Windows, к OpenLDAP, установленному на Linux. Ошибка возникает, если не были прописаны политики контроля доступа при настройке OpenLDAP. Вернитесь к настройке LDAP-сервера: шаблон политик контроля доступа и примените его.

objectClass: value #2 invalid per syntax. Неверный синтаксис

Ошибка возникает, если не была применена структура (схема) каталогов на LDAP-сервере при настройке OpenLDAP (либо была применена некорректная схема). Вернитесь на шаг .

Если это не помогло, проверьте, что:

  • в папке C:\Program Files\OpenLDAP\schema есть файл security.schema (если его нет, файл можно скачать здесь);
  • в файле конфигурации C:\ProgramData\OpenLDAP\openldap\slapd.conf есть строчка:
    include        ./schema/security.schema

Представленные учетные данные неверны

В этом случае следует проверить каталог администратора, указанный в мастере создания новой конфигурации Alpha.Security, запускаемом при подключении напрямую к LDAP-серверу из SecurityConfigurator.

Если не меняли значение по умолчанию, то в строке Администратор LDAP должно быть указано:

  • cn=Manager,dc=maxcrc,dc=com – если OpenLDAP установлен на Windows;
  • cn=admin, dc=maxcrc,dc=com – если OpenLDAP установлен на Linux.

Объект не существует

Такая ошибка возникает, если была изменена или некорректно удалена база OpenLDAP. Проверьте, что в папке C:\Program Files\OpenLDAP\data находятся файлы data.mdb и lock.mdb – это и есть база. Если файлы находятся в папке, а ошибка все равно возникает, то необходимо удалить и повторно установить OpenLDAP. Обратите внимание, что это приведет к потере созданных ранее конфигураций! Поэтому попробуйте сначала найти и восстановить файлы data.mdb и lock.mdb, например, в корзине – возможно, они были удалены или перемещены по ошибке.

После удаления OpenLDAP папка C:\Program Files\OpenLDAP остается. Если база была "сломана", то эту папку нужно удалить, иначе после повторной установки OpenLDAP будет соединяться со старой, "сломанной" базой.

Другие проблемы

В ОС Windows служба OpenLDAP не запускается

Следует проверить наличие конфигурационного файла slapd.conf в папке C:\ProgramData\OpenLDAP\openldap. Если файл отсутствует, то нужно скопировать туда его резервную копию из C:\Program Files\OpenLDAP.

В ОС Linux не происходит автоматический выход пользователя из системы, если длительность сессии или время бездействия истекло

Следует проверить, запущен ли сервис alpha.security.useractivity.service. Чтобы посмотреть список запущенных сервисов, используйте команду ps aux. Для удобства поиска отфильтруйте результаты с помощью команды grep:

ps aux | grep alpha.security

Если в списке нет нужного сервиса, необходимо выполнить запуск сервиса alpha.security.useractivity.service вручную.

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

В ОС Linux необходимо изменить настройки разнонаправленного резервирования OpenLDAP

Чтобы изменить настройки разнонаправленного резервирования в ОС Linux, нельзя просто заново создать и применить файл openldap-enable-syncrepl-multiprovider-server.ldif. Сначала придется удалить прежние настройки, а затем применить новые.

Чтобы удалить прежние настройки, выполните следующие действия:

  1. Выгрузите текущую конфигурацию с помощью команды:
    sudo slapcat -b cn=config -l ldap-config.ldif
  2. В любом текстовом редакторе измените полученный файл ldap-config.ldif. Например, можно использовать редактор nano:
    sudo nano ldap-config.ldif

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

    1. Удалите запись olcServerID:
      olcServerID: 1
      entryCSN: 20230417093406.763770Z#000000#000#000000
      modifiersName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      modifyTimestamp: 20230417093406Z
    2. Удалите блок, содержащий модуль syncprov.la:
      dn: cn=module{1},cn=config
      objectClass: olcModuleList
      cn: module{1}
      olcModulePath: /usr/lib/ldap
      olcModuleLoad: {0}syncprov.la
      structuralObjectClass: olcModuleList
      entryUUID: be4047c6-714e-103d-91db-cbf1dc15f9bc
      creatorsName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      createTimestamp: 20230417093406Z
      entryCSN: 20230417093406.762126Z#000000#000#000000
      modifiersName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      modifyTimestamp: 20230417093406Z
    3. Удалите блок, содержащий olcSyncrepl и olcMirrorMode:
      olcSyncrepl: {0}rid=001 provider=ldap://1.2.3.4:389 bindmethod=simple
      binddn="cn=admin,dc=maxcrc,dc=com" credentials="secret" searchbase="dc=max
      crc,dc=com" scope=sub schemachecking=on type=refreshAndPersist retry="30 5
      300 3" interval=00:00:05:00
      olcSyncrepl: {1}rid=002 provider=ldap://1.2.3.4:389 bindmethod=simple
      binddn="cn=admin,dc=maxcrc,dc=com" credentials="secret" searchbase="dc=max
      crc,dc=com" scope=sub schemachecking=on type=refreshAndPersist retry="30 5
      300 3" interval=00:00:05:00
      olcMirrorMode: TRUE
      entryCSN: 20230417093406.764528Z#000000#001#000000
      modifiersName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      modifyTimestamp: 20230417093406Z
    4. Удалите блоки, содержащие olcOverlay syncprov:
      dn: olcOverlay={0}syncprov,olcDatabase={1}mdb,cn=config
      objectClass: olcOverlayConfig
      objectClass: olcSyncProvConfig
      olcOverlay: {0}syncprov
      olcSpSessionlog: 100
      structuralObjectClass: olcSyncProvConfig
      entryUUID: be407890-714e-103d-91dc-cbf1dc15f9bc
      creatorsName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      createTimestamp: 20230417093406Z
      entryCSN: 20230417093406.763396Z#000000#000#000000
      modifiersName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      modifyTimestamp: 20230417093406Z
      dn: olcOverlay={1}syncprov,olcDatabase={1}mdb,cn=config
      objectClass: olcOverlayConfig
      objectClass: olcSyncProvConfig
      olcOverlay: {1}syncprov
      structuralObjectClass: olcSyncProvConfig
      entryUUID: be414d38-714e-103d-91dd-cbf1dc15f9bc
      creatorsName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      createTimestamp: 20230417093406Z
      entryCSN: 20230417093406.768839Z#000000#001#000000
      modifiersName: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      modifyTimestamp: 20230417093406Z
  3. Остановите сервис OpenLDAP, а затем убедитесь, что он остановлен:
    sudo service slapd stop
    sudo systemctl status slapd
  4. Очистите папку от прежней конфигурации:
    sudo rm -rf /etc/ldap/slapd.d/*
  5. Инициализируйте очищенный от прежних настроек файл ldap-config.ldif в slapd.d:
    sudo slapadd -b cn=config -l ldap-config.ldif -F /etc/ldap/slapd.d/
  6. Поправьте права доступа к папке slapd.d:
    sudo chown -R openldap:openldap /etc/ldap/slapd.d/
  7. Запустите сервис OpenLDAP, а затем убедитесь, что он запущен:
    sudo systemctl start slapd
    sudo systemctl status slapd

Прежние настройки разнонаправленного резервирования удалены. Теперь файл openldap-enable-syncrepl-multiprovider-server.ldif можно создать и применить заново, как описано в разделах, описывающих настройку разнонаправленного резервирования.

В ОС Linux не работает временная блокировка пользователя при превышении количества неудачных попыток входа

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

Для пользователей РЕД ОС иногда возникает следующая проблема: после превышения разрешённого количества неудачных попыток входа пользователь блокируется навсегда, а не на заданный в праве Таймаут при превышении количества попыток входа, мин (AttempsTimeOut) период времени. Для решения этой проблемы может понадобиться выполнение инструкции по настройке монитора LDAP. Инструкция приведена ниже в текущем подразделе.

Чтобы понять, нужно ли выполнять настройку монитора LDAP, перейдите в каталог /etc/openldap/slapd.d/cn=config. Откройте файл olcDatabase={x}monitor.ldif (на месте x может быть любая цифра, которую следует запомнить, а название файла может выглядеть как olcDatabase={x}Monitor.ldif). Найдите атрибут olcAccess в этом файле. Если его значение отличается от приведенного ниже, то необходимо будет выполнить настройку монитора LDAP.

olcAccess: {0} to dn.subtree="cn=monitor"
by dn.exact="cn=admin,dc=maxcrc,dc=com"
write by users write by * none

Чтобы настроить монитор LDAP, сделайте следующее:

  1. Создайте файл с расширением *.ldif (например, configure.ldif). Добавьте в него указанное содержимое:

    dn: olcDatabase={x}monitor,cn=config
    changetype: modify
    replace: olcAccess
    olcAccess: {0} to dn.subtree="cn=monitor"
    by dn.exact="cn=admin,dc=maxcrc,dc=com"
    write by users
    write by * none

    В первой строке на месте x должна быть указана цифра, которая указана в названии файла /etc/openldap/slapd.d/cn=config/olcDatabase={x}monitor.ldif.

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

    ldapmodify -Y EXTERNAL -H ldapi:/// -f configure.ldif
  3. Перезапустите сервис slapd командой:

    systemctl restart slapd
  4. Откройте файл /etc/openldap/slapd.d/cn=config/olcDatabase={x}monitor.ldif и убедитесь, что атрибут olcAccess принял правильное (указанное перед инструкцией) значение.
  5. В терминале выполните команду:

    ldapsearch -Y EXTERNAL -H ldapi:/// -b "cn=schema,cn=config" alpha

    В полученном ответе команды найдите запись:

    dn: cn={x}alpha,cn=schema,cn=config

    На месте x может быть любое число. Его необходимо запомнить.

  6. Перейдите к каталогу /opt/Automiq/Alpha.Security. Редактируйте расположенные здесь файлы addOlcAttrType.ldif и editOlcObjectClass.ldif, заменив x в строке dn: cn={x}alpha,cn=schema,cn=config на число, запомненное на предыдущем шаге.
  7. В терминале выполните команду:

    chmod +x ./addLockTime.sh

    Затем запустите скрипт addLockTime.sh с помощью команды:

    ./addLockTime.sh