halfoff.devДокументация
Получить ключ
Аккаунт

Безопасность аккаунта

Защитите панель Half Off Dev двухфакторным входом, резервными кодами и управлением сессиями и узнайте, какие данные хранятся.

Ваш аккаунт защищают две вещи. Электронная почта и пароль открывают панель, где находятся баланс, ключи и логи. API-ключи позволяют коду тратить этот баланс. Эта страница посвящена первому и подсказывает, как защитить второе. Если не указано иное, все настройки ниже находятся в Настройках.

Двухфакторная аутентификация#

При включённой двухфакторной аутентификации (2FA) при входе дополнительно запрашивается 6-значный код из приложения-аутентификатора. Подойдёт любое приложение, генерирующее коды по времени (TOTP): Google Authenticator, 1Password, Authy и другие.

  1. Начните настройку

    В разделе Two-factor authentication в Настройках нажмите Set up two-factor.

  2. Добавьте Half Off Dev в аутентификатор

    Отсканируйте QR-код или введите в приложении ключ настройки, напечатанный рядом с ним.

  3. Подтвердите, что всё работает

    Введите 6-значный код из приложения и нажмите Verify & enable. Статус сменится на On.

  4. Сохраните резервные коды

    Вы получите десять одноразовых резервных кодов вида k7mq-2xpd. Каждым можно один раз заменить код аутентификатора. Повторно они не показываются: нажмите Copy codes, сохраните их в менеджере паролей, затем нажмите I saved them.

После этого для входа понадобятся email, пароль и свежий код.

Без кодов вы потеряете доступ

Если вы потеряли аутентификатор, а резервных кодов не осталось, войти в панель не получится. Храните коды не на том телефоне, где установлено приложение.

Коды всё время не подходят? Убедитесь, что на телефоне включена автоматическая настройка времени. Код принимается примерно за 30 секунд до своего окна и через 30 секунд после него.

Вход с резервным кодом#

Если телефон потерян, а запрос кода уже появился, введите вместо него резервный код. Регистр и дефис не важны. Каждый код действует один раз, а в Настройках показано, сколько неиспользованных осталось.

Замена резервных кодов#

Рядом с Generate new codes введите действующий код аутентификатора. Десять новых кодов заменят старый набор, и тот сразу перестанет работать. Делайте это, когда коды заканчиваются или если вы подозреваете, что их кто-то увидел.

Отключение двухфакторной аутентификации#

Рядом с Turn off two-factor введите код аутентификатора или резервный код и нажмите Turn off. Ключ настройки и резервные коды будут удалены. Если вы снова включите 2FA, вы получите новый QR-код, поэтому удалите старую запись из приложения.

Что она защищает, а что нет#

2FA защищает вход в панель, а с ним баланс, оплату, ключи и логи. API-запросы второй фактор никогда не запрашивают: ключ работает сам по себе. Относитесь к каждому ключу так же бережно, как к паролю.

Подтверждение адреса электронной почты#

Если в панели появилось напоминание подтвердить email, откройте ссылку, которую мы отправили при регистрации. Она работает один раз и действует 48 часов; кнопка Send the link again в напоминании выдаст новую. Подтверждённый адрес мы используем, чтобы сообщать вам об изменениях в аккаунте.

Смена пароля#

В разделе Change password введите текущий пароль и новый длиной не менее 8 символов, затем нажмите Update password. Все остальные браузеры, где вы вошли в аккаунт, будут отключены. Браузер, которым вы пользуетесь, остаётся в системе.

Сессии#

Вход в браузере действует 30 дней. Sign out внизу боковой панели завершает его в этом браузере.

Карточка Sessions в Настройках показывает число других браузеров и устройств, где выполнен вход в ваш аккаунт. Sign out other sessions завершает их все, оставляя вас в системе там, где вы сейчас. Используйте это после работы на чужом компьютере или при малейшем подозрении, что доступ есть у кого-то ещё.

Как сберечь API-ключи#

  • Выпускайте по одному ключу на приложение и окружение, только с теми лимитами и моделями, которые нужны. См. API-ключи.
  • Загружайте ключи из переменных окружения или менеджера секретов. Не коммитьте их и не встраивайте в клиентский код.
  • Меняйте ключи по расписанию и отзывайте сразу, если ключ мог утечь; отзыв действует со следующего запроса.
  • Просматривайте Логи в поисках незнакомого трафика. Для каждого запроса указано, каким ключом он отправлен.

Подробнее — в разделе Аутентификация.

Что хранит Half Off Dev#

ДанныеКак хранятся
API-ключиХеш и первые несколько символов для отображения. Полный ключ показывается один раз при создании и не восстанавливается.
ПарольХеш с солью и намеренно медленным алгоритмом (PBKDF2-SHA256). Сам пароль не сохраняется.
Сессии панелиСлучайный токен в защищённой HTTP-only cookie. Сервер хранит только его хеш.
Секрет двухфакторной аутентификацииХранится, чтобы можно было проверять ваши коды. Удаляется при отключении 2FA.
Резервные кодыХеш каждого неиспользованного кода. Использованные коды удаляются.
Логи запросовТолько метаданные: модель, ключ, число токенов, списанная сумма, время и статус. Промпты и ответы не сохраняются. Хранятся 90 дней.

Язык#

Выберите язык в разделе Language в Настройках или в переключателе языка в боковой панели либо в шапке документации. Выбор распространяется на панель и документацию в этом браузере. Пока вы не выбрали язык, Half Off Dev использует язык вашего браузера.