Техническая документация Пассворка

Документация для системных администраторов, 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)
• Обновление Docker-установки
• Ручное обновление на Windows

Администрирование

Настройка и обслуживание Пассворка после установки.

Раздел	Описание
В случае ошибок	Диагностика и решение проблем
Фоновые задачи	Настройка cron и scheduled tasks
Почтовые уведомления	SMTP и Postfix
LDAP	Интеграция с Active Directory
SSO	SAML, Azure AD, Keycloak, Google
Мобильные приложения	iOS и Android
Журнал событий	Аудит и логирование

API и интеграции

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

Инструмент	Назначение	Ссылка
HTTP API	Прямые запросы к серверу	Документация
API схема	Интерактивный просмотр OpenAPI	Пассворк API
Ротация API-токенов	Продление access/refresh	Эндпоинты
Python SDK	Библиотека для Python	Python-коннектор
CLI-утилита	Консольный инструмент	passwork-cli
Docker CLI	Образ для CI/CD	Docker-контейнер
Health-check	Мониторинг состояния	Эндпоинт

Управление секретами

Использование Пассворка как менеджера секретов для CI/CD и инфраструктуры.

Раздел	Описание
Введение	Пассворк как менеджер секретов
Основные концепции	Структура и организация секретов
CLI для секретов	Получение и обновление через CLI
Python SDK	Автоматизация на Python
Ротация секретов	Практика регулярной смены паролей
Интеграции с CI/CD	GitLab CI, GitHub Actions, Kubernetes

Восстановление

Пороговое восстановление доступа к сейфам по схеме Шамира (M из N): если администратор типа сейфа недоступен, кворум держателей долей может выдать права другому пользователю без единой точки отказа.

Раздел	Описание
Введение	Зачем нужно и как устроено
Политики доступа к сейфам	Механизм, на котором строится восстановление
Основные концепции	Роли, доли, RSA-ключи
Настройка сервисного аккаунта	Создание и раздача долей (Расширенная редакция)
Упрощённый вариант	Ручная схема для любой редакции
Восстановление при инциденте	Церемония выдачи доступа
Модель безопасности	Угрозы, ограничения, рекомендации
FAQ	Частые вопросы

Безопасность

Раздел	Описание
Обзор криптографии	Zero-Knowledge и End-to-End шифрование
Глоссарий	Определения терминов
Иерархия ключей	Схема криптографических ключей
Криптографические алгоритмы	PBKDF2, AES, RSA
Серверное шифрование	Защита данных на сервере

Версия для LLM