Коннектор

Коннектор — это небольшой агент, который вы запускаете в своей сети. Он связывает ваш git-сервер с платформой, когда прямой доступ невозможен или нежелателен.

Зачем он нужен

• Git за фаерволом. Ваш GitLab / GitHub Enterprise / Gitea / Bitbucket Server стоит во внутренней сети и недоступен из интернета. Коннектор дотягивается до него изнутри и переносит репозитории к нам — и обратно (pull request'ы).
• Приватность токенов. Даже для облачного git (github.com, gitlab.com, bitbucket.org) вы можете не отдавать нам токены доступа. Запустите коннектор — токен останется у вас.

Как это устроено (в двух словах)

ваш git ◀──локально──▶ КОННЕКТОР ──исходящее──▶ платформа Buff
(в вашей сети)          (агент у вас)            (реле)

• Коннектор только звонит наружу — к вам в сеть ничего не подключается.
• Он трогает ваш git только по задаче (импортировать репозиторий, опубликовать pull request). Сам по себе он ничего не делает.
• Токен доступа к вашему git остаётся в агенте, в вашей сети. К нам он не попадает никогда. Мы видим только список репозиториев, которые вы разрешили, и статус «есть доступ / нет».

С чего начать

1. Установите агент на машину в вашей сети (бинарь или Docker).
2. В приложении Buff откройте «Коннекторы» → «Добавить коннектор» и получите одноразовый код привязки.

3. Настройте агент — через веб-интерфейс или терминал — укажите провайдера, токен и репозитории, и вставьте код привязки.

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