Описание

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

Пассворк CLI работает в режимах:

• exec — извлечь данные записей или ярлыков, добавить в переменное окружение и запустить указанную команду с доступом к переменным;
• get — получить значение поля из элемента или ярлыка, локально расшифровать и вывести в STDOUT;
• update — обновить поле элемента или ярлыка через CLI с учётом безопасности;
• api — предоставляет прямой доступ к API Пассворка, позволяя выполнять любые методы API и получать ответы в формате JSON.

Требования

• Python 3.11+
• requests>=2.31,<3.0
• python-dotenv>=1.0,<2.0
• cryptography>=48.0.1,<49
• pbkdf2>=1.3,<2.0
• horcrux==1.3.0

Установка

Основной способ — установить пакет pw-connector из PyPI. Исходники и ручная сборка из git — на gitVerse:

PyPI

pip install pw-connector

gitVerse (SSH)

pip install git+ssh://git@gitverse.ru:2222/passwork-ru/passwork-python.git

gitVerse (HTTPS)

pip install git+https://gitverse.ru/passwork-ru/passwork-python.git

Общие параметры

Все команды поддерживают следующие параметры:

Параметр	Переменная окружения	Описание
--host	PASSWORK_HOST	URL сервера Пассворк
--token	PASSWORK_TOKEN	Токен доступа
--refresh-token	PASSWORK_REFRESH_TOKEN	Токен обновления (необязательно)
--master-key	PASSWORK_MASTER_KEY	Мастер-ключ для расшифровки
--ssl-verify		Проверка SSL: без значения — системные сертификаты, со значением — путь к CA bundle/директории
--no-ssl-verify		Отключение проверки SSL-сертификата (устаревший вариант, рекомендуется --ssl-verify)

Версия для LLM