Коннектор

Коннектор — небольшой агент, который вы запускаете на своей машине, в своей сети. Он делает две вещи:

• git-мост — переносит репозитории, недоступные из интернета, к нам и возвращает обратно pull request'ы;
• хост интеграций — запускает плагины из нашего каталога: трекеры задач и базы знаний, а в будущем и другие ваши системы.

Что он собой представляет

Ядро коннектора — только git-мост. Оно намеренно маленькое: его можно прочитать целиком перед тем, как впустить в свою сеть, и оно не растёт от каждой новой интеграции. Всё остальное — плагины: подписанные комплекты, которые коннектор скачивает из каталога, проверяет по подписи и запускает отдельными процессами под отдельными пользователями ОС.

      ваша сеть                                 │        наша сторона
                                                │
 ваш git ◀──локально──┐                         │
                      │                         │
 ваш трекер ◀─локально┤   КОННЕКТОР             │
                      ├── ядро: git-мост   ─────┼──исходящее──▶ платформа Buff
 (Jira, GitLab, …)    └── плагин ──┐            │
                          плагин ──┴─ свои uid, │
                                     свои адреса│

Три свойства этой картинки держат всё остальное:

1. Только исходящие соединения. Коннектор звонит наружу сам; к вам в сеть ничего не подключается. Открывать порт наружу не требуется — даже для событий трекера (опрос работает всегда).
2. Секреты не пересекают периметр. Токен git, токен трекера и ключ самого агента лежат на вашей машине. Плагин их тоже не видит: исходящий запрос собирает коннектор и подставляет туда учётные данные сам — как именно.
3. Границы объявлены заранее. Куда плагину разрешено ходить и какие инструменты он отдаёт модели, видно до установки, в каталоге, и потом — в приложении.

Что уходит наружу, а что нет

Ничего из этого не собирается «на всякий случай»: события трекера читаются только в отмеченных проектах и только при прямом обращении к боту, а отчёт о состоянии — это ровно то, что видно в приложении в разделе «Коннекторы».

С чего начать

1. Скачайте и установите агент на машину, у которой есть доступ к вашему git и исходящий доступ в интернет.
2. В приложении Buff откройте «Коннекторы» → «Добавить коннектор» и получите одноразовый код привязки.

3. Настройте агент — через локальную страницу или терминал: провайдер git, токен, репозитории и код привязки.
4. Нужен трекер — поставьте интеграцию из каталога и создайте подключение. Как это работает со стороны команды — в разделе «Интеграции с трекерами».

Добавить репозиторий, сменить токен или поправить подключение можно потом без перезапуска — изменения применяются на лету.

Разделы