Debian 11

37min
Установка менеджера паролей в Debian 11
1. Минимальные системные требования
Пассворк не требователен к ресурсам сервера(-ов). Объемы необходимых ресурсов (RAM, CPU, HDD) и количество серверов зависят от количества активных пользователей, объема хранимых данных, а также требований к отказоустойчивости системы.
💡 Технические требования﻿ 
💡 Если на сервере 2-4 ГБ RAM, то рекомендуется включить SWAP файл для корректной сборки всех библиотек.
﻿Создание SWAP файла на Linux﻿﻿
2. Получение прав root и создание локальной базы данных пакетов
Shell
su
cd ~
apt-get update
su
cd ~
apt-get update
﻿
Измените имя сервера на "passwork".
Shell
hostnamectl set-hostname passwork
nano /etc/hosts
hostnamectl set-hostname passwork
nano /etc/hosts
﻿
Установите сервисы для автоматической настройки и обнаружения в локальной сети.
Shell
apt-get install -y avahi-daemon libnss-mdns
apt-get install -y avahi-daemon libnss-mdns
﻿
Измените значение параметра AVAHI_DAEMON_DETECT_LOCAL с 1 на 0.
Shell
nano /etc/default/avahi-daemon
nano /etc/default/avahi-daemon
﻿
Приведите содержимое файла к виду:
Shell
AVAHI_DAEMON_DETECT_LOCAL = 0
AVAHI_DAEMON_DETECT_LOCAL = 0
﻿
Перезапустите avahi-daemon:
Shell
systemctl restart avahi-daemon
systemctl restart avahi-daemon
﻿
3. Установка Git и Apache2
Shell
apt-get install -y git apache2
apt-get install -y git apache2
﻿
4. Установка MongoDB
Загрузить и добавить GPG-ключ MongoDB
Shell
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
﻿
Создайте файл — /etc/apt/sources.list.d/mongodb-org-6.0.list
Shell
echo "deb http://repo.mongodb.org/apt/debian buster/mongodb-org/6.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
echo "deb http://repo.mongodb.org/apt/debian buster/mongodb-org/6.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
﻿
Обновите локальную базу данных пакетов.
Shell
apt-get update
apt-get update
﻿
Установите последнюю стабильную версию MongoDB.
Shell
apt-get install -y mongodb-org
apt-get install -y mongodb-org
﻿
Запустите службу MongoDB.
Shell
systemctl start mongod.service
systemctl start mongod.service
﻿
Включите автозапуск службы mongod при загрузке системы.
Shell
systemctl enable mongod.service
systemctl enable mongod.service
﻿
5. Установка PHP 8.2
💡 Необходимо установить версию PHP 8.2. Более новые версии пока не поддерживаются.
Shell
apt-get install -y apt-transport-https lsb-release ca-certificates
apt-get install -y apt-transport-https lsb-release ca-certificates
﻿
Получите gpg ключ:
Shell
wget -O /etc/apt/trusted.gpg.d/php.gpg https://repos.passwork.ru/repository/php/apt/debian/apt.gpg
wget -O /etc/apt/trusted.gpg.d/php.gpg https://repos.passwork.ru/repository/php/apt/debian/apt.gpg
﻿
Добавьте новый репозиторий в список источников:
Shell
echo "deb https://repos.passwork.ru/repository/php/apt/debian/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list
echo "deb https://repos.passwork.ru/repository/php/apt/debian/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list
﻿
Установка PHP и дополнительных расширений
Shell
apt-get update
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
apt-get update
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
Shell
php -v
php -v
﻿
Если текущая основная версия PHP отличается от PHP 8.2, выберите основную версию при помощи следующих команд.
Команды
Shell
a2enmod php8.2
update-alternatives --set php /usr/bin/php8.2
update-alternatives --set phar /usr/bin/phar8.2
update-alternatives --set phar.phar /usr/bin/phar.phar8.2
update-alternatives --set phpize /usr/bin/phpize8.2
update-alternatives --set php-config /usr/bin/php-config8.2
a2enmod php8.2
update-alternatives --set php /usr/bin/php8.2
update-alternatives --set phar /usr/bin/phar8.2
update-alternatives --set phar.phar /usr/bin/phar.phar8.2
update-alternatives --set phpize /usr/bin/phpize8.2
update-alternatives --set php-config /usr/bin/php-config8.2
﻿
6. Установка PHP MongoDB драйвера
Shell
apt install php8.2-mongodb -y
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
apt install php8.2-mongodb -y
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
﻿
7. Установка PHP Phalcon расширения
Shell
apt install unzip curl -y
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
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
apt install unzip curl -y
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
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
﻿
Перезапустить веб-сервер Apache2
Shell
systemctl restart apache2.service
systemctl restart apache2.service
﻿
8. Загрузка и установка Пассворк
Клонируйте репозиторий используя ваш логин и пароль.
Shell
cd /var/www
git config --global --add safe.directory /var/www 
git init
git remote add origin https://passwork.download/passwork/passwork.git
git fetch
cd /var/www
git config --global --add safe.directory /var/www 
git init
git remote add origin https://passwork.download/passwork/passwork.git
git fetch
﻿
Shell
git checkout v6
git checkout v6
﻿
💡 Система запросит логин и пароль к репозиторию, которые вы можете найти в вашем клиентом портале Пассворка. Если у вас нет доступа к клиентскому порталу — свяжитесь с нами.
Установите права доступа на папки и файлы.
Shell
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/
﻿
Конфигурация Apache2
Откройте конфигурационный файл Apache.
Shell
nano /etc/apache2/sites-enabled/000-default.conf
nano /etc/apache2/sites-enabled/000-default.conf
﻿
Приведите содержимое файла к следующему виду:
Shell
<VirtualHost *:80>
    #ServerName .....
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/public
    <Directory /var/www/public>
        Options FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
<VirtualHost *:80>
    #ServerName .....
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/public
    <Directory /var/www/public>
        Options FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
﻿
Включите rewrite модуль и перезапустите Apache.
Shell
sudo a2enmod rewrite
systemctl restart apache2
sudo a2enmod rewrite
systemctl restart apache2
﻿
Откройте http://passwork.local или http://127.0.0.1 для доступа к вебсайту.
9. Инсталляция
При первом открытии Пассворк вы увидите диалог инсталляции, который проверит корректность настройки сервера и позволит ввести базовые параметры.
💡 Оставьте все поля в значениях по умолчанию, если вы устанавливаете новую копию Пассворк.
💡 Обратите внимание, случайно генерируемый ключ используется для шифрования базы данных.
Зарегистрируйте администратора Пассворк
Введите логин и пароль для первого пользователя. Пользователь автоматически станет администратором и владельцем организации.
10. Создание SSL сертификата
Активируйте SSL модуль Apache.
Shell
sudo a2enmod ssl
sudo a2enmod ssl
﻿
Активируйте стандартную конфигурацию SSL.
Shell
sudo a2ensite default-ssl
sudo a2ensite default-ssl
﻿
Перезапустите Apache для того, чтобы изменения вступили в силу.
Shell
systemctl restart apache2
systemctl restart apache2
﻿
Создайте новую директорию для хранения закрытого ключа и сертификата.
Shell
mkdir /etc/apache2/ssl
mkdir /etc/apache2/ssl
﻿
Создайте новый сертификат и закрытый ключ для его защиты.
Shell
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj '/CN=your.domain.name' -addext 'subjectAltName=DNS: your.domain.name' -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj '/CN=your.domain.name' -addext 'subjectAltName=DNS: your.domain.name' -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt
﻿
Вызов этой команды приведет к серии запросов.
Common Name(CN): Укажите IP-адрес вашего сервера или имя хоста. Это поле имеет значение, так как ваш сертификат должен соответствовать домену (или IP-адресу) для вашего веб-сайта.
subjectAltName(SAN): Альтернативные имена домена или IP-адрес.
Установите права доступа для защиты закрытого ключа и сертификата.
Shell
chmod 600 /etc/apache2/ssl/*
chmod 600 /etc/apache2/ssl/*
﻿
Ваш сертификат и закрытый ключ, который его защищает, готовы для использования с Apache.
11. Настройка продукта для корректной работы в Chrome с SSL
При работе через SSL-соединение (HTTPS) браузер Chrome требует наличия флагов Secure и SameSite у cookie. Без этих флагов браузер не будет принимать куки, и  вы не сможете авторизоваться в Пассворке в Chrome.
Для того чтобы установить эти флаги, включите параметр ;session.cookie_secure в файле /etc/php/8.2/apache2/php.ini вручную или командой:
Shell
sed -i '/session.cookie_secure =/c session.cookie_secure = On' /etc/php/8.2/apache2/php.ini
sed -i '/session.cookie_secure =/c session.cookie_secure = On' /etc/php/8.2/apache2/php.ini
﻿
И установите параметр disableSameSiteCookie (секция [application])в файле /var/www/app/config/config.ini в значение Off вручную или командой.
Shell
sed -i '/disableSameSiteCookie =/c disableSameSiteCookie = Off' /var/www/app/config/config.ini
sed -i '/disableSameSiteCookie =/c disableSameSiteCookie = Off' /var/www/app/config/config.ini
﻿
💡 Обратите внимание, файл `config.ini` генерируется после прохождения первоначальной настройки на странице установки.
💡 Не устанавливайте эти параметры или верните их в исходное значение, если вы передумаете использовать SSL и будете работать через HTTP-протокол.
12. Настройка Apache для использования SSL-соединения
Откройте кофигурационный файл SSL в текстовом редакторе.
Shell
nano /etc/apache2/sites-enabled/default-ssl.conf
nano /etc/apache2/sites-enabled/default-ssl.conf
﻿
Найдите раздел, начинающийся с <VirtualHost _default_:443> и внесите следующие изменения.
Добавьте строку с директивой имени сервера под строкой ServerAdmin. Это может быть ваше доменное имя или IP-адрес:
Shell
ServerAdmin webmaster@localhost
ServerName passwork.local:443
ServerAdmin webmaster@localhost
ServerName passwork.local:443
﻿
Добавьте директиву “Directory” после “ServerName”.
Shell
<Directory /var/www/public>
        Options FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>
<Directory /var/www/public>
        Options FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>
﻿
Найдите следующие две строки и обновите пути к файлам, соответствующие местоположению сертификата и ключа, которые мы создали ранее. Если вы приобрели сертификат или создали свой сертификат в другом месте, убедитесь, что путь к файлу соответствует фактическому местоположению вашего сертификата и ключа:
Shell
SSLCertificateFile /etc/apache2/ssl/apache.crt
SSLCertificateKeyFile /etc/apache2/ssl/apache.key
SSLCertificateFile /etc/apache2/ssl/apache.crt
SSLCertificateKeyFile /etc/apache2/ssl/apache.key
﻿
После внесения изменений проверьте, что ваш файл конфигурации виртуального хоста соответствует примеру ниже.
Shell
<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
        ServerAdmin webmaster@localhost
        ServerName passwork.local:443
        DocumentRoot /var/www/public
        <Directory /var/www/public>
            Options FollowSymLinks MultiViews
            AllowOverride All
            Order allow,deny
            allow from all
        </Directory>
        SSLEngine on
        SSLCertificateFile /etc/apache2/ssl/apache.crt
        SSLCertificateKeyFile /etc/apache2/ssl/apache.key
    </VirtualHost>
</IfModule>
<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
        ServerAdmin webmaster@localhost
        ServerName passwork.local:443
        DocumentRoot /var/www/public
        <Directory /var/www/public>
            Options FollowSymLinks MultiViews
            AllowOverride All
            Order allow,deny
            allow from all
        </Directory>
        SSLEngine on
        SSLCertificateFile /etc/apache2/ssl/apache.crt
        SSLCertificateKeyFile /etc/apache2/ssl/apache.key
    </VirtualHost>
</IfModule>
﻿
Перезапустите Apache, чтобы изменения вступили в силу.
Shell
systemctl restart apache2 
systemctl restart apache2 
﻿
Проверьте SSL-соединение, откройте ссылку https://passwork.local.
13. Настройка фоновых задач
Фоновые задачи — это задачи, которые выполняются по планировщику в фоновом режиме. Например, синхронизация LDAP, загрузка фавиконов и другие задачи, которые требует много времени, постоянного выполнения или распределения ресурсов.
﻿Фоновые задачи﻿﻿
14. Настройка безопасности
Перед выполнением действий по изменению и настройке параметров безопасности, настоятельно рекомендуем убедиться в стабильной и корректной работе Пассворк, а также создать резервную копию файлов, в которые вносятся изменения.
Безопасность сервера является важной частью обеспечения защиты ценных данных и ресурсов компании. Это процесс, который требует планирования и исполнения, чтобы обеспечить максимальную защиту от различных угроз.
﻿Рекомендации по изменению параметров, которые влияют на безопасность Пассворк 