Alpha.Community

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

Установка и настройка СУБД

Установка

Linux

Резервная копия базы данных находится в файле /opt/Automiq/Alpha.Reports/SQL/dump.sql.

В консоли введите:

sudo su - postgres
psql -c "alter user postgres with password 'postgres'"
psql -d ar_base -f /opt/Automiq/Alpha.Reports/SQL/dump.sql
exit

В данном примере резервная копия устанавливается под пользователем postgres в БД ar_base. Если Alpha.Reports устанавливается впервые, нужно создать базу данных ar_base с помощью команды:

createdb -T template0 ar_base

Результатом успешной установки будет отсутствие сообщений об ошибках в консоли и наличие схем public и quartz.

При обновлении программы до новой версии, устанавливаются патчи. Они расположены в папке /opt/Automiq/Alpha.Reports/SQL/Patches. Если нужно установить несколько патчей, то устанавливать их следует в порядке возрастания номера в их именах.

При обновлении программы до новой версии, устанавливаются патчи. Они расположены в папке /opt/Automiq/Alpha.Reports/SQL/Patches. Для корректной работы системы нужно последовательно установить все патчи, в названии которых фигурирует версия больше старой установленной. Например, при установке версии 1.1.4.xxx поверх версии 1.1.2.xxx, нужно установить patch.1.1.3.sql и patch.1.1.4.sql.

Пример установки патча:

psql -d ar_base -f /opt/Automiq/Alpha.Reports/SQL/Patches/patch.1.1.4.sql

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

dropdb -U postgres ar_base

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

Windows

Чтобы развернуть базу данных:

  1. Войдите в pgAdmin.
  2. Создайте базу данных:

    1. Выберите узел Servers → PostgreSQL 10.
    2. В контекстном меню выберите Create → Database.

    3. В появившемся окне в поле Database введите имя базы данных и нажмите кнопку Save.

Альтернативно, восстановите БД из резервной копии. Для этого выполните команду:

C:\Program Files\PostgreSQL\13\bin>psql -d ar_base -U postgres -f "C:\Program Files\Automiq\Alpha.Reports\SQL\dump.sql"

Путь к файлу будет зависеть от папки установки и версии PostgreSQL.

Для восстановления резервной копии в созданную базу данных и применения патчей через интерфейс pgAdmin, следуйте инструкциям, приведённым на рисунке ниже.

  1. Откроется окно редактора скриптов.

  2. Выберите файл для загрузки.

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

Настройка

Дополнительную информацию вы можете найти в документации PostgreSQL по ссылке : https://postgrespro.ru/docs/postgrespro/10/auth-pg-hba-conf.

Настройка аутентификации клиентов

Аутентификация клиентов управляется конфигурационным файлом pg_hba.conf, который расположен в каталоге с данными кластера базы данных. Файл pg_hba.conf со стандартным содержимым, создаётся командой initdb при инициализации каталога с данными.

Обычный формат файла pg_hba.conf представляет собой набор записей, по одной в строке. Пустые строки игнорируются, как и любой текст комментария после знака #. Записи не продолжаются на следующей строке. Записи состоят из некоторого количества полей, разделённых между собой пробелами и/или отступами (TAB). В полях могут быть использованы пробелы, если они взяты в кавычки. Если в кавычки берётся какое-либо зарезервированное слово в поле базы данных, пользователя или адресации (например, all или replication), то слово теряет своё особое значение и просто обозначает базу данных, пользователя или сервер с данным именем.

Каждая запись обозначает тип соединения, диапазон IP-адресов клиента (если он соотносится с типом соединения), имя базы данных, имя пользователя, и способ аутентификации, который будет использован для соединения в соответствии с этими параметрами. Первая запись с соответствующим типом соединения, адресом клиента, указанной базой данных и именем пользователя применяется для аутентификации. Процедур «fall-through» или «backup» не предусмотрено: если выбрана запись и аутентификация не прошла, последующие записи не рассматриваются. Если же ни одна из записей не подошла, в доступе будет отказано.

Запись может быть сделана в одном из семи форматов:

local      база  пользователь  метод-аутентификации  [параметры]
host       база  пользователь  адрес  метод-аутентификации  [параметры]
hostssl    база  пользователь  адрес  метод-аутентификации  [параметры]
hostnossl  база  пользователь  адрес  метод-аутентификации  [параметры]
host       база  пользователь  IP-адрес  IP-маска  метод-аутентификации  [параметры]
hostssl    база  пользователь  IP-адрес  IP-маска  метод-аутентификации  [параметры]
hostnossl  база  пользователь  IP-адрес  IP-маска  метод-аутентификации  [параметры]
Описания полей
Поле Описание
local

Управляет подключениями через Unix-сокеты. Без подобной записи подключение через Unix-сокеты невозможно.

host

Управляет подключениями, устанавливаемыми по TCP/IP. Записи host соответствуют подключениям с SSL и без SSL.

Удалённое соединение по TCP/IP невозможно, если сервер запущен без определения соответствующих значений для параметра конфигурации listen_addresses.

hostssl

Управляет подключениями, устанавливаемыми по TCP/IP с применением шифрования SSL.

Чтобы использовать эту возможность:

  • сервер должен быть собран с поддержкой SSL.
  • механизм SSL должен быть включён параметром конфигурации ssl.
hostnossl

Этот тип записей противоположен hostssl, ему соответствуют только подключения по TCP/IP без шифрования SSL.

база

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

  • all – подходят все базы данных.
  • sameuser – данная запись соответствует только, если имя запрашиваемой базы данных совпадает с именем запрашиваемого пользователя.
  • samerole (или устар. samegroup) – запрашиваемый пользователь должен быть членом роли с таким же именем, как и у запрашиваемой базы данных. Суперпользователи не становятся членами роли автоматически, а только если они являются явными членами роли.
  • replication – запись соответствует, если запрашивается подключение для физической репликации. Для таких подключений не выбирается какая-то конкретная база данных.
  • Любое другое значение воспринимается как имя определённой базы данных. Несколько имён баз данных можно указать, разделяя их запятыми. Файл, содержащий имена баз данных, можно указать, поставив знак @ в начале его имени.
пользователь

Указывает, какому имени (или именам) пользователя базы данных соответствует запись. Возможные значения:

  • all – запись соответствует всем пользователям.
  • Любое другое значение задаёт либо имя конкретного пользователя базы данных, либо имя группы (если это значение начинается с +). Несколько имён пользователей можно указать, разделяя их запятыми. Файл, содержащий имена пользователей, можно указать, поставив знак @ в начале его имени.
адрес

Указывает адрес (или адреса) клиентского компьютера, которому соответствует запись. Поле может содержать или имя компьютера, или диапазон IP-адресов, или одно из ключевых слов:

  • all – любой IP-адрес.
  • samehost – любые IP-адреса данного сервера.
  • samenet – любой адрес любой подсети, к которой сервер подключён напрямую/

IP-адрес

IP-маска

Эти два поля могут быть использованы как альтернатива записи IP-адрес/длина-маски. Вместо того, чтобы указывать длину маски, в отдельном столбце указывается сама маска. Например, 255.0.0.0 представляет собой маску CIDR для IPv4 длиной 8 бит, а 255.255.255.255 представляет маску CIDR длиной 32 бита.

Эти поля применимы только к записям host, hostssl и hostnossl.

метод-аутентификации

Указывает метод аутентификации, когда подключение соответствует записи. Все значения воспринимаются с учётом регистра и должны быть записаны в нижнем регистре. Возможные значения:

  • trust – разрешает безусловное подключение. Этот метод позволяет тому, кто может подключиться к серверу с базой данных Postgres Pro, войти под любым желаемым пользователем Postgres Pro без введения пароля и без какой-либо другой аутентификации.
  • reject – отклоняет подключение безусловно. Эта возможность полезна для «фильтрации» некоторых серверов группы, например, строка с reject может отклонить попытку подключения одного компьютера, при этом следующая строка позволяет подключиться остальным компьютерам в той же сети.
  • scram-sha-256 – проверяет пароль пользователя, производя аутентификацию SCRAM-SHA-256.
  • md5 – проверяет пароль пользователя, производя аутентификацию SCRAM-SHA-256 или MD5.
  • password – требует для аутентификации введения клиентом незашифрованного пароля. Поскольку пароль посылается простым текстом через сеть, такой способ не стоит использовать, если сеть не вызывает доверия.
  • gss – для аутентификации пользователя использует GSSAPI. Этот способ доступен только для подключений по TCP/IP.
  • sspi – для аутентификации пользователя использует SSPI. Способ доступен только для Windows.
  • ident – получает имя пользователя операционной системы клиента, связываясь с сервером Ident, и проверяет, соответствует ли оно имени пользователя базы данных. Аутентификация ident может использоваться только для подключений по TCP/IP. Для локальных подключений применяется аутентификация peer.
  • peer – получает имя пользователя операционной системы клиента из операционной системы и проверяет, соответствует ли оно имени пользователя запрашиваемой базы данных. Доступно только для локальных подключений.
  • ldap – проводит аутентификацию, используя сервер LDAP.
  • radius – проводит аутентификацию, используя сервер RADIUS.
  • cert – проводит аутентификацию, используя клиентский сертификат SSL.
  • pam – проводит аутентификацию, используя службу подключаемых модулей аутентификации (PAM), предоставляемую операционной системой.
  • bsd – проводит аутентификацию, используя службу аутентификации BSD, предоставляемую операционной системой.
параметры Поле (поля) вида имя=значение, определяющее параметры метода аутентификации. Подробнее о параметрах, доступных для различных методов аутентификации, рассказывается ниже. Помимо описанных далее параметров, относящихся к различным методам, есть один общий параметр аутентификации clientcert, который можно задать в любой записи hostssl. Если он равен 1, клиент должен представить подходящий (доверенный) сертификат SSL, в дополнение к другим требованиям метода проверки подлинности.

Файлы, включённые в конструкции, начинающиеся с @, читаются, как список имён, разделённых запятыми или пробелами. Комментарии предваряются знаком #, как и в файле pg_hba.conf, и вложенные @ конструкции допустимы. Если только имя файла, начинающегося с @ не является абсолютным путём.

Поскольку записи файла pg_hba.conf рассматриваются последовательно для каждого подключения, порядок записей имеет большое значение. Обычно более ранние записи определяют чёткие критерии для соответствия параметров подключения, но для методов аутентификации допускают послабления. Напротив, записи более поздние смягчают требования к соответствию параметров подключения, но усиливают их в отношении методов аутентификации. Например, некто желает использовать trust аутентификацию для локального подключения по TCP/IP, но при этом запрашивать пароль для удалённых подключений по TCP/IP. В этом случае запись, устанавливающая аутентификацию trust для подключения адреса 127.0.0.1, должна предшествовать записи, определяющей аутентификацию по паролю для более широкого диапазона клиентских IP-адресов.

Файл pg_hba.conf прочитывается при запуске системы, а также в тот момент, когда основной сервер (процесс postmaster) получает сигнал SIGHUP. Послать сигнал процессу можно любым из способов:

  • используя pg_ctl reload
  • вызвав SQL-функцию pg_reload_conf()
  • выполнив kill -HUP

Предыдущее утверждение не касается Microsoft Windows: там любые изменения в pg_hba.conf сразу применяются к последующим подключениям.

Чтобы подключиться к конкретной базе данных, пользователь не только должен пройти все проверки файла pg_hba.conf, но должен иметь привилегию CONNECT для подключения к базе данных. Если вы хотите ограничить доступ к базам данных для определённых пользователей, проще предоставить/отозвать привилегию CONNECT, нежели устанавливать правила в записях файла pg_hba.conf.

Примеры

Позволяет любому пользователю локальной системы подключаться к любой базе данных, используя любое имя пользователя баз данных, через Unix-сокеты (по умолчанию для локальных подключений).

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all             all                                     trust

То же, но для локальных замкнутых подключений по TCP/IP.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             127.0.0.1/32            trust

То же, что и в предыдущем примере, но с указанием сетевой маски в отдельном столбце

# TYPE  DATABASE        USER            IP-ADDRESS      IP-MASK             METHOD
host    all             all             127.0.0.1       255.255.255.255     trust

То же для IPv6.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             ::1/128                 trust

То же самое, но с использованием имени компьютера (обычно покрывает и IPv4, и IPv6).

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             localhost               trust

Позволяет любому пользователю любого компьютера с IP-адресом 192.168.93.x подключаться к базе данных "postgres" с именем, которое сообщает для данного подключения ident (как правило, имя пользователя операционной системы).

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    postgres        all             192.168.93.0/24         ident

Позволяет любому пользователю компьютера 192.168.12.10 подключаться к базе данных "postgres", если он передаёт правильный пароль.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    postgres        all             192.168.12.10/32        scram-sha-256

Позволяет любым пользователям с компьютеров в домене example.com подключаться к любой базе данных, если передаётся правильный пароль.

Для всех пользователей требуется аутентификация SCRAM, за исключением пользователя 'mike', который использует старый клиент, не поддерживающий аутентификацию SCRAM.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             mike            .example.com            md5
host    all             all             .example.com            scram-sha-256

В случае отсутствия предшествующих строчек с "host", следующие две строки откажут в подключении с 192.168.54.1 (поскольку данная запись будет выбрана первой), но разрешат подключения GSSAPI с любых других адресов. С нулевой маской ни один бит из IP-адреса компьютера не учитывается, так что этой строке соответствует любой компьютер.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             192.168.54.1/32         reject
host    all             all             0.0.0.0/0               gss

Позволяет пользователям с любого компьютера 192.168.x.x подключаться к любой базе данных, если они проходят проверку ident. Если же ident говорит, например, что это пользователь "bryanh" и он запрашивает подключение как пользователь Postgres Pro "guest1", подключение будет разрешено, если в файле pg_ident.conf есть сопоставление "omicron", позволяющее пользователю "bryanh" подключаться как "guest1".

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             192.168.0.0/16          ident map=omicron

Если для локальных подключений предусмотрены только эти три строки, они позволят локальным пользователям подключаться только к своим базам данных (базам данных с именами, совпадающими с именами пользователей баз данных), кроме администраторов или членов роли "support", которые могут подключиться к любой БД. Список имён администраторов содержится в файле $PGDATA/admins. Пароли запрашиваются в любом случае.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   sameuser        all                                     md5
local   all             @admins                                 md5
local   all             +support                                md5

Последние две строчки в примере выше могут быть объединены в одну:

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all             @admins,+support                        md5

В столбце DATABASE могут указываться списки и имена файлов:

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   db1,db2,@demodbs  all                                   md5