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

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

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

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

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

В окне

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

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

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

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

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

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

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

Устройства

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

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

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

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

Подтверждение и отклонение входа, отзыв устройства и отклонённое обновление токена записываются в журнал аудита организации — с адресом и браузером того, кто подтверждал. Сам факт, что консоль запросила код и ждала ответа, событием не считается. Полный список — на странице Журнал аудита и Buff Code.

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

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