Примеры интеграции с API Пассворка

Коллекция готовых к использованию примеров для интеграции с Пассворком — от простого получения секретов в CI/CD-пайплайнах до полноценных программных интеграций на Python.

Что внутри

Для DevOps и CI/CD — используйте утилиту

:

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

Для разработчиков — работайте через Python-коннектор:

• Полный CRUD для объектов Пассворка
• Управление сессиями и токенами
• Работа с ярлыками, редакциями и пользовательскими полями

Важно: Репозиторий содержит только примеры использования. Исходный код CLI и коннектора находится в отдельном репозитории.

Быстрый старт

Установка Python-коннектора

Минимальная версия Python — 3.10.

Установите коннектор одним из способов:

Структура репозитория

python/

— Программные интеграции

Примеры на Python для полноценной работы с API Пассворка.

Управление хранилищами:

• create_company_vault.md
  — создание корпоративного сейфа
• create_private_vault.md
  — создание приватного сейфа
• get_vault.md
  — получение информации о сейфе

Работа с элементами (CRUD):

• create_item.md
  — создание нового пароля
• get_item.md
  — получение одного пароля
• get_items.md
  — получение списка паролей
• update_item.md
  — обновление пароля
• delete_item.md
  — удаление пароля
• search_item.md
  — поиск по паролям

Дополнительные возможности:

• create_shortcut.md
  ,
  get_shortcut.md
  ,
  search_shortcut.md
  — работа с ярлыками
• get_snapshot.md
  — получение снимка (версии пароля)
• get_inbox_item.md
  — работа с входящими
• create_user.md
  — создание пользователя
• create_link.md
  — создание ссылок
• session.md
  ,
  refresh_token.md
  — управление сессиями и токенами
• general_call.md
  — примеры прямых вызовов API
• no_ssl_verify.md
  — работа без проверки SSL-сертификата

cli/

— Готовые рецепты для CI/CD

Примеры использования утилиты

в DevOps-процессах. Скопируйте код и адаптируйте под свои задачи.

Базовые сценарии:

• single_password.md
  — получение одного секрета
• multiple_passwords.md
  — получение нескольких секретов сразу
• get.md
  — получение элементов и ярлыков, извлечение полей
• update.md
  — обновление элементов и ярлыков
• cmd_parameter.md
  — передача секретов как параметров команды

Поиск и фильтрация:

• search_by_tags.md
  — поиск паролей по тегам
• folder_search.md
  — поиск в конкретной папке
• custom_fields.md
  — работа с пользовательскими полями

Дополнительно:

• refresh_token.md
  — обновление токенов доступа
• direct_api_call.md
  — прямые вызовы API через CLI

pipelines/

— Пример реального CI/CD-пайплайна

Полноценный пример интеграции Пассворка в CI/CD-процесс.

Файл

демонстрирует:

• Миграции БД: автоматическое получение credentials для запуска миграций
• Деплой: получение API-ключей и deploy-токенов из Пассворка
• Уведомления: отправка уведомлений через прямой вызов API

Использует официальный Docker-образ

passwork-cli:latest

Полезные ссылки

Документация

• Введение в API и интеграции
• Руководство по Python-коннектору
• Руководство по CLI-утилите
• Docker-контейнер для CLI

Исходный код

• passwork-python — репозиторий с Python-коннектором и CLI

---

Лицензия

Проект распространяется под лицензией MIT. Подробности — в файле

.