Обзор
Веб-сервер
Утилиты для баз данных
Брокеры сообщений
Low-code
Менеджеры паролей и секретов

Passbolt — это менеджер паролей с открытым исходным кодом, предназначенный для безопасного хранения и обмена паролями. Он обеспечивает безопасное хранение и обмен паролями между сотрудниками, а также предлагает шифрование на клиентской стороне, двухфакторную аутентификацию и контроль доступа.

Установка и настройка

Первым шагом переходим в раздел «Приложения» в панели управления Dockhost, и в открывшемся каталоге в разделе «Менеджеры паролей и секретов» выбираем приложение Passbolt.

Раздел «Приложения» — это каталог популярных приложений, готовых к установке и использованию на платформе.

В открывшемся окне нужно выбрать необходимую вам конфигурацию приложения. К установке доступны различные конфигурации, отличающиеся выделенными для приложения ресурсами. После выбора конфигурации нажимаем «Установить» и указываем имя приложения в открывшемся модальном окне:

Нажимаем «Установить» и дожидаемся завершения процесса установки приложения:

После завершения процесса установки приложения будет установлено: само приложение Passbolt, база данных PostgreSQL и, для удобства, создан динамический домен, по которому вы сможете подключиться к приложению.

Все созданные ресурсы вы можете увидеть нажав кнопку «Управлять» справа от установленного приложения.

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

Итак, наше приложение создано и готов к использованию. Для перехода в web версию приложения нужно перейти в раздел Приложения/Установленные и нажать кнопку WEB справа от выбранного приложения.

При нажатии на кнопку web вы переходите на страницу приложения в вашем браузере, где вам необходимо пройти стандартную первичную регистрацию:

Первый запуск

Создание учетной записи

После того как Passbolt был установлен необходимо создать учетную запись администратора. Для этого необходимо перейти в раздел контейнеры и выбрать контейнер passbolt. Далее необходимо зайти в консоль контейнера и выполнить команду создания нового администратора:

/usr/share/php/passbolt/bin/cake \
  passbolt register_user \
    -u YOUR_EMAIL \
    -f YOUR_NAME \
    -l YOUR_LASTNAME \
    -r admin

Где:

  • YOUR_EMAIL - Ваш адрес электронной почты
  • YOUR_NAME - Имя пользователя
  • YOUR_LASTNAME - Фамилия пользователя

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

Далее необходимо будет завершить настройку учетной записи и выполнить вход в панель управления.

Сгенерированный PGP PRIVATE KEY необходимо надежно сохранить, в случае переноса или восстановления данных он необходим для расшифровки данных.

Настройка fingerprint

При первом запуске Passbolt создает в директории /etc/passbolt/gpg публичный и приватный ключ, который используется для защиты данных. Для полноценной работы фоновых задач, например, отправки электронных писем, необходимо настроить переменную PASSBOLT_GPG_SERVER_KEY_FINGERPRINT.

Для этого в консоли контейнера выполните следующую команду:

gpg --show-keys /etc/passbolt/gpg/serverkey.asc | grep -Ev "^(pub|sub|uid|$)" | tr -d ' '

Далее необходимо добавить новую переменную для контейнера. Для этого перейдите в раздел «Контейнеры», откройте контейнер Passbolt и нажмите на кнопку «Редактировать», после этого откроется модальное окно с настройками конфигурации контейнера.

Добавьте новую переменную PASSBOLT_GPG_SERVER_KEY_FINGERPRINT со значением, полученным в консоли. Затем нажмите кнопку «Применить» и дождитесь перезагрузки контейнера.

Обновление версии

Для обновления версии приложения перейдите в раздел «Контейнеры», откройте контейнер Passbolt и нажмите на кнопку «Редактировать», после этого откроется модальное окно с настройками конфигурации контейнера.

Далее в поле «Образ» необходимо указать нужную версию для Passbolt, далее нажмите на кнопку «Применить» и дождитесь запуска контейнера с новой версией Passbolt.

Список доступных образов и их версии можно найти в официальном реестре Passbolt на Docker Hub

Например, для смены версии с 5.5.2-1-ce-non-root на 5.6.0-1-ce-non-root необходимо указать новый образ

passbolt/passbolt:5.6.0-1-ce-non-root

Для полноценной работы фоновых задач необходимо использовать образы *-non-root.

Не рекомендуется делать понижение версии (downgrade), так как это может привести к повреждению данных.

Настройка электронной почты

Настроить SMTP сервер для отправки электронной почты можно через веб-интерфейс или через переменные окружения. Для настройки SMTP сервера через веб-интерфейс в «Панели управления Passbolt» перейдите в раздел «Настройки организации» и выберете раздел «Сервер электронной почты». Далее выберете провайдера или укажите настройки для SMTP сервера.

Так же настройки для SMTP сервера можно задать через переменные:

Переменная Значение по умолчанию Пример
EMAIL_DEFAULT_FROM From email address you@localhost
EMAIL_DEFAULT_FROM_NAME Passbolt Passbolt
EMAIL_TRANSPORT_DEFAULT_HOST Server hostname localhost
EMAIL_TRANSPORT_DEFAULT_PORT Server port 465, 587
EMAIL_TRANSPORT_DEFAULT_USERNAME Username for email server auth null
EMAIL_TRANSPORT_DEFAULT_PASSWORD Password for email server auth null
EMAIL_TRANSPORT_DEFAULT_TLS null true, false

Подробнее об описании переменных можно прочитать в Environment Variables Reference

Отправка электронных писем с порта 25 заблокирована. Используйте 465 или 587 порт для подключения к SMTP серверу.

Подключение внешнего домена

По умолчанию Passbolt устанавливается вместе с динамическим доменом. Чтобы Passbolt мог принимать запросы на вашем домене, его необходимо подключить к платформе и настроить Passbolt на работу с новым доменом.

В качестве домена может быть как домен 2-го уровня (например, example.com), так и поддомен (например, passbolt.example.com)

Добавление домена

Для подключения внешнего домена к Passbolt необходимо перейти в раздел «Сетевые сервисы / Домены» и добавить новый домен.

Дополнительную информацию про добавление домена можно найти в разделе Добавление домена

Настройка маршрута

После того как домен будет подключен к платформе, необходимо настроить маршрут. Для это перейдите в раздел «Сетевые сервисы / Маршруты» и добавьте новый маршрут, который будет вести трафик с добавленного внешнего домена на порт 8080/TCP сетевого сервиса Passbolt

Дополнительную информацию про добавление маршрута можно найти в разделе Добавление маршрута

В этой статье
Установка и настройка
Первый запуск
Обновление версии
Настройка электронной почты
Подключение внешнего домена

Мы используем файлы cookies

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