# Вход и рабочий контекст

> Первый запуск Buff Code: адрес коннектора, код входа и подтверждение в кабинете; выбор организации, проекта и пространств; память по папкам; отзыв устройств.

Отдельных команд настройки нет: всё, что нужно, Buff Code спрашивает при первом запуске, а
поменять можно прямо в работе.

## Первый запуск

1. Запустите `buff` в папке проекта (или откройте приложение). Buff Code попросит **адрес
   коннектора вашей компании** — его даёт администратор; он же виден в кабинете, в карточке
   коннектора, строкой «Вход для Buff Code». Если администратор раздал адрес заранее
   переменной `BUFF_CONNECTOR_URL`, этот шаг пропускается.
2. Buff Code покажет **код входа** из восьми символов и откроет в браузере страницу входа в
   кабинете. Если вы ещё не вошли в кабинет, сначала войдите как обычно. Сверьте код с тем,
   что показывает Buff Code, выберите организацию и нажмите **«Разрешить вход»**. Код живёт
   десять минут.
3. Выберите **организацию**, **проект** (или «Без проекта — только организация») и, если
   нужно, **пространства знаний**. Это рабочий контекст: по нему берутся модели, знания и
   инструменты, и по нему же списывается расход. Если организация одна, она выбирается без вопроса.

Всё. Дальше Buff Code работает, а в строке состояния виден контекст: «организация › проект · N пр.».

### В окне

- При первом запуске окно сначала проводит короткое знакомство (см. [Настройки и первый
  запуск](/docs/buff-code/work/settings#первый-запуск)), а в конце предлагает «Войти в Buff».
- **«Подключить Buff»** — поле адреса коннектора, подсказка, где его взять, и «Позже». Адрес
  запоминается: при следующем входе (например, после «Отключить») он уже подставлен.
- Пока код ждёт подтверждения, окно показывает, сколько он ещё действует, «Открыть кабинет» и
  «Отмена»; истёкший код — «Получить новый код».
- Если вы ещё не состоите ни в одной организации Buff, окно так и скажет: попросите администратора
  добавить вас и выберите снова.
- Вход виден в **«Настройки → Провайдеры»**: строка «Buff · Вход через коннектор · ваш логин ·
  организация» и «Отключить»; пока контекст не выбран, рядом — «Выбрать организацию и проект».

_Иллюстрация: Вход в окне: адрес коннектора компании — и код подтверждения в кабинете._

_Иллюстрация: Страница входа в кабинете: код с экрана Buff Code, выбор организации и ваши устройства._

Из консоли в одну команду (`buff run "…"`, `buff models`) недостающее спрашивается там же,
на месте — но только в настоящем терминале. В скрипте без терминала Buff Code откажет:
«Buff Code не настроен: запустите buff — вход и выбор организации там». Сделайте вход один
раз интерактивно, дальше скрипты работают.

## Контекст запоминается по папкам

Выбор организации и проекта хранится **для каждой папки**, из которой запущен Buff Code. В
другой папке Buff Code спросит заново — так в разных папках можно работать с разными
организациями и проектами. Вход при этом один на машину.

## Сменить организацию, проект, пространство

Внутри Buff Code — команды через `/`:

| Команда | Что делает |
| --- | --- |
| `/org` | сменить организацию |
| `/project` | сменить проект или выбрать «Без проекта» |
| `/space` | выбрать пространства знаний |
| `/models` | посмотреть модели организации |

В приложении то же самое — по нажатию на «Контекст Buff». Смена действует со следующего
сообщения. Выбор сверяется со свежим списком того, что вам доступно: если проект отобрали,
Buff Code скажет «Этого нет среди доступного вам» и предложит выбрать заново.

## Устройства

Каждый вход — отдельное **устройство** под именем машины. Что происходит на машине при входе:

- создаётся ключ устройства; им подписывается каждое обновление входа, поэтому украденный
  токен без ключа устройства бесполезен;
- токен доступа живёт 15 минут и обновляется сам; обновление живёт 90 дней — раз в три месяца
  Buff Code попросит войти заново.

Список ваших устройств — на странице входа в кабинете: когда входили и когда были на связи.
Там же устройство можно **отозвать**. Отозванное устройство теряет доступ к моделям сразу, к
инструментам коннектора — не позже чем через минуту. В Buff Code на этой машине появится
«Вход повреждён — войдите заново».

## Что попадает в журнал аудита

Подтверждение и отклонение входа, отзыв устройства и отклонённое обновление токена
записываются в [журнал аудита](/docs/audit-log) организации — с адресом и браузером того, кто
подтверждал. Сам факт, что консоль запросила код и ждала ответа, событием не считается. Полный
список — на странице [Журнал аудита и Buff Code](/docs/buff-code/sessions/audit).

## Защита от подбора

Код входа состоит из восьми символов и живёт десять минут. После пяти неверных кодов за десять
минут страница входа блокируется на десять минут: «Слишком много неверных кодов. Подождите».