Версия: 6.0

Ubuntu

к сведению

Инструкция по установке Пассворка на ОС:

Ubuntu 20.04
Ubuntu 22.04

1. Минимальные системные требования

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

Ознакомьтесь с полными системными требованиями.

к сведению

Если сервер имеет 2-4 ГБ ОЗУ, то для корректной сборки всех библиотек мы рекомендуем включить SWAP-файл

Создание SWAP файла на Linux

осторожно

В инструкции используются переключаемые блоки кода для разделения команд согласно версиям операционной системы

2. Базовые действия перед установкой

Получить права root и обновить локальную базу данных пакетов:

bash

sudo -i 
apt-get update

Установить пакет для контроля версий Git, веб-сервер Apache2 и утилиту передачи данных curl:

bash

apt-get install -y git apache2 unzip curl

3. Установка PHP

Установить пакет software-properties-common и добавить репозиторий ppa:ondrej/php:

apt-get install -y software-properties-common
add-apt-repository -y ppa:ondrej/php

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

apt-get update

Установить PHP и модули расширений:

apt-get install -y php8.2 php8.2-dev php8.2-ldap php8.2-xml php8.2-bcmath php8.2-mbstring php8.2-xml php8.2-curl php8.2-opcache php8.2-readline php8.2-zip php-pear

3.1 Установка драйвера PHP MongoDB

Установить драйвер PHP MongoDB:

pecl install mongodb-1.21.0

Создать файлы конфигурации для загрузки и включения PHP MongoDB:

echo "extension=mongodb.so" | tee /etc/php/8.2/apache2/conf.d/20-mongodb.ini
echo "extension=mongodb.so" | tee /etc/php/8.2/cli/conf.d/20-mongodb.ini

3.2 Установка расширения PHP Phalcon

Установить расширение PHP Phalcon:

mkdir /tmp/install && cd /tmp/install && curl -LOf https://github.com/phalcon/cphalcon/releases/download/v5.3.1/phalcon-php8.2-nts-ubuntu-gcc-x64.zip && unzip phalcon-php8.2-nts-ubuntu-gcc-x64.zip && cp phalcon.so /usr/lib/php/20220829 && cd / && rm -rf /tmp/install

Создать файлы конфигурации для загрузки и включения PHP Phalcon:

echo "extension=phalcon.so" | tee /etc/php/8.2/apache2/conf.d/30-phalcon.ini
echo "extension=phalcon.so" | tee /etc/php/8.2/cli/conf.d/30-phalcon.ini

4. Установка базы данных MongoDB

Загрузить и преобразовать GPG-ключ MongoDB в файл:

Bash

curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
   --dearmor

Добавить строку репозитория в файл /etc/apt/sources.list.d/mongodb-org-6.0.list:

Ubuntu 22.04
Ubuntu 20.04

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

Обновить список доступных пакетов:

apt-get update

Установить MongoDB c помощью менеджера пакетов apt:

apt-get install -y mongodb-org

Запустить службу mongod.service:

shell

systemctl start mongod.service

Включить автозапуск службы:

shell

systemctl enable mongod.service

5. Управление и скачивание последней версии Пассворк с помощью Git

Перейти в директорию /var/www/:

bash

cd /var/www/

Добавить глобальную конфигурацию Git, указывающую на безопасную директорию:

bash

git config --global --add safe.directory /var/www

Инициализировать Git репозиторий в директории /var/www/:

bash

git init

Добавить удалённый репозиторий Пассворк:

bash

git remote add origin https://passwork.download/passwork/passwork.git

Получить удалённый репозиторий на локальный сервер:

bash

git fetch

к сведению

Система запросит логин и пароль к репозиторию, которые расположены на клиентском портале Пассворк. Если у вас нет доступа к клиентскому порталу — свяжитесь с нами.

Переключиться на ветку v6 с последней актуальной версией Пассворк:

bash

git checkout v6

Назначить права на директории и файлы и сделать www-data владельцем всех файлов:

bash

find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/

6. Настройка Apache2 для доступа по HTTP протоколу в Пассворк

Открыть файл конфигурации виртуального хоста для HTTP-соединения:

bash

nano /etc/apache2/sites-enabled/000-default.conf

Отредактировать содержимое данного файла и привести к следующему виду:

bash

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/public
    <Directory /var/www/public>
        Options +FollowSymLinks -Indexes -MultiViews
        AllowOverride All 
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Включить модуль перезаписи URL-адресов и перезапустить службу Apache2:

bash

a2enmod rewrite
service apache2 restart

к сведению

Открыть http://passwork.local или http://127.0.0.1 для проверки подключения к Пассворк.

7. Прохождение чек-листа параметров

При первом подключении к Пассворк, необходимо пройти чек-лист параметров, в ходе которого будет выполнена:

Проверка необходимых параметров
Подключение к базе данных MongoDB
Случайно сгенерированный ключ для шифрования данных в MongoDB
Проверка лицензионного ключа

к сведению

Оставьте все поля в значениях по умолчанию, если вы устанавливаете новую копию Пассворк.

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

осторожно

Первый пользователь по умолчанию является локальным и владельцем Пассворка. В случае назначения владельцем LDAP/SSO пользователя, он автоматически станет локальным и вы не сможете авторизоваться.

8. Настройка доступа по HTTPS-протоколу

8.1 Генерация самоподписанного SSL-сертификата

Создать новую директорию для хранения закрытого ключа и сертификата:

bash

mkdir /etc/apache2/ssl/

Сгенерировать самоподписанный сертификат X.509 для Apache2 с помощью OpenSSL:

bash

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj '/CN=your.domain.name' -addext 'subjectAltName=DNS:your.domain.name,IP:192.168.0.100' -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt

Common Name (CN) — указать IP-адрес сервера или имя хоста так, чтобы они совпадали с тем, как пользователи открывают сайт (по доменному имени или по IP);
subjectAltName (SAN) — передать -addext 'subjectAltName=DNS:your.domain.name,IP:192.168.0.100', подставив вместо your.domain.name и 192.168.0.100 текущее DNS-имя и IP-адрес сервера;

к сведению

Браузеры и SAN — браузеры при проверке HTTPS в первую очередь используют расширение Subject Alternative Name (SAN), а не только поле CN (Common Name). Чтобы избежать несоответствия имени хоста, задать в SAN и DNS, и IP в соответствии с адресом, который вводят пользователи.

Установить права доступа root пользователю для защиты закрытого ключа и сертификата:

bash

chmod 600 /etc/apache2/ssl/*

8.2 Настройка виртуального хоста для доступа по HTTPS-протоколу

Активировать модуль SSL в Apache2, позволяя серверу поддерживать протокол HTTPS:

bash

a2enmod ssl

Включить конфигурационный файл виртуального хоста сайта с настройками для SSL-соединения:

bash

a2ensite default-ssl

Открыть файл конфигурации виртуального хоста для HTTPS-соединения:

bash

nano /etc/apache2/sites-enabled/default-ssl.conf

Найти раздел, начинающийся с <VirtualHost _default_:443> и внести следующие изменения:

Добавить директиву ServerName (имя сервера или IP-адрес) и порт :443 под строкой ServerAdmin:

bash

ServerAdmin webmaster@localhost
ServerName passwork.local:443

Добавить директиву <Directory> после ServerName:

bash

    <Directory /var/www/public>
        Options +FollowSymLinks -Indexes -MultiViews
        AllowOverride All 
        Require all granted
    </Directory>

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

bash

SSLCertificateFile /etc/apache2/ssl/apache.crt
SSLCertificateKeyFile /etc/apache2/ssl/apache.key

После внесения изменений проверить, что файл конфигурации виртуального хоста соответствует примеру:

bash

<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
        ServerAdmin webmaster@localhost
        ServerName passwork.local:443
        DocumentRoot /var/www/public
        <Directory /var/www/public>
            Options +FollowSymLinks -Indexes -MultiViews
            AllowOverride All
            Require all granted
        </Directory>
        SSLEngine on
        SSLCertificateFile /etc/apache2/ssl/apache.crt
        SSLCertificateKeyFile /etc/apache2/ssl/apache.key
    </VirtualHost>
</IfModule>

Перезапустить службу Apache2 чтобы применить внесённые изменения в конфигурацию:

bash

systemctl restart apache2

к сведению

Проверьте подключение к Пассворк по протоколу HTTPS — https://passwork.local

8.3 Настройка Пассворка для работы по HTTPS-протоколу

При использовании защищенного SSL-соединения (HTTPS) клиентские браузеры требуют определенных флагов для обработки данных Пассворка.

Если флаги session.cookie_secure и disableSameSiteCookie не установлены, браузеры не смогут установить соединение, что может приведет к ошибкам авторизации.

Установить параметр session.cookie_secure в файле /etc/php/8.2/apache2/php.ini:

bash

sed -i '/session.cookie_secure =/c session.cookie_secure = On' /etc/php/8.2/apache2/php.ini

Установить параметр disableSameSiteCookie в /var/www/app/config/config.ini на значение Off:

bash

sed -i '/disableSameSiteCookie =/c disableSameSiteCookie = Off' /var/www/app/config/config.ini

к сведению

Не устанавливайте эти параметры или верните их в исходное значение, если вы передумаете использовать SSL и будете работать через HTTP-протокол

9. Настройка фоновых задач

Фоновые задачи — это задачи, которые выполняются по планировщику в фоновом режиме. Как настроить фоновые задачи.

осторожно

Фоновые задачи обязательны для корректной работы части функционала Пассворка, например:

Работы LDAP;
Отправки почтовых уведомлений;
Загрузки фавиконов;
Очистки коллекции session в базе данных Пассворка.

10. Настройка безопасности

осторожно

Перед изменением и настройке параметров безопасности, настоятельно рекомендуем убедиться в стабильной и корректной работе Пассворка, а также создать резервную копию файлов

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

Ознакомиться с рекомендуемыми параметрами безопасности Пассворка.

Версия для LLM

1. Минимальные системные требования​

2. Базовые действия перед установкой​

3. Установка PHP​

3.1 Установка драйвера PHP MongoDB​

3.2 Установка расширения PHP Phalcon​

4. Установка базы данных MongoDB​

5. Управление и скачивание последней версии Пассворк с помощью Git​

6. Настройка Apache2 для доступа по HTTP протоколу в Пассворк​

7. Прохождение чек-листа параметров​

8. Настройка доступа по HTTPS-протоколу​

8.1 Генерация самоподписанного SSL-сертификата​

8.2 Настройка виртуального хоста для доступа по HTTPS-протоколу​

8.3 Настройка Пассворка для работы по HTTPS-протоколу​

9. Настройка фоновых задач​

10. Настройка безопасности​

1. Минимальные системные требования

2. Базовые действия перед установкой

3. Установка PHP

3.1 Установка драйвера PHP MongoDB

3.2 Установка расширения PHP Phalcon

4. Установка базы данных MongoDB

5. Управление и скачивание последней версии Пассворк с помощью Git

6. Настройка Apache2 для доступа по HTTP протоколу в Пассворк

7. Прохождение чек-листа параметров

8. Настройка доступа по HTTPS-протоколу

8.1 Генерация самоподписанного SSL-сертификата

8.2 Настройка виртуального хоста для доступа по HTTPS-протоколу

8.3 Настройка Пассворка для работы по HTTPS-протоколу

9. Настройка фоновых задач

10. Настройка безопасности