Автоматизированная библиотечно-информационная система "Руслан-Нео"


Модуль "Аудит"


Руководство системного программиста

ООО "Открытые библиотечные системы"

Рустам Усманов

Версия 1.3.0


Аннотация

В данном документе приведены общие сведения о модуле "Аудит" AБИС "Руслан-Нео". Описаны порядок настройки и проверки, дополнительные возможности.

Глава 1. Общие сведения о программе

Модуль "Аудит" АБИС "Руслан-Нео" предназначен для сбора и сохранения сведений о различных событиях, происходящих в АБИС "Руслан-Нео". Поддерживается обработка следующих типов событий:

  • События хранилища данных (репозитория контента JCR)

    • Создание узла (базы данных или записи)

    • Удаление узла (базы данных или записи)

    • Перемещение узла (базы данных или записи)

    • Создание свойства базы данных или записи

    • Изменение свойства базы данных или записи

    • Удаление свойства базы данных или записи

    • Добавление списка управления доступом (ACL)

    • Удаление списка управления доступом (ACL)

    • Выдача пользователю полномочий для работы с базами данных или записями

    • Отзыв у пользователя полномочий для работы с базами данных или записями

  • События web-интерфейса ресурсов

    • Создание сеанса

    • Изменение идентификатора сеанса

    • Завершение сеанса

    • Вызов метода

Хранение сведений о событиях осуществляется сервером Solr, используемым сервером "Руслан-Нео".

Модуль "Аудит" может функционировать на любых технических средствах под управлением сервера приложений WildFly версии 10.*.

Необходимыми условиями для работы модуля "Аудит" являются:

  • наличие в конфигурации сервера WildFly следующих очередей сообщений:

    • java:/jms/topic/ruslan/createUpdateRecord - очередь сообщений хранилища данных

    • java:/jms/topic/ruslan/wsOperations - очередь сообщений web-интерфейса ресурсов

  • наличие в конфигурации сервера WildFly следующих общих параметров базовых сервисов АБИС "Руслан-Нео":

    • java:global/ruslan/config/{сигла библиотеки}/solrURL

    • java:global/ruslan/config/{сигла библиотеки}/license

  • наличие лицензионного файла с указанием на лицензирование модуля "Аудит" в месте, заданном при помощи вышеуказанного параметра java:global/ruslan/config/{сигла библиотеки}/license

  • возможность взаимодействия с сервером Solr версии 6.3.0

  • наличие коллекции rneo-audit на сервере Solr

Глава 2. Структура программы

Модуль "Аудит" состоит из следующих компонентов:

  1. rneo-audit*.ear - модуль "Аудит".

Глава 3. Настройка программы

3.1. Установка программы

Установка программы заключается в развёртывании rneo-audit*.ear на сервере приложений WildFly.

3.2. Настройка программы

Настройка модуля "Аудит" осуществляется при помощи дескриптора развёртывания rneo-audit*.ear/rneo-audit-ejb.jar/META-INF/ejb-jar.xml. В этом дескрипторе значение записи окружения com.ols.ruslan.neo.indexing.solr.JcrEventIndexManager/trackFieldChangeExpression содержит XPath-выражение, используемое для отбора тех полей служебных записей, изменение значения которых требуется фиксировать при сохранении сведений о событии изменения служебной записи. Например, для отслеживания изменений в полях 105 и 106 можно использовать следующее значение записи окружения: /record[@syntax="1.2.840.10003.5.105"]/tag[@tagValue="105" or @tagValue="106"].

Глава 4. Проверка программы

Проверка развёртывания модуля "Аудит" осуществляется при помощи средств управления WildFly. При неуспешном развёртывании указание на причины следует искать в журнале WildFly.

Глава 5. Дополнительные возможности

Модуль "Аудит" не обладает иными возможностями, помимо указанных в Главе 1.

Глава 6. Сообщения системному программисту

Сообщения системному программисту выводятся в журнал WildFly.

Перечень сокращений

ACL

Access Control List

JCR

Java Content Repository

АБИС

Автоматизированная библиотечно-информационная система