# Коннектор

> Подключите свой git — self-hosted за фаерволом или облачный — не отдавая нам токены доступа.

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

_Иллюстрация: Раздел «Коннекторы»: подключённые агенты, их статус и обслуживаемые репозитории._

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

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

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

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

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

## С чего начать

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

_Иллюстрация: Код привязки действует 15 минут и используется один раз._

3. Настройте агент — через [веб-интерфейс](/docs/connector/web-setup) или
   [терминал](/docs/connector/cli-setup) — укажите провайдера, токен и репозитории,
   и вставьте код привязки.

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