Техническая документация Пассворка
Документация для системных администраторов, DevOps-инженеров и разработчиков: установка, настройка, интеграции, управление секретами и восстановление доступа.
Начало работы
Системные требования
Пассворк не требователен к ресурсам. Количество серверов зависит от числа пользователей, объёма данных и требований к отказоустойчивости.
Стандартная установка
Быстрая установка с помощью Docker (Linux) или PowerShell (Windows Server).
| Платформа | Способ | Ссылка |
|---|---|---|
| Linux | Docker | Установка на Linux |
| Windows Server | PowerShell | Установка на Windows |
Ручная установка
Для сложных случаев, когда требуется детальная настройка без Docker или PowerShell.
| Дистрибутив | Ссылка |
|---|---|
| РЕД ОС | Инструкция |
| Astra Linux | Инструкция |
| Ubuntu | Инструкция |
| Debian | Инструкция |
| Alma / Rocky / CentOS | Инструкция |
| SelectOS | Инструкция |
| Windows Server | Инструкция |
Обновление Пассворка
| Раздел | Описание |
|---|---|
| Обзор | Клиентский портал и выбор способа |
| Linux | Стандартное обновление |
| Windows Server (PowerShell) | Обновление через PowerShell-модуль |
| Docker | Обновление Docker-установки |
| Ручное обновление на Linux | Без скриптов и Docker |
| Ручное обновление на Windows | Без PowerShell-модуля |
Миграция на Пассворк 7
Переход Пассворка с 6.x версии на 7.x — описание
Администрирование
Настройка и обслуживание Пассворка после установки.
| Раздел | Описание |
|---|---|
| Расширенные настройки | PHP, веб-сервер, заголовки, ГОСТ |
| Десктопное приложение | Установка, обновление, офлайн-доступ |
| В случае ошибок | Диагностика и решение проблем |
| Фоновые задачи | Настройка cron и scheduled tasks |
| Почтовые уведомления | SMTP и Postfix |
| LDAP | Интеграция с Active Directory |
| SSO | SAML, Azure AD, Keycloak, Google |
| Мобильные приложения | iOS и Android |
| Журнал событий | Аудит, syslog и Event Viewer |
| Обновление MongoDB | Обновление СУБД по ОС |
| Обновление PHP | Обновление PHP по ОС |
API и интеграции
Программный доступ к Пассворку для автоматизации и интеграций.
| Инструмент | Назначение | Ссылка |
|---|---|---|
| HTTP API | Прямые запросы к серверу | Документация |
| API схема | Интерактивный просмотр OpenAPI | Пассворк API |
| Ротация API-токенов | Продление access/refresh | Эндпоинты |
| Python SDK | Библиотека для Python | Python-коннектор |
| CLI-утилита | Консольный инструмент | passwork-cli |
| Docker CLI | Образ для CI/CD | Docker-контейнер |
| Health-check | Мониторинг состояния | Эндпоинт |
| Примеры интеграций | Готовые сценарии Python SDK и CLI | Репозиторий |
| Импорт из Bitwarden | Перенос vault через Python-коннектор | Инструкция |
Управление секретами
Использование Пассворка как менеджера секретов для CI/CD и инфраструктуры.
| Раздел | Описание |
|---|---|
| Введение | Пассворк как менеджер секретов |
| Основные концепции | Структура и организация секретов |
| CLI для секретов | Получение и обновление через CLI |
| Python SDK | Автоматизация на Python |
| Ротация секретов | Практика регулярной смены паролей |
| Интеграции с CI/CD | GitLab CI, GitHub Actions, Kubernetes |
| Zero-Knowledge | Как ZK влияет на автоматизацию и ротацию |
| Примеры и шаблоны | CLI, Python, CI/CD |
| FAQ | Практики и типичные ошибки |
Восстановление
Пороговое восстановление доступа к сейфам по схеме Шамира (M из N): если администратор типа сейфа недоступен, кворум держателей долей может выдать права другому пользователю без единой точки отказа.
| Раздел | Описание |
|---|---|
| Введение | Зачем нужно и как устроено |
| Политики доступа к сейфам | Механизм, на котором строится восстановление |
| Основные концепции | Роли, доли, RSA-ключи |
| Настройка сервисного аккаунта | Создание и раздача долей (Расширенная редакция) |
| Упрощённый вариант | Ручная схема для любой редакции |
| Покрытие сейфов | Привязка аккаунта восстановл ения к политикам |
| Восстановление при инциденте | Церемония выдачи доступа |
| Аудит | Журнал церемонии и коды CLI |
| Модель безопасности | Угрозы, ограничения, рекомендации |
| Практические рекомендации | Профили M из N для разных организаций |
| Примеры | Рецепты CLI и Python SDK |
| FAQ | Частые вопросы |
Безопасность
| Раздел | Описание |
|---|---|
| Обзор криптографии | Zero-Knowledge и End-to-End шифрование |
| Глоссарий | Определения терминов |
| Модель данных | Сейфы, записи, поля и ключи |
| Область шифрования | Что шифруется на клиенте и на сервере |
| Иерархия ключей | Схема криптографических ключей |
| Криптографические алгоритмы | PBKDF2, AES, RSA |
| Аутентификация | Мастер-пароль и мастер-ключ |
| Локальное хранилище | «Запомнить мастер-пароль» в браузере |
| Обмен записями | Внутренний шэринг и внешние ссылки |
| Серверное шифрование | Защита данных на сервере |
| Токены сессий | Access/Refresh, CSRF, cookies |
Базы данных
MongoDB — рекомендуемая СУБД с полной поддержкой. PostgreSQL и совместимые СУБД доступны с Пассворк 7, техническая поддержка таких баз со стороны Пассворка не предоставляется.
| Раздел | Описание |
|---|---|
| MongoDB | Поддерживаемые версии 7 и 8 |
| Бэкапы MongoDB | Создание и восстановление |
| Авторизация MongoDB | Docker, Linux, Windows |
| PostgreSQL | Поддержка |
| Миграция MongoDB → PostgreSQL | Linux, Docker, Windows |
Отказоустойчивость
Высокая доступность Пассворка: несколько серверов приложений и репликация базы данных.
| Раздел | Описание |
|---|---|
| Обзор | Принципы HA и лицензирование |
| Серверы приложений | Балансировка и горизонтальное масштабирование |
| Репликация БД | Отказоустойчивость базы данных |
Поддержка
| Раздел | Описание |
|---|---|
| Приоритетная поддержка | SLA, сроки реакции, каналы |
| Гарантийная поддержка | Условия и ограничения |
| Запросы возможностей | Как подать фичреквест |
| Центр поддержки | passwork.ru/help |
| Руководство пользователя | Работа в интерфейсе Пассворка |